PacketRaven

PacketRaven is a dashboard built to track high-altitude balloon flights from their location telemetry.

pip install packetraven

Installation

install Python - https://www.python.org/downloads/
install packetraven with pip:
```
pip install packetraven
```

NOTE

Alternatively, you may download the source code and build from source:

git clone https://github.com/UMDBPP/PacketRaven.git
cd packetraven
pip install .

Usage

PacketRaven reads a configuration file to determine which connections to set up, how to parse your packets, which callsigns to filter, etc.

packetraven /path/to/config.yaml

The configuration is in YAML format. Here is an example configuration:

# config.yaml

callsigns:
    - W3EAX-9
    - W3EAX-11
    - W3EAX-12

time:
    start: 2022-03-05
    end: 2022-03-06
    interval: 30

output:
    filename: ns110.geojson

log:
    filename: ns110.log

packets:
    aprs_fi:
        api_key: 123456.abcdefhijklmnop
    text:
        locations:
            - /dev/ttyUSB0
            - ~/packets.txt
    database:
        hostname: localhost
        port: 5432
        database: nearspace
        table: ns110
        username: user1
        password: password1
        tunnel:
            hostname: bpp.umd.edu
            port: 22
            username: user1
            password: password2

prediction:
    start:
        location:
            - -78.4987
            - 40.0157
        time: 2022-03-05 10:36:00
    profile:
        ascent_rate: 6.5
        burst_altitude: 25000
        sea_level_descent_rate: 9
    output:
        filename: ns110_prediction.geojson

start the graphical user interface (GUI)

to start the GUI, add --gui to any packetraven command

packetraven --gui
packetraven config.yaml --gui

Examples

listen to a TNC sending raw APRS strings over USB port COM4

# config.yaml

packets:
    text:
        locations:
            - COM4

you can also set the location to auto to try the first open USB port

# config.yaml

packets:
    text:
        locations:
            - auto

listen to APRS.fi, watching specific callsigns

you need an API key to connect to APRS.fi; you can get one from https://aprs.fi/page/api

# config.yaml

callsigns:
    - W3EAX-8
    - W3EAX-14

packets:
    aprs_fi:
        api_key: 123456.abcdefhijklmnop

listen to a PostGIS database table

# config.yaml

callsigns:
    - W3EAX-8
    - W3EAX-14

packets:
    database:
        hostname: bpp.umd.edu
        port: 5432
        database: nearspace
        table: ns110
        username: user1
        password: password1

watch text file(s) for new lines containing raw APRS strings

# config.yaml

packets:
    text:
        locations:
            - http://bpp.umd.edu/archives/Launches/NS-95_2020-11-07/APRS/W3EAX-10/W3EAX-10_raw_NS95.txt
            - http://bpp.umd.edu/archives/Launches/NS-95_2020-11-07/APRS/W3EAX-11/W3EAX-11_raw_NS95.txt

listen to a TNC on COM3, watching specific callsigns, and synchronize new packets with a database table via SSH tunnel

# config.yaml

callsigns:
    - W3EAX-8
    - W3EAX-14

packets:
    text:
        locations:
            - COM3
    database:
        hostname: localhost
        port: 5432
        database: nearspace
        table: ns110
        username: user1
        password: password1
        tunnel:
            hostname: bpp.umd.edu
            port: 22
            username: user1
            password: password2

Release files for packetraven 2.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for packetraven 2.1.0
File	Interpreter	ABI	Platform	Reset
packetraven-2.1.0-py3-none-any.whl 74.8 kB Jun 30, 2022	Python 3	none	any	Details

Release files / packetraven-2.1.0-py3-none-any.whl

Download URL	packetraven-2.1.0-py3-none-any.whl
Size	74.8 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`68c9abf2837d0ca76ffb6bf5545667f8041e77aa0ae4a9deb90ba451e0956e1e`
BLAKE2b-256 checksum How to use checksums	`af9f1889d1e2e315f79ad7c41f8d253b701fb2d3e1b8842cb4a6144456aeb850`
Upload date	Jun 30, 2022
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/4.0.1 CPython/3.9.13`