Osef file/stream tools.
Project description
OSEF library
Library containing utilities to read and parse a stream, live or recorded, retrieved from an ALB (Augmented LiDAR Box).
The stream is in the OSEF format (Open SErialization Format): it's an Outsight-defined serialisation binary format used to encode data streaming out of the ALB. It is based on TLV-encoding.
For the full documentation, contact us @ https://support.outsight.ai
Installation
Install from PyPi using pip:
pip install osef
Usage
Open and parse an osef file or stream:
import osef
osef_path = "path/to/my/file.osef"
# or osef_path="tcp://192.168.2.2:11120"
frame_iterator = osef.parser.parse(osef_path)
for frame_dict in frame_iterator:
tracked_objects = osef.osef_frame.TrackedObjects(frame_dict)
By default, the parser processes the recorded data as quickly as your computer allows it, so potentially faster than in real conditions. To process recorded data at the same pace as real time OSEF stream coming from an ALB, set the parameter real_frequency = True
frame_iterator = osef.parser.parse(osef_path, True)
or
import osef
osef_path = "path/to/my/file.osef"
# or osef_path="tcp://192.168.2.2:11120"
with osef.parser.OsefStream(osef_path) as osef_stream:
tlv_iterator = osef.parser.get_tlv_iterator(osef_stream)
for index, tlv in tlv_iterator:
tree = osef.parser.build_tree(tlv)
frame_dict = osef.parser.parse_to_dict(tree)
tracked_objects = osef.osef_frame.TrackedObjects(frame_dict)
To find more code samples, see Outsight Code Samples repository: https://gitlab.com/outsight-public/outsight-code-samples/-/tree/master
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.