[Documentation] [TitleIndex] [WordIndex

Package Summary

A mission planner and visualizer for controlling outdoor ROS robots.

  • Maintainer status: maintained
  • Maintainer: MoffKalast <vid.rijavec AT gmail DOT com>
  • Author: MoffKalast <vid.rijavec AT gmail DOT com>
  • License: BSD
  • Source: git https://github.com/MoffKalast/vizanti.git (branch: noetic-devel)


Web Visualizer & Mission Planner for ROS

Vizanti is a web-based visualization and control tool developed for more convenient operation of outdoor robots running the Robot Operating System (ROS). The application attempts to replicate RViz's orthographic 2D view as closely as possible with a smartphone friendly interface. The second goal is to allow planning and executing movement and mission commands, i.e. goals and waypoints, with custom buttons and parameter reconfigure.



As a field tool, Vizanti is designed to operate just as well without internet access, and as such the intended way is to host it on a robot, with rosbridge autoconnecting to the host IP.

cd ~/catkin_ws/src
git clone https://github.com/MoffKalast/vizanti.git
cd ..
rosdep install --from-paths src --ignore-src

Or if rosdep fails for some reason, these are the main two deps:

sudo apt install ros-noetic-rosbridge-suite python3-flask

Flask and Jinja2 are used for templating, rosbridge is required for socket communication.


roslaunch vizanti server.launch

The web app can be accessed at http://<host_ip>:5000. Client settings are automatically saved in localStorage. The satelite imagery renderer also uses the indexedDB to store tiles for offline use (note that this is IP specific). By default the rosbridge instance also occupies port 5001.

If you're using a mobile device connected to a robot's hotspot that doesn't have internet access, make sure to turn off mobile data. This will prevent Android from sending packets to the wrong gateway.

Note that the client uses the web fetch API to load a fair few things, make sure your browser is at least somewhat up to date or some features may not work.

Demo Videos

Desktop demo (SLAM, node manager, dynamic reconfigure):

Mobile demo (GPS navigation, OSM tile map):

Feature list

Aside from the required ones, custom widgets can be added to the navbar to customize functionality for a given robot and test setup.

Note: Some icons open setup modals instantly, while others use a single press to trigger actions and use a long press to open the modal.

General Tools & Configuration

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/settings.png?raw=true Global Settings Set the background color and the fixed TF frame. Also has a button to reset the camera view to zero and default zoom.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/grid.png?raw=true Grid The adjustable metric grid. Currently renders only in the fixed frame.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/tf.png?raw=true TF Renders TF frames, same options as in RViz for the most part.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/robotmodel.png?raw=true Robot Model Renders a 2D sprite to represent the robot model or any specific TF link.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/reconfigure.png?raw=true Dynamic Reconfigure Adjust configurations of all nodes supporting dynamic reconfigure params. Currently rather slow to load and update, but will make sure parameters are current. It treats ints as floats due to type autodetection problems.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/rosbag.png?raw=true Bag Recorder Recording specified topics by calling rosbag record via proxy.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/nodemgr.png?raw=true Node Manager See info printouts of a specific node, kill nodes, launch nodes, that sort of thing.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/add.png?raw=true Add new visualizer/widget Self explanatory.

Mission Planning

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/joystick.png?raw=true Teleop Joystick Joystick used for publishing Twist messages, can be positioned anywhere on the screen and switched into holonomic mode.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/initialpose.png?raw=true 2D Pose Estimate Send the /initialpose for navigation startup. Long press to open setup menu.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/simplegoal.png?raw=true 2D Nav Goal Send a /move_base_simple/goal. Long press to open setup menu.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/waypoints.png?raw=true Waypoint Mission Create missions with multiple waypoints, then send them as a Path message. Single tap to add a point, single tap to remove an existing one, hold and drag to move points. Adding a point on an existing line will add it between those two points. Long press to open setup menu.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/area.png?raw=true Area Mission Drag to select an area and publish it to a PolygonStamped topic. Since the area is a rectangle, the first polygon vertex will be at the cursor press, and the third vertex will be the press released point. Long press to open setup menu.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/button.png?raw=true Button A button with customizable text that displays the last message sent on a Bool topic and sends the inverse to toggle it when pressed. Also supports just sending messages to an Empty topic. Long press to open setup menu.

Data Visualization

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/map.png?raw=true Map Display an OccupancyGrid. Also has some experimental map_server controls for saving and loading maps.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/satelite.png?raw=true Satellite Tiles Display satellite imagery, by default from OpenStreetMap. Requires a Fix origin with the correct frame in its header.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/gridcells.png?raw=true Grid Cells Displays a grid of cells. Yes really, who would've thought.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/image.png?raw=true Compressed Image Display a CompressedImage message in a movable box anywhere on the screen. Heavily throttled by default.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/battery.png?raw=true Battery Display a BatteryState message.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/image.png?raw=true Compressed Image

Display a CompressedImage message in a movable box anywhere on the screen. Heavily throttled by default.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/markerarray.png?raw=true Marker Array Visualize a MarkerArray. Currently supported types are ARROW, CUBE, SPHERE, CYLINDER, LINE_STRIP and TEXT_VIEW_FACING. Since each of these widgets adds another canvas layer, it makes more sense to aggregate regular Marker messages into a Marker Array to avoid some of that overhead.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/path.png?raw=true Path Render a Path message for navigation debugging.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/sonar.png?raw=true Range Render a Range message on the main view. Supports grouping multiple messages onto the same topic, as long as the tf frames are different.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/scan.png?raw=true LaserScan Display a LaserScan message on the main view. Heavily throttled by default.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/pointcloud.png?raw=true Point Cloud Display a PointCloud2 message on the main view. Heavily throttled by default.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/posewithcovariancestamped.png?raw=true Pose with Covariance (Stamped) Display a PoseWithCovarianceStamped message. The covariance rendering is currently experimental and will likely only display correctly for spherical covariance.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/posearray.png?raw=true Pose Array Display a PoseArray message. Throttled to 15 Hz.

https://github.com/MoffKalast/vizanti/blob/noetic-devel/wiki_assets/temp.png?raw=true Temperature Display a Temperature message. Only as a widget for now, not on the view itself.

2024-05-18 14:11