signalstats1090 0.5.0

Signal statistics dashboard for Mode-S/ADS-B signals from dump1090

dump1090 Real-Time Signal Statistics

This project provides a web application for real-time monitoring of ADS-B messages using dump1090. The application consists of a FastAPI backend and a frontend that displays various statistics in real-time using Chart.js.

Features

• Message Rate Statistics: Computes and displays message rates over different intervals (5s, 15s, 30s, 60s, 300s).
• Signal Strength Statistics: Computes and displays minimum, maximum, and average signal strength over 30 seconds.
• Distance Statistics: Computes and displays minimum, maximum, and percentile distances over 30 seconds.
• Coverage Statistics: Displays coverage statistics in a radar chart, showing the distribution of messages by distance and bearing.
• RSSI/Distance Ratio: Displays the ratio of RSSI to distance for each bearing segment.

Quick Start

Prerequisites

• dump1090 running on the same machine or accessible via network.
• Python 3.10+ installed on your machine. Note: Raspbian typically comes with Python pre-installed.

Installation

1. Install Python: If you don't have Python installed, download and install it from python.org.

2. Install the application: Open a terminal or command prompt and run:

   pip install signalstats1090
   

   This will install the signalstats1090 command-line tool, which you can use to run the backend server.

3. Run the application: Execute the following command:

   signalstats1090 run --antenna-lat <antenna_lat> --antenna-lon <antenna_lon>
   

   The --antenna-lat and --antenna-lon arguments are required. You can find the latitude and longitude of your antenna using Google Maps or similar services.

Command Line Arguments

The script supports the following command line arguments:

• --host: Host to run the web server on (default: 0.0.0.0).
• --port: Port to run the web server on (default: 8000).
• --antenna-lat: Antenna latitude (required for running the server).
• --antenna-lon: Antenna longitude (required for running the server).
• --dump1090-host: Host running dump1090 (default: localhost).
• --dump1090-port: Port for dump1090 (default: 30005).

Installation as a Service

You can install the program as a service using the provided setup script:

1. Download the setup script:

   wget -qO- https://raw.githubusercontent.com/clemensv/signalstats1090/main/setup.sh > ~/signalstats1090_setup.sh
   chmod +x ~/signalstats1090_setup.sh
   

2. Run the setup script with the required arguments:

   ~/signalstats1090_setup.sh install --host <host> --port <port> --antenna-lat <antenna_lat> --antenna-lon <antenna_lon> --dump1090-host <dump1090_host> --dump1090-port <dump1090_port>
   

   The --antenna-lat and --antenna-lon arguments are required.

Arguments for the setup script

• --host: Host to run the web server on (default: 0.0.0.0).
• --port: Port to run the web server on (default: 8000).
• --antenna-lat: Latitude of the antenna (required).
• --antenna-lon: Longitude of the antenna (required).
• --dump1090-host: Host running dump1090 (default: localhost).
• --dump1090-port: Port for dump1090 (default: 30005).

Updating the Service

To update the service to the latest version, run the setup script with the update option:

~/signalstats1090_setup.sh update

This will upgrade the package to the latest version in the service account context and restart the service.

Charts

• Message Rate Chart: Displays message rates over different intervals (5s, 15s, 30s, 60s, 300s).
• Signal Strength Chart: Displays minimum, average, and maximum signal strength over 30 seconds.
• Distance Chart: Displays minimum, maximum, and percentile distances over 30 seconds.
• Distance Histogram Chart: Displays the count of position readings in 30km buckets (up to 300km).
• Coverage Chart: Displays coverage statistics in a radar chart, showing the distribution of messages by distance and bearing.
• RSSI/Distance Ratio Chart: Displays the ratio of RSSI to distance for each bearing segment.

Viewing the Frontend

To view the frontend, open a web browser and navigate to:

http://localhost:8000

or whatever host and port you specified when running the server.

License

This project is licensed under the MIT License.

© 2025 Clemens Vasters. All rights reserved.