# rqt-dotgraph

**Repository Path**: agiros/rqt-dotgraph

## Basic Information

- **Project Name**: rqt-dotgraph
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: CC0-1.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-03-13
- **Last Updated**: 2026-04-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# `rqt_dotgraph`

Provides a ROS2 node and an rqt plugin for visualizing [DOT][dot] graph files.
You can either load a DOT file or subscribe to a ROS2 topic.

To visualize the DOT graphs, this module includes a version of [`xdot_qt.py`][xdot]
forked from [ROSPlan][rosplan] and released under [LGPLv3][lgplv3].
The forked version in this package has been modified and the changes to it are released under the LGPLv3.
The rest of this package is released under the [CC0][cc0] license.

## Nodes

### `rqt_dotgraph`

#### Subscriptions

`dot_graph` ([std_msgs/String](https://github.com/ros2/common_interfaces/blob/master/std_msgs/msg/String.msg))

* String containing the dot graph itself (e.g. the contents of a DOT file).

#### Parameters

`~title` (string, default: Dot Graph Viewer)

* Window title.

## Troubleshooting

### Plugin File Not Found

`rqt` plugins can have issues running.
This has occurred most often after updating graphics drivers.
A typical error message is the following.

```shell
RosPluginProvider._parse_plugin_xml() plugin file "/home/user/ws/install/rqt_dotgraph/share/rqt_dotgraph/plugin.xml" in package "rqt_dotgraph" not found
```

The fix is to run the following command then continue with previous commands where the error occurred.

```shell
ros2 run rqt_dotgraph rqt_dotgraph --force-discover
```

### Import Errors when Running

When running the node with

```shell
ros2 run rqt_dotgraph rqt_dotgraph
```

and this error occurs

```shell
ImportError: cannot import name 'QVariant' from 'PySide2.QtCore' (/home/thomas/src/rqt_dotgraph/venv/lib/python3.10/site-packages/PySide2/QtCore.abi3.so)
```

Fix it with

```shell
pip install PyQt5
```

If this error occurs

```shell
ModuleNotFoundError: No module named 'PySide2'
```

Fix it with

```shell
pip install PySide2
```

[dot]: https://en.wikipedia.org/wiki/DOT_(graph_description_language)
[xdot]: https://github.com/jrfonseca/xdot.py
[rosplan]: https://github.com/KCL-Planning/ROSPlan/blob/master/rosplan_rqt/src/rosplan_rqt/xdot_qt.py
[lgplv3]: https://www.gnu.org/licenses/lgpl-3.0.html
[cc0]: https://creativecommons.org/share-your-work/public-domain/cc0/