Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/ros-tracing/tracetools_analysis
Utilities for analyzing trace data from ROS 2 systems generated by the ros2_tracing packages.
https://github.com/ros-tracing/tracetools_analysis
ros ros2 ros2-tracing trace-analysis tracetools-analysis tracing
Last synced: about 1 month ago
JSON representation
Utilities for analyzing trace data from ROS 2 systems generated by the ros2_tracing packages.
- Host: GitHub
- URL: https://github.com/ros-tracing/tracetools_analysis
- Owner: ros-tracing
- License: apache-2.0
- Created: 2020-01-26T16:23:30.000Z (about 5 years ago)
- Default Branch: rolling
- Last Pushed: 2024-06-26T19:24:00.000Z (7 months ago)
- Last Synced: 2024-06-27T23:09:29.940Z (7 months ago)
- Topics: ros, ros2, ros2-tracing, trace-analysis, tracetools-analysis, tracing
- Language: Python
- Homepage:
- Size: 2.71 MB
- Stars: 15
- Watchers: 3
- Forks: 10
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-ai-robotics - **tracetools_analysis** - Utilities for analyzing trace data from ROS 2 systems generated by the ros2_tracing packages. (ROS2 / Dev Tools)
- awesome-ai-robotics - **tracetools_analysis** - Utilities for analyzing trace data from ROS 2 systems generated by the ros2_tracing packages. (ROS2 / Dev Tools)
README
# tracetools_analysis
[](https://codecov.io/gh/ros-tracing/tracetools_analysis)
Analysis tools for [`ros2_tracing`](https://github.com/ros2/ros2_tracing).
**Note**: make sure to use the right branch, depending on the ROS 2 distro: [use `rolling` for Rolling, `humble` for Humble, etc.](https://docs.ros.org/en/rolling/The-ROS2-Project/Contributing/Developer-Guide.html)
## Trace analysis
After generating a trace (see [`ros2_tracing`](https://github.com/ros2/ros2_tracing#tracing)), we can analyze it to extract useful execution data.
### Commands
Then we can process a trace to create a data model which could be queried for analysis.
```shell
$ ros2 trace-analysis process /path/to/trace/directory
```
Note that this simply outputs lightly-processed ROS 2 trace data which is split into a number of pandas `DataFrame`s.
This can be used to quickly check the trace data.
For real data processing/trace analysis, see [*Analysis*](#analysis).
Since CTF traces (the output format of the [LTTng](https://lttng.org/) tracer) are very slow to read, the trace is first converted into a single file which can be read much faster and can be re-used to run many analyses.
This is done automatically, but if the trace changed after the file was generated, it can be re-generated using the `--force-conversion` option.
Run with `--help` to see all options.
### Analysis
The command above will process and output raw data models.
We need to actually analyze the data and display some results.
We recommend doing this in a Jupyter Notebook, but you can do this in a normal Python file.
```shell
$ jupyter notebook
```
Navigate to the [`analysis/`](./tracetools_analysis/analysis/) directory, and select one of the provided notebooks, or create your own!
For example:
```python
from tracetools_analysis.loading import load_file
from tracetools_analysis.processor import Processor
from tracetools_analysis.processor.cpu_time import CpuTimeHandler
from tracetools_analysis.processor.ros2 import Ros2Handler
from tracetools_analysis.utils.cpu_time import CpuTimeDataModelUtil
from tracetools_analysis.utils.ros2 import Ros2DataModelUtil
# Load trace directory or converted trace file
events = load_file('/path/to/trace/or/converted/file')
# Process
ros2_handler = Ros2Handler()
cpu_handler = CpuTimeHandler()
Processor(ros2_handler, cpu_handler).process(events)
# Use data model utils to extract information
ros2_util = Ros2DataModelUtil(ros2_handler.data)
cpu_util = CpuTimeDataModelUtil(cpu_handler.data)
callback_symbols = ros2_util.get_callback_symbols()
callback_object, callback_symbol = list(callback_symbols.items())[0]
callback_durations = ros2_util.get_callback_durations(callback_object)
time_per_thread = cpu_util.get_time_per_thread()
# ...
# Display, e.g., with bokeh, matplotlib, print, etc.
print(callback_symbol)
print(callback_durations)
print(time_per_thread)
# ...
```
Note: bokeh has to be installed manually, e.g., with `pip`:
```shell
$ pip3 install bokeh
```
## Design
See the [`ros2_tracing` design document](https://github.com/ros2/ros2_tracing/blob/rolling/doc/design_ros_2.md), especially the [*Goals and requirements*](https://github.com/ros2/ros2_tracing/blob/rolling/doc/design_ros_2.md#goals-and-requirements) and [*Analysis*](https://github.com/ros2/ros2_tracing/blob/rolling/doc/design_ros_2.md#analysis) sections.
## Packages
### ros2trace_analysis
Package containing a `ros2cli` extension to perform trace analysis.
### tracetools_analysis
Package containing tools for analyzing trace data.
See the [API documentation](https://docs.ros.org/en/rolling/p/tracetools_analysis/).