Python library to convert ros message streams to pandas dataframes.
Project description
Rosbags-dataframe
Rosbags-dataframe a python library to ease the create of pandas dataframes from rosbag messages. It is part of the larger Rosbags ecosystem.
Rosbags-dataframe does not have any dependencies on the ROS software stacks and can be used on its own or alongside ROS1 or ROS2.
Getting started
Rosbags-dataframe is published on PyPI and does not have any special dependencies. Simply install with pip:
pip install rosbags-dataframe
Get a dataframe from a rosbag:
from pathlib import Path
from rosbags.dataframe import get_dataframe
from rosbags.highlevel import AnyReader
with AnyReader([Path('test1.bag'), Path('test2.bag')]) as reader:
dataframe = get_dataframe(reader, '/gps', ['latitude', 'longitude'])
Documentation
Read the documentation for further information.
Contributing
Thank you for considering to contribute to rosbags-dataframe.
To submit issues or create merge requests please follow the instructions provided in the contribution guide.
By contributing to rosbags-dataframe you accept and agree to the terms and conditions laid out in there.
Development
Clone the repository and setup your local checkout:
git clone https://gitlab.com/ternaris/rosbags-dataframe.git cd rosbags-dataframe python -m venv venv . venv/bin/activate pip install -r requirements-dev.txt pip install -e .
This creates a new virtual environment with the necessary python dependencies and installs rosbags-dataframe in editable mode. The rosbags-dataframe code base uses pytest as its test runner, run the test suite by simply invoking:
pytest
To build the documentation from its source run sphinx-build:
sphinx-build -a docs public
The entry point to the local documentation build should be available under public/index.html.
Support
Professional support is available from Ternaris.
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.
Source Distribution
Built Distribution
Hashes for rosbags_dataframe-0.9.1-py3-none-any.whl
Algorithm | Hash digest | |
---|---|---|
SHA256 | 1a50117f1c20392865bc9fd5f34b38f3947ad8009bacd0323d16862fcad78f1a |
|
MD5 | 709594fd930437f11216151e66966b2f |
|
BLAKE2b-256 | e7ceaebb7ff67741fd34c53c0f239b68f58db97699670e31443f8ce304941b91 |