Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/pat8901/aptdemod
Lightweight Automatic Picture Transmission (APT) radio signal decoder for NOAA weather satellites
https://github.com/pat8901/aptdemod
apt decoder noaa satellite weather
Last synced: 12 days ago
JSON representation
Lightweight Automatic Picture Transmission (APT) radio signal decoder for NOAA weather satellites
- Host: GitHub
- URL: https://github.com/pat8901/aptdemod
- Owner: pat8901
- License: gpl-3.0
- Created: 2024-07-05T06:23:08.000Z (6 months ago)
- Default Branch: master
- Last Pushed: 2024-10-23T03:10:58.000Z (3 months ago)
- Last Synced: 2024-10-23T05:46:56.676Z (3 months ago)
- Topics: apt, decoder, noaa, satellite, weather
- Language: C
- Homepage:
- Size: 119 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 11
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Aptdemod
Aptdemod is a C program designed to demodulate Automatic Picture Transmission (APT) radio signals from NOAA satellites stored in 11025hz wav audio files. By processing the APT signals, the program extracts and reconstructs the image data outputting a weather satellite image. This provides weather visualizations from satellite transmissions. Ideal for amateur radio enthusiasts and weather monitoring applications, this decoder leverages signal processing techniques to deliver accurate and detailed images.
* Aptdemod audio input is limited to 11025hz wav files. Further compatibility is planned in future updates!
### What is APT
The Automatic Picture Transmission (APT) protocol is an analog image transmission system developed for use on weather satellites. It was introduced in the 1960s. A user station anywhere in the world can receive local data at least twice a day from each satellite as it passes nearly overhead.
For more details, please see the [additional information](https://en.wikipedia.org/wiki/Automatic_picture_transmission).
# Building / Installing
This program was developed for Linux. Additional platform compatibility will be implemented in future updates.
## Linux
Aptdemod has only been tested on Debian based distros.
In the future this will change, but in the mean time we recommend using Debian based distros.
### Dependencies
Install Dependencies - Debian, Ubuntu, and other Debian-based distros
```bash
sudo apt install git cmake build-essential libfftw3-dev libsndfile1-dev
```
Install Dependencies - Red-Hat-based systems
```bash
# TBA
```
Install Dependencies - Arch-based systems
```bash
# TBA
```
Install Dependencies - Gentoo
```bash
# TBA
```
### Build aptdemod
```bash
# Clone aptdemod repo
git clone https://github.com/pat8901/aptdemod.git
cd aptdemod/build
# Generate makefile
cmake ../
# Build aptdemod
make
# Run
./aptdemod
```
# Quick Start
* There are a few audio samples that can be used when testing the program for the first time. These can be found in the cloned repo under "aptdemod/documentation/samples/audio".
* When running the program just pass the file path for one of the samples as an argument.
* Aptdemod will output a bmp image in the same directory from which the program is called.
### Usage
```bash
aptdemod [options] [arguments]
```
### Available Options/Arguments
```
-h --help: Displays help menu, providing usage and miscellaneous information.
-a --about: Displays details about the program, including license information.
-v --verbose: Provide additional program information as it runs.
-f [file] --file [file]: This option is followed by a file path argument which tells the program what audio file to process.
```
### Sample command
```bash
./aptdemod -f /path/to/audio/file/audio.wav
```
# How to Profile Program
* ``gprof`` is used to profile this program