ulogr

ulogr is a command-line tool that turns PX4 .ulg flight logs into a self-contained HTML report with interactive plots, sensor-quality timelines, event markers, structured JSON output, and a simple 3D flight replay.

Scope

This tool is intended for PX4 ULog files from multicopter field tests, bench tests, and post-flight review workflows where a quick visual report is useful.

It currently focuses on:

• PX4 .ulg files readable by pyulog
• Multicopter-oriented topics such as local position, attitude, actuator outputs, battery status, estimator status, magnetometer, GPS, failsafe flags, and hover thrust estimate
• HTML reports for human review or for sharing summarized context with an LLM

It is not a flight-certification tool, a replacement for PX4 Flight Review, or a guarantee of aircraft safety.

Install

pip install ulogr

For local development from a checkout:

pip install -e .

Usage

Analyze all .ulg files in the current directory:

ulogr .

Generate a fully offline HTML file with Plotly embedded:

ulogr . --inline-plotly

Analyze one file:

ulogr flight.ulg -o flight_report.html --inline-plotly

The command writes:

• ulog_analysis_report.html
• ulog_analysis_report.summary.json

You can also use the compatibility script from a source checkout:

python analyze_ulog_report.py . --inline-plotly

Long-form command aliases are also installed:

ulogreport .
ulog-report-analyzer .
analyze-ulog-report .

Command Options

path              Directory containing .ulg files, or a single .ulg file.
-o, --output      Output HTML path. Default: ulog_analysis_report.html
--inline-plotly   Embed Plotly JavaScript for offline viewing. This makes the HTML larger.

Output

The HTML report includes:

• Per-log summary cards
• Automated issue table
• Magnetometer validity table
• Sensor/data-quality timeline
• Simple 3D flight replay
• Interactive detailed plots
• Embedded JSON summary for downstream tools or LLM context

License

MIT