robot-log-visualizer

Visualizer for robot logger


Keywords
robotics, visualization, python, robot, visualization-tools
License
BSD-3-Clause
Install
pip install robot-log-visualizer==0.8.0

Documentation

πŸ€– robot-log-visualizer

robot-log-visualizer implements a python visualizer to display the data logged with YarpRobotLoggerDevice application.

πŸ“ Install

Please follow one of the following methods to use the software

Install with conda (recommended)

Assuming that you have conda installed, you can create a new environment and install the robot-log-visualizer with the following commands:

conda create -n visualizer-env
conda activate visualizer-env

and you can install the robot-log-visualizer with the following command

conda install -c robotology robot-log-visualizer

🐍 Install from pip with apt python

Install python3, if not installed (in Ubuntu 20.04):

sudo apt install python3.8 python3-virtualenv swig

Create a virtual environment and activate it. For example:

python3 -m venv visualizer-env
. visualizer-env/bin/activate

Inside the virtual environment, install the application from pip:

pip install robot-log-visualizer

πŸ‘· Install the latest version (not recommended)

If you want to use the latest feature of the robot-log-visualizer you can install it with the following command

python -m pip install git+https://github.com/ami-iit/robot-log-visualizer.git

πŸƒ Usage

Once you have installed the robot-log-visualizer you can run it from the terminal

robot-log-visualizer.webm

You can navigate the dataset thanks to the slider or by pressing Ctrl-f and Ctrl-b to move forward and backward.

πŸ’‘ Environment variables

robot-log-visualizer looks for the model in the folders pointed by one of the following environment variables: GAZEBO_MODEL_PATH, ROS_PACKAGE_PATH, AMENT_PREFIX_PATH Please remember to add your model folder to one of these environment variables. For instance, if you have a model in the folder ~/my-models you can add it to the GAZEBO_MODEL_PATH with the following command

export GAZEBO_MODEL_PATH=${GAZEBO_MODEL_PATH}:~/my-models

Where ~/my-models is the path to your models folder that is structured as follows

tree ~/my-models
~/my-models
β”œβ”€β”€ model1
β”‚Β Β  β”œβ”€β”€ model.config
β”‚Β Β  └── model.urdf
└── model2
    β”œβ”€β”€ model.config
    └── model.urdf

And the name of the robot stored in the mat file is model1 or model2.

πŸ› Bug reports and support

All types of issues are welcome.

πŸ“ License

Materials in this repository are distributed under the following license:

All software is licensed under the BSD 3-Clause License. See LICENSE file for details.

πŸ§‘β€πŸ’» Maintainer