You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
Liam 953e721745
Add contributing guidelines, subject to change
4 vuotta sitten
cmake Early Windows support! 4 vuotta sitten
palettes Improve MCIR, improve map alignment and remove useless palettes 4 vuotta sitten
util Fix img2pal.py and improve error messages 4 vuotta sitten
.gitignore Early Windows support! 4 vuotta sitten
CMakeLists.txt Initial CMake support 4 vuotta sitten
CONTRIBUTING.md Add contributing guidelines, subject to change 4 vuotta sitten
LICENSE I don't really know what happened, but I can think of these off the top of my head 5 vuotta sitten
Makefile Actaully disable that warning, fix a bug 4 vuotta sitten
README.md Clarified stackability of output types 4 vuotta sitten
build_windows.sh Early Windows support! 4 vuotta sitten
color.c Use WXtoImg precipitation palette 4 vuotta sitten
common.h Add map offset argument, change southbound to northbound 4 vuotta sitten
dsp.c Improve MCIR, improve map alignment and remove useless palettes 4 vuotta sitten
filter.c Switch to tabs 4 vuotta sitten
filter.h Fix temperature calibration & lots of small changes 4 vuotta sitten
filtercoeff.h Update copyright year 4 vuotta sitten
image.c Add map offset argument, change southbound to northbound 4 vuotta sitten
main.c Add map offset argument, change southbound to northbound 4 vuotta sitten
median.c Switch to tabs 4 vuotta sitten
offsets.h Fix temperature calibration & lots of small changes 4 vuotta sitten
pngio.c Add map offset argument, change southbound to northbound 4 vuotta sitten
reg.c Switch to tabs 4 vuotta sitten
satcal.h Switch to tabs 4 vuotta sitten
textlogo.png A few changes here and there. 5 vuotta sitten

README.md

Aptdec logo

Copyright (c) 2004-2009 Thierry Leconte (F4DWV), Xerbo (xerbo@protonmail.com) 2019-2020

Introduction

Aptdec is a FOSS program that decodes images transmitted by NOAA weather satellites. These satellites transmit constantly (among other things) medium resolution (4km/px) images of the earth over a analog mode called APT. These transmissions can easily be received with a cheap SDR and simple antenna. Then the transmission can be decoded in narrow FM mode.

Aptdec can turn the audio recordings into PNG images and generate images such as:

  • Raw image: both channels with full telemetry included
  • Individual channel: one of the channels form the image
  • Temperature image: a temperature compensated image derived from the IR channel
  • Palleted image: a image where the color is derived from a palette (false color, etc)
  • MCIR: a false color that uses a underlay map for color

The input audio format can be anything supported by libsndfile (although only tested with WAV and FLAC). Sample rate doesn’t matter, although lower samples rates will process faster.

Quick start

sudo apt install git gcc libsndfile-dev libpng-dev
git clone https://github.com/Xerbo/aptdec.git && cd aptdec
make

Examples

To create an image from gqrx_20200527_115730_137914960.wav (output filename will be gqrx_20200527_115730_137914960-r.png)

./aptdec gqrx_20200527_115730_137914960.wav

To manually set the output filename

./aptdec -o image.png gqrx_20200527_115730_137914960.wav

Decode all WAV files in the current directory and put them in images

mkdir images && ./aptdec -d images *.wav

Apply a denoise filter (see Post-Processing Effects for a full list of post-processing effects)

./aptdec -e d gqrx_20200527_115730_137914960.wav

Create a temperature compensated image for NOAA 18

./aptdec -i t -s 18 gqrx_20200527_115730_137914960.wav

Apply a falsecolor palette

./aptdec -i p -p palettes/WXtoImg-N18-HVC.png gqrx_20200527_115730_137914960.wav

Usage

Arguments

-i [r|a|b|t|m|p] Output type (stackable*)
-e [t|h|l|d|p|f] Effects (stackable)
-o <path>        Output filename
-d <path>        Destination directory
-s (15-19)       Satellite number
-m <path>        Path to WXtoImg map
-p <path>        Path to palette
-r               Realtime decode
-g               Gamma adjustment (1.0 = off)
-k               Map offset (in px, default: 0)

* Should work with all combinations, but temperature needs to be done last as it calibrates the buffer

Image output types

  • r: Raw Image
  • a: Channel A
  • b: Channel B
  • t: Temperature
  • m: MCIR (Map Color InfraRed)
  • p: Palleted

Post-Processing Effects

  • t: Crop telemetry (only effects raw image)
  • h: Histogram equalise
  • l: Linear equalise
  • d: Denoise
  • p: Precipitation overlay
  • f: Flip image (for northbound passes)
  • c: Crop noise from ends of image

Realtime decoding

Aptdec even supports decoding in realtime. The following decodes the audio coming from the audio device pulseaudio alsa_output.pci-0000_00_1b.0.analog-stereo

mkfifo /tmp/aptaudio
aptdec /tmp/aptaudio
sox -t pulseaudio alsa_output.pci-0000_00_1b.0.analog-stereo.monitor -c 1 -t wav /tmp/aptaudio

To stop the decode and calibrate the image simply kill the sox process.

Palette formatting

Palettes are just simple PNG images, 256x256px in size with 24bit RGB color. The X axis represents the value of Channel A and the Y axis the value of Channel B.

Compiling with cmake

Thanks to the help of Aang23 aptdec is moving towards cmake + cpack for builds.

To use cmake to build instead of GNU automake:

mkdir build && cd build
cmake ..
make

Since cmake is now being used for building, windows support has come. You can build for windows with the build_windows.sh script, you will need wine and mingw64 installed:

./build_windows.sh

Further Reading

User’s Guide for Building and Operating Environmental Satellite Receiving Stations

NOAA KLM coefficients

NOAA Satellite specifications and more information

License

See LICENSE