From d3fb01dffa9931f5562ed46628d727f98ea05222 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Beat=20K=C3=BCng?= Date: Tue, 7 Jan 2025 11:09:14 +0100 Subject: [PATCH] add page for statistical flight log analysis --- en/SUMMARY.md | 1 + en/_sidebar.md | 1 + en/dev_log/flight_log_analysis.md | 1 + en/dev_log/flight_log_analysis_statistical.md | 18 ++++++++++++++++++ 4 files changed, 21 insertions(+) create mode 100644 en/dev_log/flight_log_analysis_statistical.md diff --git a/en/SUMMARY.md b/en/SUMMARY.md index ea0ad4fdac8d..1123c1148efc 100644 --- a/en/SUMMARY.md +++ b/en/SUMMARY.md @@ -752,6 +752,7 @@ - [Binary Size Profiling](debug/binary_size_profiling.md) - [Logging](dev_log/logging.md) - [Flight Log Analysis](dev_log/flight_log_analysis.md) + - [Statistical Analysis](dev_log/flight_log_analysis_statistical.md) - [ULog File Format](dev_log/ulog_file_format.md) - [Log Encryption](dev_log/log_encryption.md) - [Advanced Topics](advanced/index.md) diff --git a/en/_sidebar.md b/en/_sidebar.md index 001b27d44194..6e9da93cf4b5 100644 --- a/en/_sidebar.md +++ b/en/_sidebar.md @@ -741,6 +741,7 @@ - [Binary Size Profiling](/debug/binary_size_profiling.md) - [Logging](/dev_log/logging.md) - [Flight Log Analysis](/dev_log/flight_log_analysis.md) + - [Statistical Analysis](/dev_log/flight_log_analysis_statistical.md) - [ULog File Format](/dev_log/ulog_file_format.md) - [Log Encryption](dev_log/log_encryption.md) - [Advanced Topics](/advanced/index.md) diff --git a/en/dev_log/flight_log_analysis.md b/en/dev_log/flight_log_analysis.md index 8af6ae39ce13..b8e57d71fda9 100644 --- a/en/dev_log/flight_log_analysis.md +++ b/en/dev_log/flight_log_analysis.md @@ -5,3 +5,4 @@ Information about collecting and analysing flight logs is covered in: - [Flight Reporting](../getting_started/flight_reporting.md) - How to download a log and report/discuss issues about a flight. - [Log Analysis using Flight Review](../log/flight_review.md) - How to analyse many common vehicle problems using the [Flight Review](https://logs.px4.io/) online tool. - [Flight Log Analysis](../log/flight_log_analysis.md) - Introduction to flight analysis and links to a number of analysis tools. +- [Statistical Analysis](flight_log_analysis_statistical.md) - How to download public flight logs from Flight Review. diff --git a/en/dev_log/flight_log_analysis_statistical.md b/en/dev_log/flight_log_analysis_statistical.md new file mode 100644 index 000000000000..91cc6974b478 --- /dev/null +++ b/en/dev_log/flight_log_analysis_statistical.md @@ -0,0 +1,18 @@ +# Statistical Flight Log Analysis + +Flight Review hosts a large set of publicly available log files. +These can be used for example for statistical analysis or machine learning. + +The dataset contains a set of different: +- vehicle types +- PX4 versions (including development versions) +- boards +- flight modes + +The logs are accessible on [logs.px4.io/browse](https://logs.px4.io/browse) and are licensed under [CC-BY PX4](https://creativecommons.org/licenses/by/4.0/). + +Log files can also be downloaded in bulk with the [download_logs.py](https://github.com/PX4/flight_review/blob/main/app/download_logs.py) script. +The script allows to filter by different attributes (like flight modes, airframe name or type). Use the `--help` flag for a full list. +The newest logs will be downloaded first, and downloads can be interrupted and resumed later on. + +There are different parsing libraries, for example [pyulog](../log/flight_log_analysis.md#pyulog) can be used to read logs with Python.