ROS Index
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | humble |
| Last Updated | 2026-02-24 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 11.2.26 |
| rviz_assimp_vendor | 11.2.26 |
| rviz_common | 11.2.26 |
| rviz_default_plugins | 11.2.26 |
| rviz_ogre_vendor | 11.2.26 |
| rviz_rendering | 11.2.26 |
| rviz_rendering_tests | 11.2.26 |
| rviz_visual_testing_framework | 11.2.26 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Frame Aligned | Time |
| Fluid | 2D Nav Goal | Third Person Follower | Tool Properties |
| Grid | Publish Point | Top Down Orthographic | Views |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | jazzy |
| Last Updated | 2026-02-24 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 14.1.20 |
| rviz_assimp_vendor | 14.1.20 |
| rviz_common | 14.1.20 |
| rviz_default_plugins | 14.1.20 |
| rviz_ogre_vendor | 14.1.20 |
| rviz_rendering | 14.1.20 |
| rviz_rendering_tests | 14.1.20 |
| rviz_visual_testing_framework | 14.1.20 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Frame Aligned | Time |
| Fluid | 2D Nav Goal | Third Person Follower | Tool Properties |
| Grid | Publish Point | Top Down Orthographic | Views |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_resource_interfaces rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | kilted |
| Last Updated | 2026-02-24 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 15.0.12 |
| rviz_assimp_vendor | 15.0.12 |
| rviz_common | 15.0.12 |
| rviz_default_plugins | 15.0.12 |
| rviz_ogre_vendor | 15.0.12 |
| rviz_rendering | 15.0.12 |
| rviz_rendering_tests | 15.0.12 |
| rviz_resource_interfaces | 15.0.12 |
| rviz_visual_testing_framework | 15.0.12 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Frame Aligned | Time |
| Fluid | 2D Nav Goal | Third Person Follower | Tool Properties |
| Grid | Publish Point | Top Down Orthographic | Views |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_resource_interfaces rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | rolling |
| Last Updated | 2026-02-25 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 15.1.17 |
| rviz_common | 15.1.17 |
| rviz_default_plugins | 15.1.17 |
| rviz_ogre_vendor | 15.1.17 |
| rviz_rendering | 15.1.17 |
| rviz_rendering_tests | 15.1.17 |
| rviz_resource_interfaces | 15.1.17 |
| rviz_visual_testing_framework | 15.1.17 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Frame Aligned | Time |
| Fluid | 2D Nav Goal | Third Person Follower | Tool Properties |
| Grid | Publish Point | Top Down Orthographic | Views |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | humble |
| Last Updated | 2026-02-24 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 11.2.26 |
| rviz_assimp_vendor | 11.2.26 |
| rviz_common | 11.2.26 |
| rviz_default_plugins | 11.2.26 |
| rviz_ogre_vendor | 11.2.26 |
| rviz_rendering | 11.2.26 |
| rviz_rendering_tests | 11.2.26 |
| rviz_visual_testing_framework | 11.2.26 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Frame Aligned | Time |
| Fluid | 2D Nav Goal | Third Person Follower | Tool Properties |
| Grid | Publish Point | Top Down Orthographic | Views |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | galactic |
| Last Updated | 2022-12-05 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 8.5.2 |
| rviz_assimp_vendor | 8.5.2 |
| rviz_common | 8.5.2 |
| rviz_default_plugins | 8.5.2 |
| rviz_ogre_vendor | 8.5.2 |
| rviz_rendering | 8.5.2 |
| rviz_rendering_tests | 8.5.2 |
| rviz_visual_testing_framework | 8.5.2 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| Fluid Pressure | Measure | First Person | Selections |
| Grid | Select | Third Person Follower | Time |
| Grid Cells | 2D Nav Goal | Top Down Orthographic | Tool Properties |
| Illuminance | Publish Point | Views | |
| Image | Initial Pose | ||
| Interactive Marker | Interact | ||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
These features have not been ported to ros2/rviz yet.
| Displays |
|---|
| DepthCloud |
| Effort |
Other features:
- Image transport features
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
File truncated at 100 lines see the full file
CONTRIBUTING
|
|
rviz repositoryrviz2 rviz_assimp_vendor rviz_common rviz_default_plugins rviz_ogre_vendor rviz_rendering rviz_rendering_tests rviz_visual_testing_framework |
ROS Distro
|
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros2/rviz.git |
| VCS Type | git |
| VCS Version | iron |
| Last Updated | 2024-11-26 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz2 | 12.4.10 |
| rviz_assimp_vendor | 12.4.10 |
| rviz_common | 12.4.10 |
| rviz_default_plugins | 12.4.10 |
| rviz_ogre_vendor | 12.4.10 |
| rviz_rendering | 12.4.10 |
| rviz_rendering_tests | 12.4.10 |
| rviz_visual_testing_framework | 12.4.10 |
README
RViz
This branch is currently contained in the main ros2.repos file of ROS 2 and can be used for ROS 2.
The latest release will be available with your ROS 2 download.
ROS 2 does not have a wiki yet. To learn about RViz and its functionality, please refer to the ROS RViz wiki page.
Features
Already ported
These features have already been ported from ros-visualization/rviz to ros2/rviz.
The basic documentation can still be found on the RViz wiki page.
For some displays, the documentation is updated.
| Displays | Tools | View Controller | Panels |
|---|---|---|---|
| Axes | Move Camera | Orbit | Displays |
| Camera | Focus Camera | XY Orbit | Help |
| DepthCloud | Measure | First Person | Selections |
| Effort | Select | Third Person Follower | Time |
| Fluid | 2D Nav Goal | Top Down Orthographic | Tool Properties |
| Grid | Publish Point | Views | |
| Grid Cells | Initial Pose | ||
| Illuminance | Interact | ||
| Image | |||
| Interactive Marker | |||
| Laser Scan | |||
| Map | |||
| Marker | |||
| Marker Array | |||
| Odometry | |||
| Point Cloud (1 and 2) | |||
| Point | |||
| Polygon | |||
| Pose | |||
| Pose Array | |||
| Pose With Covariance | |||
| Range | |||
| Relative Humidity | |||
| Robot Model | |||
| Temperature | |||
| TF | |||
| Wrench |
Not yet ported
Other features:
- Stereo
In case you wished to see those features in RViz for ROS 2, feel free to add a pull request. Make sure to read the developer guide below and the migration guide.
New features
Pluggable transformation library
In RViz for ROS 1 the frames transformation library used is tf2 (detailed information about it can be found here). In RViz for ROS 2 the frames transformation library is now pluggable, meaning that different transformation library plugins can be loaded and changed dynamically in the gui. Developers can create and use their own plugins to provide custom transformation behavior.
Two plugins are bundled with RViz:
- a plugin for tf2 (
TFFrameTransformer, inrviz_default_plugins), which provides the standard tf2 functionality and which is used as a default - a trivial plugin (
IdentityFrameTransformer, inrviz_common), which always performs identity transforms. This plugin is used by default if the tf2 plugin is not available and no other valid plugin is specified.
As anticipated, in order for the user to choose the plugin to use, RViz provides a dedicated panel: the Transformation panel.
Note: Not all transformation plugins are necessarily compatible with all RViz displays (e.g. some of the default displays, like the TF display, can only work with tf2).
In order to take this possibility into account, the TransformerGuard class is provided.
Adding it to a display ensures that the display will be disabled and won’t function in case the wrong transformer is used.
More detailed information on how to write a transformation plugin and on how to handle transformation specific displays can be found in the plugin development guide.
Developer Guide
Build
Building RViz together with ROS 2
The simplest way to build from source is to use the official installation guide, since RViz is part of the official ROS 2 repos file.
https://docs.ros.org/en/rolling/Installation.html
Building RViz in a separate workspace
When developing for RViz, it can be beneficial to build it in a separate workspace.
Note: When building the current ros2 branch from source, the latest ROS 2 release for all dependencies might not be sufficient: it could be necessary to build the ROS 2 master branch. Make sure to have a source build of ROS 2 available (see installation procedure above).
Create a new workspace:
$ mkdir -p ~/rviz2_ws/src
$ cd ~/rviz2_ws/src
Clone these repositories into the source folder:
$ git clone https://github.com/ros2/rviz.git
File truncated at 100 lines see the full file
CONTRIBUTING
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros-visualization/rviz.git |
| VCS Type | git |
| VCS Version | melodic-devel |
| Last Updated | 2023-05-25 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz | 1.13.30 |
README
rviz is a 3D visualizer for the Robot Operating System (ROS) framework.
For more information, please see the wiki: http://wiki.ros.org/rviz
Maintainers:
- Robert Haschke (2019-)
- William Woodall (2013-2018)
- David Gossow (2013)
- Dave Hershberger (2011-2013)
- Josh Faust (2010)
This package contains Public Domain icons downloaded from http://tango.freedesktop.org/releases/.
Other icons and graphics contained in this package are released into the Public Domain as well.
Copyright notice for all icons and graphics in this package:
Public Domain Dedication
Copyright-Only Dedication (based on United States law) or Public Domain
Certification
The person or persons who have associated work with this document (the
"Dedicator" or "Certifier") hereby either (a) certifies that, to the best
of his knowledge, the work of authorship identified is in the public
domain of the country from which the work is published, or (b)
hereby dedicates whatever copyright the dedicators holds in the work
of authorship identified below (the "Work") to the public domain. A
certifier, moreover, dedicates any copyright interest he may have in
the associated work, and for these purposes, is described as a
"dedicator" below.
A certifier has taken reasonable steps to verify the copyright
status of this work. Certifier recognizes that his good faith efforts
may not shield him from liability if in fact the work certified is not
in the public domain.
Dedicator makes this dedication for the benefit of the public at
large and to the detriment of the Dedicator's heirs and successors.
Dedicator intends this dedication to be an overt act of relinquishment
in perpetuity of all present and future rights under copyright law,
whether vested or contingent, in the Work. Dedicator understands that
such relinquishment of all rights includes the relinquishment of all
rights to enforce (by lawsuit or otherwise) those copyrights in the
Work.
Dedicator recognizes that, once placed in the public domain, the Work
may be freely reproduced, distributed, transmitted, used, modified,
built upon, or otherwise exploited by anyone for any purpose, commercial
or non-commercial, and in any way, including by methods that have not
yet been invented or conceived.
Source: http://creativecommons.org/licenses/publicdomain/
CONTRIBUTING
Repository Summary
| Description | ROS 3D Robot Visualizer |
| Checkout URI | https://github.com/ros-visualization/rviz.git |
| VCS Type | git |
| VCS Version | noetic-devel |
| Last Updated | 2025-05-02 |
| Dev Status | MAINTAINED |
| Released | RELEASED |
| Contributing |
Help Wanted (-)
Good First Issues (-) Pull Requests to Review (-) |
Packages
| Name | Version |
|---|---|
| rviz | 1.14.26 |
README
rviz is a 3D visualizer for the Robot Operating System (ROS) framework.
For more information, please see the wiki: http://wiki.ros.org/rviz
Maintainers:
- Robert Haschke (2019-)
- William Woodall (2013-2018)
- David Gossow (2013)
- Dave Hershberger (2011-2013)
- Josh Faust (2010)
This package contains Public Domain icons downloaded from http://tango.freedesktop.org/releases/.
Other icons and graphics contained in this package are released into the Public Domain as well.
Copyright notice for all icons and graphics in this package:
Public Domain Dedication
Copyright-Only Dedication (based on United States law) or Public Domain
Certification
The person or persons who have associated work with this document (the
"Dedicator" or "Certifier") hereby either (a) certifies that, to the best
of his knowledge, the work of authorship identified is in the public
domain of the country from which the work is published, or (b)
hereby dedicates whatever copyright the dedicators holds in the work
of authorship identified below (the "Work") to the public domain. A
certifier, moreover, dedicates any copyright interest he may have in
the associated work, and for these purposes, is described as a
"dedicator" below.
A certifier has taken reasonable steps to verify the copyright
status of this work. Certifier recognizes that his good faith efforts
may not shield him from liability if in fact the work certified is not
in the public domain.
Dedicator makes this dedication for the benefit of the public at
large and to the detriment of the Dedicator's heirs and successors.
Dedicator intends this dedication to be an overt act of relinquishment
in perpetuity of all present and future rights under copyright law,
whether vested or contingent, in the Work. Dedicator understands that
such relinquishment of all rights includes the relinquishment of all
rights to enforce (by lawsuit or otherwise) those copyrights in the
Work.
Dedicator recognizes that, once placed in the public domain, the Work
may be freely reproduced, distributed, transmitted, used, modified,
built upon, or otherwise exploited by anyone for any purpose, commercial
or non-commercial, and in any way, including by methods that have not
yet been invented or conceived.
Source: http://creativecommons.org/licenses/publicdomain/