Skip to content

Latest commit

 

History

History
47 lines (34 loc) · 1.72 KB

README.md

File metadata and controls

47 lines (34 loc) · 1.72 KB
Raw

Sensors Tools

This repository offers a generic sensor interface for RGB-D semantic ROS messages. It mainly tackles the problem of bridging semantic measurements from simulators, datasets, other ROS frameworks.

Installation

Clone the repository with:

git clone https://github.com/dvdmc/sensors_tools

Then, you can install the required dependencies and the python package with:

pip install . (use -e for installing an editable version in case you want to modify / debug)

Structure

  • sensors_tools/:
    • base/: general classes.
    • utils/: general functions or tool classes.
    • bridges/: classes to interface with simulators, datasets, ROS...
    • inference/: module to store inference models (currently mainly aimed at semantics), loading them for inference with a general interface, and performing inference.
    • sensor.py: a generic sensor that loads: a bridge as a data interface, (optionally) an inference module to obtain data from Neural Networks.
  • sensor_tools_ros/:
    • semantic_ros.py: main node for using the sensor.py within ROS.

Configuration

For the configuration, this repository follows the approach of keeping {Class}Config dataclasses that are used for typing and defaults. The config objects are used to configure an instantiated class. In ROS, this configuration is input using a .yaml file (check semantic_ros.py).

Usage

The intended usage is by running the sensor node with rosrun or using a launch file:

roslaunch sensors_tools_ros semantic_sensor.launch