event_camera_py package from event_camera_py repo

event_camera_py

Package Summary

Tags No category tags.
Version 1.0.0
License Apache License 2.0
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/ros-event-camera/event_camera_py.git
VCS Type git
VCS Version master
Last Updated 2023-11-24
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Python access for event_camera_msgs.

Additional Links

No additional links.

Maintainers

  • Bernd Pfrommer

Authors

  • Bernd Pfrommer

event_camera_py

This repository holds ROS/ROS2 tools for processing event_camera_msgs under ROS and ROS2 with python. These messages are produced by the metavision_ros_driver. For decoding, the event_camera_codecs package is used.

With this repository you can quickly load events from a ROS/ROS2 bag into your python code. The decoder will return a structured numpy array of the same format that the Metavision SDK uses:

dtype={'names':['x','y','p','t'], 'formats':['<u2','<u2','i1','<i4'], 'offsets':[0,2,4,8], 'itemsize':12})]

To access e.g. the timestamps (in microseconds) you would use foo['t'], where foo is the numpy array returned by the decoder. See sample code below.

Supported platforms

Currently tested on:

  • Ubuntu 20.04: ROS Noetic and ROS2 Galactic
  • Ubuntu 22.04: ROS2 Humble and ROS2 Rolling

How to build

Create a workspace, clone this repo, and use vcs to pull in the remaining dependencies:

pkg=event_camera_py
mkdir -p ~/${pkg}_ws/src
cd ~/${pkg}_ws
git clone https://github.com/ros-event-camera/${pkg}.git src/${pkg}
cd src
vcs import < ${pkg}/${pkg}.repos
cd ..

Install system dependencies

You will probably be missing the pybind11_catkin package:

sudo apt-get install ros-${ROS_DISTRO}-pybind11-catkin

configure and build on ROS1:

catkin config -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)
catkin build

configure and build on ROS2:

cd ~/${pkg}_ws
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)

Decoding event array messages

The following sample code shows how to decode event array messages under ROS1.

import rosbag
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = rosbag.Bag('foo.bag')
decoder = Decoder()

for topic, msg, t in bag.read_messages(topics=topic):
    decoder.decode_bytes(msg.encoding, msg.width, msg.height,
                         msg.time_base, msg.events)
    cd_events = decoder.get_cd_events()
    print(cd_events)
    trig_events = decoder.get_ext_trig_events()
    print(trig_events)

Here is a sample code for ROS2. It uses a helper class "BagReader" that you can find in the src folder. Note the conversion to numpy array:

from bag_reader_ros2 import BagReader
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = BagReader('foo', topic)
decoder = Decoder()

while bag.has_next():
        topic, msg, t_rec = bag.read_next()
        decoder.decode(msg)
        cd_events = decoder.get_cd_events()
        print(cd_events)
        trig_events = decoder.get_ext_trig_events()
        print(trig_events)

The returned event arrays are structured numpy ndarrays that are compatible with Prophesee's Metavision SDK.

About timestamps

A message in a recorded rosbag has three sources of time information:

1) The recording timestamp. This is when the message was written into the bag by the rosbag recorder. It is the least precise of all time stamps and therefore usually not used. 2) The message time stamp in the header (header.stamp). This is the time when the ROS driver host received the first event packet from the SDK for that ROS message. Remember that a ROS message can contain multiple SDK packets, but the header.stamp refers to the first SDK packet received. 3) The sensor time encoded in the packets. This time stamp depends on the encoding. For standard 'evt3' encoding the raw packet needs to be decoded to obtain the sensor time. The encoded sensor time has two quirks: it wraps around every 2^24 usec (16.77 sec) and it has bit noise errors. The decoder used by the event_camera_py packet keeps track of the wrap around and tries to correct the bit errors. But if you start decoding from the middle of the event stream your sensor time stamps will start at somewhere between 0 and 16.77s due to the wrap around, i.e. sensor time depends on where you start decoding in the message stream.

The time 't' column in the python array returned by get_cd_events() is the sensor time 3), in micro seconds. The host time can be obtained by suitably combining the sensor time 3) with the ROS header stamp 2). The most naive way is to compute the time difference between sensor time and header stamp for the first packet and subsequently use that difference to obtain host time from sensor time. Obviously this will not account for drift between sensor and host clocks.

License

This software is issued under the Apache License Version 2.0.

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged event_camera_py at answers.ros.org

event_camera_py package from event_camera_py repo

event_camera_py

Package Summary

Tags No category tags.
Version 1.0.0
License Apache License 2.0
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/ros-event-camera/event_camera_py.git
VCS Type git
VCS Version master
Last Updated 2023-11-24
Dev Status DEVELOPED
CI status No Continuous Integration
Released UNRELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Python access for event_camera_msgs.

Additional Links

No additional links.

Maintainers

  • Bernd Pfrommer

Authors

  • Bernd Pfrommer

event_camera_py

This repository holds ROS/ROS2 tools for processing event_camera_msgs under ROS and ROS2 with python. These messages are produced by the metavision_ros_driver. For decoding, the event_camera_codecs package is used.

With this repository you can quickly load events from a ROS/ROS2 bag into your python code. The decoder will return a structured numpy array of the same format that the Metavision SDK uses:

dtype={'names':['x','y','p','t'], 'formats':['<u2','<u2','i1','<i4'], 'offsets':[0,2,4,8], 'itemsize':12})]

To access e.g. the timestamps (in microseconds) you would use foo['t'], where foo is the numpy array returned by the decoder. See sample code below.

Supported platforms

Currently tested on:

  • Ubuntu 20.04: ROS Noetic and ROS2 Galactic
  • Ubuntu 22.04: ROS2 Humble and ROS2 Rolling

How to build

Create a workspace, clone this repo, and use vcs to pull in the remaining dependencies:

pkg=event_camera_py
mkdir -p ~/${pkg}_ws/src
cd ~/${pkg}_ws
git clone https://github.com/ros-event-camera/${pkg}.git src/${pkg}
cd src
vcs import < ${pkg}/${pkg}.repos
cd ..

Install system dependencies

You will probably be missing the pybind11_catkin package:

sudo apt-get install ros-${ROS_DISTRO}-pybind11-catkin

configure and build on ROS1:

catkin config -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)
catkin build

configure and build on ROS2:

cd ~/${pkg}_ws
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)

Decoding event array messages

The following sample code shows how to decode event array messages under ROS1.

import rosbag
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = rosbag.Bag('foo.bag')
decoder = Decoder()

for topic, msg, t in bag.read_messages(topics=topic):
    decoder.decode_bytes(msg.encoding, msg.width, msg.height,
                         msg.time_base, msg.events)
    cd_events = decoder.get_cd_events()
    print(cd_events)
    trig_events = decoder.get_ext_trig_events()
    print(trig_events)

Here is a sample code for ROS2. It uses a helper class "BagReader" that you can find in the src folder. Note the conversion to numpy array:

from bag_reader_ros2 import BagReader
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = BagReader('foo', topic)
decoder = Decoder()

while bag.has_next():
        topic, msg, t_rec = bag.read_next()
        decoder.decode(msg)
        cd_events = decoder.get_cd_events()
        print(cd_events)
        trig_events = decoder.get_ext_trig_events()
        print(trig_events)

The returned event arrays are structured numpy ndarrays that are compatible with Prophesee's Metavision SDK.

About timestamps

A message in a recorded rosbag has three sources of time information:

1) The recording timestamp. This is when the message was written into the bag by the rosbag recorder. It is the least precise of all time stamps and therefore usually not used. 2) The message time stamp in the header (header.stamp). This is the time when the ROS driver host received the first event packet from the SDK for that ROS message. Remember that a ROS message can contain multiple SDK packets, but the header.stamp refers to the first SDK packet received. 3) The sensor time encoded in the packets. This time stamp depends on the encoding. For standard 'evt3' encoding the raw packet needs to be decoded to obtain the sensor time. The encoded sensor time has two quirks: it wraps around every 2^24 usec (16.77 sec) and it has bit noise errors. The decoder used by the event_camera_py packet keeps track of the wrap around and tries to correct the bit errors. But if you start decoding from the middle of the event stream your sensor time stamps will start at somewhere between 0 and 16.77s due to the wrap around, i.e. sensor time depends on where you start decoding in the message stream.

The time 't' column in the python array returned by get_cd_events() is the sensor time 3), in micro seconds. The host time can be obtained by suitably combining the sensor time 3) with the ROS header stamp 2). The most naive way is to compute the time difference between sensor time and header stamp for the first packet and subsequently use that difference to obtain host time from sensor time. Obviously this will not account for drift between sensor and host clocks.

License

This software is issued under the Apache License Version 2.0.

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged event_camera_py at answers.ros.org

event_camera_py package from event_camera_py repo

event_camera_py

Package Summary

Tags No category tags.
Version 1.0.0
License Apache License 2.0
Build type CATKIN
Use RECOMMENDED

Repository Summary

Checkout URI https://github.com/ros-event-camera/event_camera_py.git
VCS Type git
VCS Version master
Last Updated 2023-11-24
Dev Status DEVELOPED
CI status No Continuous Integration
Released RELEASED
Tags No category tags.
Contributing Help Wanted (0)
Good First Issues (0)
Pull Requests to Review (0)

Package Description

Python access for event_camera_msgs.

Additional Links

No additional links.

Maintainers

  • Bernd Pfrommer

Authors

  • Bernd Pfrommer

event_camera_py

This repository holds ROS/ROS2 tools for processing event_camera_msgs under ROS and ROS2 with python. These messages are produced by the metavision_ros_driver. For decoding, the event_camera_codecs package is used.

With this repository you can quickly load events from a ROS/ROS2 bag into your python code. The decoder will return a structured numpy array of the same format that the Metavision SDK uses:

dtype={'names':['x','y','p','t'], 'formats':['<u2','<u2','i1','<i4'], 'offsets':[0,2,4,8], 'itemsize':12})]

To access e.g. the timestamps (in microseconds) you would use foo['t'], where foo is the numpy array returned by the decoder. See sample code below.

Supported platforms

Currently tested on:

  • Ubuntu 20.04: ROS Noetic and ROS2 Galactic
  • Ubuntu 22.04: ROS2 Humble and ROS2 Rolling

How to build

Create a workspace, clone this repo, and use vcs to pull in the remaining dependencies:

pkg=event_camera_py
mkdir -p ~/${pkg}_ws/src
cd ~/${pkg}_ws
git clone https://github.com/ros-event-camera/${pkg}.git src/${pkg}
cd src
vcs import < ${pkg}/${pkg}.repos
cd ..

Install system dependencies

You will probably be missing the pybind11_catkin package:

sudo apt-get install ros-${ROS_DISTRO}-pybind11-catkin

configure and build on ROS1:

catkin config -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)
catkin build

configure and build on ROS2:

cd ~/${pkg}_ws
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=RelWithDebInfo  # (optionally add -DCMAKE_EXPORT_COMPILE_COMMANDS=1)

Decoding event array messages

The following sample code shows how to decode event array messages under ROS1.

import rosbag
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = rosbag.Bag('foo.bag')
decoder = Decoder()

for topic, msg, t in bag.read_messages(topics=topic):
    decoder.decode_bytes(msg.encoding, msg.width, msg.height,
                         msg.time_base, msg.events)
    cd_events = decoder.get_cd_events()
    print(cd_events)
    trig_events = decoder.get_ext_trig_events()
    print(trig_events)

Here is a sample code for ROS2. It uses a helper class "BagReader" that you can find in the src folder. Note the conversion to numpy array:

from bag_reader_ros2 import BagReader
from event_camera_py import Decoder

topic = '/event_camera/events'
bag = BagReader('foo', topic)
decoder = Decoder()

while bag.has_next():
        topic, msg, t_rec = bag.read_next()
        decoder.decode(msg)
        cd_events = decoder.get_cd_events()
        print(cd_events)
        trig_events = decoder.get_ext_trig_events()
        print(trig_events)

The returned event arrays are structured numpy ndarrays that are compatible with Prophesee's Metavision SDK.

About timestamps

A message in a recorded rosbag has three sources of time information:

1) The recording timestamp. This is when the message was written into the bag by the rosbag recorder. It is the least precise of all time stamps and therefore usually not used. 2) The message time stamp in the header (header.stamp). This is the time when the ROS driver host received the first event packet from the SDK for that ROS message. Remember that a ROS message can contain multiple SDK packets, but the header.stamp refers to the first SDK packet received. 3) The sensor time encoded in the packets. This time stamp depends on the encoding. For standard 'evt3' encoding the raw packet needs to be decoded to obtain the sensor time. The encoded sensor time has two quirks: it wraps around every 2^24 usec (16.77 sec) and it has bit noise errors. The decoder used by the event_camera_py packet keeps track of the wrap around and tries to correct the bit errors. But if you start decoding from the middle of the event stream your sensor time stamps will start at somewhere between 0 and 16.77s due to the wrap around, i.e. sensor time depends on where you start decoding in the message stream.

The time 't' column in the python array returned by get_cd_events() is the sensor time 3), in micro seconds. The host time can be obtained by suitably combining the sensor time 3) with the ROS header stamp 2). The most naive way is to compute the time difference between sensor time and header stamp for the first packet and subsequently use that difference to obtain host time from sensor time. Obviously this will not account for drift between sensor and host clocks.

License

This software is issued under the Apache License Version 2.0.

CHANGELOG
No CHANGELOG found.

Wiki Tutorials

See ROS Wiki Tutorials for more details.

Source Tutorials

Not currently indexed.

Launch files

No launch files found

Messages

No message files found.

Services

No service files found

Plugins

No plugins found.

Recent questions tagged event_camera_py at answers.ros.org

No version for distro noetic. Known supported distros are highlighted in the buttons above.
No version for distro ardent. Known supported distros are highlighted in the buttons above.
No version for distro bouncy. Known supported distros are highlighted in the buttons above.
No version for distro crystal. Known supported distros are highlighted in the buttons above.
No version for distro eloquent. Known supported distros are highlighted in the buttons above.
No version for distro dashing. Known supported distros are highlighted in the buttons above.
No version for distro galactic. Known supported distros are highlighted in the buttons above.
No version for distro foxy. Known supported distros are highlighted in the buttons above.
No version for distro lunar. Known supported distros are highlighted in the buttons above.
No version for distro jade. Known supported distros are highlighted in the buttons above.
No version for distro indigo. Known supported distros are highlighted in the buttons above.
No version for distro hydro. Known supported distros are highlighted in the buttons above.
No version for distro kinetic. Known supported distros are highlighted in the buttons above.
No version for distro melodic. Known supported distros are highlighted in the buttons above.