Skip to content

Commit

Permalink
update README
Browse files Browse the repository at this point in the history
  • Loading branch information
zacharyburnett committed Jan 17, 2024
1 parent 64adcdd commit fcee305
Showing 1 changed file with 45 additions and 41 deletions.
86 changes: 45 additions & 41 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -20,56 +20,60 @@ The program is designed to be run during a flight and display information in a t
- plot variables such as altitude and ascent rate over time
- estimate landing time and location

## Installation
## Instructions

[Download an executable (`packetraven_Windows.exe`, `packetraven_macOS`, or `packetraven_Linux`) from the latest release.](https://github.com/UMDBPP/PacketRaven/releases)
1. Write a YAML configuration file from [the instructions](https://packetraven.readthedocs.io/en/latest/configuration.html), or use the following example:
```yaml
# example.yaml
connections:
text:
- path: ~/raw_aprs_frames.txt
callsigns:
- W3EAX-8
- path: http://bpp.umd.edu/archives/Launches/NS-111_2022_07_31/APRS/W3EAX-8%20raw.txt
```
> **Note**\
> Alternatively, you may compile the program yourself:
> ```shell
> git clone https://github.com/UMDBPP/PacketRaven.git
> cd packetraven
> cargo build --release
> ls target/release/packetraven*
> ```
2. Download an executable from the [Releases page](https://github.com/UMDBPP/PacketRaven/releases).
## Usage
3. Open a terminal window.
### `start`
4. Run the executable you downloaded with the `start` subcommand and a path to your configuration file:
```shell
cd Downloads
packetraven_Windows.exe start example.yaml
```

Run your executable from the terminal with the `start` subcommand and the path to your configuration file:
```shell
./packetraven_Windows.exe start examples/example_1.yaml
```
[Instructions for creating a configuration file can be found in the documentation](https://packetraven.readthedocs.io/en/latest/configuration.html).
Example configurations can be found in the `examples/` folder:

```yaml
connections:
text:
- path: ~/raw_aprs_frames.txt
callsigns:
- W3EAX-8
- path: http://bpp.umd.edu/archives/Launches/NS-111_2022_07_31/APRS/W3EAX-8%20raw.txt
```
5. You should now see the user interface. Resize your terminal window or decrease the font size as needed.
![starting screen](https://github.com/UMDBPP/PacketRaven/blob/main/docs/images/example1_log.png)

You should then see the user interface. Resize your terminal window, or decrease the font size, as needed.
![starting screen](https://github.com/UMDBPP/PacketRaven/blob/main/docs/images/example1_log.png)
6. The left and right arrow keys (or `Tab` and `Shift+Tab`) cycle through active tabs, and the up and down arrow keys change the current plot (or scroll through log messages).
![altitude telemetry plotted over time](https://github.com/UMDBPP/PacketRaven/blob/main/docs/images/example1_altitude.png)

The left and right arrow keys (or `Tab` and `Shift+Tab`) cycle through active tabs,
and the up and down arrow keys change the current plot (or scroll through log messages).
![altitude telemetry plotted over time](https://github.com/UMDBPP/PacketRaven/blob/main/docs/images/example1_altitude.png)
7. To quit, press `q` or `Esc`.

To quit, press `q` or `Esc`.
## retrieve predictions

### `predict`

You can run the `predict` subcommand to retrieve a balloon flight prediction from a Tawhiri API:
Run `packetraven predict` to retrieve a balloon flight prediction:

```shell
./packetraven_Windows.exe predict "2023-08-16T10:00:00" -- -79 39 5 30000 9
packetraven_Windows.exe predict "2023-08-16T10:00:00" -- -79 39 5 30000 9
```
```shell
retrieve a balloon prediction from the given API - negative values must be preceded with a `-- `, i.e. `-- -79`

Usage: packetraven predict [OPTIONS] <TIME> <LONGITUDE> <LATITUDE> <ASCENT_RATE> <BURST_ALTITUDE> <SEA_LEVEL_DESCENT_RATE>

Arguments:
<TIME> start time i.e. `2023-08-16T10:00:00`
<LONGITUDE> start longitude
<LATITUDE> start latitude
<ASCENT_RATE> expected average ascent rate
<BURST_ALTITUDE> expected burst altitude
<SEA_LEVEL_DESCENT_RATE> descent rate at sea level

Options:
-a, --altitude <ALTITUDE> start altitude
--float-altitude <FLOAT_ALTITUDE> desired float altitude
--float-duration <FLOAT_DURATION> desired float duration in seconds
-h, --help Print help
```

> **Note**\
> Negative values must be prepended with `-- `, e.g. `-- -79`.:w

0 comments on commit fcee305

Please sign in to comment.