Skip to content

tracetools_analysis

  • Software
  • Middleware
  • Tool

Python analysis tools for traces produced by ros2_tracing, turning LTTng trace data into pandas DataFrames and data models for ROS 2 analysis.

Made by ros-tracing.

Source on GitHub: github.com/ros-tracing/tracetools_analysis (opens in a new tab). Facts read at commit caa8c05 (opens in a new tab).

Licenses

Code
Apache-2.0 (opens in a new tab)

Read by Robotheca from LICENSE (opens in a new tab) (Apache-2.0) at commit caa8c05 (opens in a new tab), on 16 Oct 2026.

Commercial use
Yes

What it does

  • Provides a ros2 trace-analysis command that processes a trace directory into lightly processed pandas DataFrames for quick inspection.
  • Converts slow-to-read CTF traces into a single faster-to-load file that can be reused across many analyses.
  • Offers a Python API with handlers and data model utilities to extract callback durations and CPU time per thread.
  • Is intended for interactive analysis in Jupyter Notebooks, with example notebooks provided in the analysis directory.
  • Includes a ros2cli extension package and a tracetools_analysis package with analysis tools and API documentation.
  • Requires choosing the branch that matches the ROS 2 distribution in use.

Written by Robotheca from the project's README (opens in a new tab) at commit caa8c05.

Getting started

Difficulty
Advanced

Maintenance

Status
Maintained: a commit in the last 12 months
Newest commit
14 Nov 2025 on rolling
Latest release
None published on GitHub

Checked on GitHub on 16 Oct 2026.

Robots that can run it

No robot on Robotheca is linked to it yet. Links come from a robot's robot.yaml, from its dependency files read as text, or from Robotheca's editors.

Robotheca lists software as a reference: nothing is hosted or run here, and every fact links to where it was read.