Avionics Data Decoding & Visualisation

Setup

Prerequisites

• Python 3.13 or higher

Setup Environment

On macOS/Linux

1. Create a virtual environment:

   python3 -m venv .venv

2. Activate the virtual environment:

   source .venv/bin/activate

3. Install dependencies:

   pip install -r requirements.txt

4. Install tkinter if needed on macOS:

   brew install python-tk

On Windows

Note: your python executable may be py, py3, or python3

1. Create a virtual environment:

   python -m venv .venv

2. Activate the virtual environment:

   .venv\Scripts\activate

3. Install dependencies:

   pip install -r requirements.txt

Usage

GUI

Run the Graphical Interface for visualising data and optionally exporting as CSV.

python avionics_data.py

CLI

Generate the CSV on the command line or with a script.

python avionics_data.py --csv

Or use the binary conversion script directly: python src/read_data.py example.bin