mirror of
https://github.com/okalachev/flix.git
synced 2025-07-27 17:49:33 +00:00
73 lines
2.3 KiB
Markdown
73 lines
2.3 KiB
Markdown
# Log analysis
|
|
|
|
Flix quadcopter uses RAM to store flight log data. The default log capacity is 10 seconds at 100 Hz. This configuration can be adjusted in the `log.ino` file.
|
|
|
|
To perform log analysis, you need to download the log right after the flight without powering off the drone. Then you can use several tools to analyze the log data.
|
|
|
|
## Log download
|
|
|
|
To download the log, connect the ESP32 using USB right after the flight and run the following command:
|
|
|
|
```bash
|
|
make log
|
|
```
|
|
|
|
Logs are stored in `tools/log/*.csv` files.
|
|
|
|
## Analysis
|
|
|
|
### PlotJuggler
|
|
|
|
The recommended tool for log analysis is PlotJuggler.
|
|
|
|
<img src="img/plotjuggler.png" width="500">
|
|
|
|
1. Install PlotJuggler using the [official instructions](https://github.com/facontidavide/PlotJuggler?tab=readme-ov-file#installation).
|
|
|
|
2. Run PlotJuggler and drag'n'drop the downloaded log file there. Choose `t` column to be used as X axis.
|
|
|
|
You can open the most recent downloaded file using the command:
|
|
|
|
```bash
|
|
make plot
|
|
```
|
|
|
|
You can perform both log download and run PlotJuggler in one command:
|
|
|
|
```bash
|
|
make log plot
|
|
```
|
|
|
|
### FlightPlot
|
|
|
|
FlightPlot is a powerful tool for analyzing logs in [ULog format](https://docs.px4.io/main/en/dev_log/ulog_file_format.html). This format is used in PX4 and ArduPilot flight software.
|
|
|
|
<img src="img/flightplot.png" width="500">
|
|
|
|
1. [Install FlightPlot](https://github.com/PX4/FlightPlot).
|
|
2. Flix repository contains a tool for converting CSV logs to ULog format. Build the tool using [the instructions](../tools/csv_to_ulog/README.md) and convert the log you want to analyze.
|
|
3. Run FlightPlot and drag'n'drop the converted ULog-file there.
|
|
|
|
### Foxglove Studio
|
|
|
|
Foxglove is a tool for visualizing and analyzing robotics data with very rich functionality. It can import various formats, but mainly focuses on its own format, called [MCAP](https://mcap.dev).
|
|
|
|
<img src="img/foxglove.png" width="500">
|
|
|
|
1. Install Foxglove Studio from the [official website](https://foxglove.dev/download).
|
|
|
|
2. Flix repository contains a tool for converting CSV logs to MCAP format. First, install its dependencies:
|
|
|
|
```bash
|
|
cd tools
|
|
pip install -r requirements.txt
|
|
```
|
|
|
|
3. Convert the log you want to analyze:
|
|
|
|
```bash
|
|
csv_to_mcap.py log_file.csv
|
|
```
|
|
|
|
4. Open the log in Foxglove Studio using *Open local file* command.
|