How swri-robotics/mapviz works
Project type and purpose
• This is a desktop “full-stack” visualization application built on ROS (Robot Operating System).
File structure
• Top-level packages:
• mapviz – the core GUI application, plugin loader, Qt UI definitions
• mapviz_interfaces – custom ROS services (e.g. AddMapvizDisplay)
• mapviz_plugins – a collection of visualization plugins (attitude, grid, path, point click, etc.)
• multires_image – multi-resolution image loader: Qt plugin + standalone tile loader node
• tile_map – tile-map source plugin for mapviz
• docs & GitHub CI/build files
• Each package has its own CMakeLists.txt and package.xml, indicating they are ROS2 packages built with ament/CMake.
• Qt .ui files define plugin configuration dialogs; plugin.xml and mapviz_plugins.xml register plugins with the core.
Architecture insights from README
• Core is a ROS node (“mapviz_main”) that hosts plugins.
• Plugins subscribe to ROS topics (Image, Pose, Path, PointCloud2, etc.) and render into a 2D canvas.
• There are also standalone helper nodes (e.g., mapviz_tile_loader, multires_view_node) launched via ROS launch files.