Não pode escolher mais do que 25 tópicos Os tópicos devem começar com uma letra ou um número, podem incluir traços ('-') e podem ter até 35 caracteres.
 
 
 
 
 
Xerbo 66b8dd026e
Fix memory leak and move state entirely into aptdec_t
há 1 ano
.github Better naming, but valid this time há 1 ano
aptdec-cli Fix memory leak and move state entirely into aptdec_t há 1 ano
cmake Better naming há 1 ano
libaptdec Fix memory leak and move state entirely into aptdec_t há 1 ano
luts Version 2.0.0 work há 1 ano
util Version 2.0.0 work há 1 ano
.clang-format Format codebase há 2 anos
.gitignore ARM builds há 1 ano
.gitmodules Version 2.0.0 work há 1 ano
CMakeLists.txt ARM builds há 1 ano
CONTRIBUTING.md Version 2.0.0 work há 1 ano
LICENSE I don't really know what happened, but I can think of these off the top of my head há 4 anos
README.md Fix MSVC build há 1 ano
UPGRADE_GUIDE.md Better naming há 1 ano
build_arm.sh ARM builds há 1 ano
build_windows.bat MSVC build in GitHub actions há 1 ano
build_windows.sh Fix MSVC build há 1 ano
textlogo.png A few changes here and there. há 5 anos

README.md

Aptdec Logo

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

Build

Introduction

Aptdec is a FOSS library/program that decodes images transmitted by the NOAA POES 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, the transmission can be demodulated in narrow FM mode.

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

  • Raw image: both channels (including telemetry)
  • Individual channel: one channel (including telemetry)
  • Visible image: a calibrated visible image of either channel 1 or 2
  • Thermal image: a calibrated thermal image from channel B
  • LUT image: a image where the color is derived from a LUT (used for false color, etc)

The input audio format can be anything supported by libsndfile (although only tested with WAV, FLAC and Ogg Vorbis). While sample rate doesn’t matter, it is recommended to use 16640 Hz (4x oversampling).

Quick start

Grab a release from Releases or compile from source:

sudo apt install cmake git gcc libsndfile-dev libpng-dev
git clone --recursive https://github.com/Xerbo/aptdec.git && cd aptdec
cmake -B build
cmake --build build
# Resulting binary is build/aptdec-cli

In place builds are not supported.

Examples

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

aptdec-cli gqrx_20200527_115730_137914960.wav

To manually specify the output filename

aptdec-cli -o image.png gqrx_20200527_115730_137914960.wav

Decode all WAV files in the current directory:

aptdec-cli *.wav

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

aptdec-cli -e denoise gqrx_20200527_115730_137914960.wav

Create a calibrated IR image from NOAA 18

aptdec-cli -i thermal gqrx_20200527_115730_137914960.wav

Apply a falsecolor LUT

aptdec-cli -i lut -l luts/WXtoImg-N18-HVC.png gqrx_20200527_115730_137914960.wav

Usage

Arguments

-h, --help                show this help message and exit
-i, --image=<str>         set output image type (see the README for a list)
-e, --effect=<str>        add an effect (see the README for a list)
-s, --satellite=<int>     satellite ID, must be either NORAD or 15/18/19
-l, --lut=<str>           path to a LUT
-o, --output=<str>        path of output image
-r, --realtime            decode in realtime

Image output types

  • raw: Raw Image
  • a: Channel A (including telemetry)
  • b: Channel B (including telemetry)
  • thermal: Calibrated thermal (MWIR/LWIR) image
  • visible: calibrated visible/NIR image
  • lut: LUT image, see also -l/--lut

Post-Processing Effects

  • strip: Strip telemetry (only effects raw/a/b images)
  • equalize: Histogram equalise
  • stretch: Linear equalise
  • denoise: Denoise
  • precipitation: Precipitation overlay
  • flip: Flip image (for northbound passes)
  • crop: Crop noise from ends of image

Realtime decoding

Aptdec supports decoding in realtime. The following captures and decodes audio from the pipewire interface:

arecord -f cd -D pipewire | aptdec -r -

or directly from an SDR:

rtl_fm -f 137.1M -g 40 -s 40k | sox -t raw -r 40k -e signed-integer -b 16 - -t wav - | aptdec -r -

Image data will be streamed to CURRENT_TIME.png (deleted when finished). To stop the decode and normalize the image simply Ctrl+C the process.

LUT format

LUT’s are just plain 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.

Building for Windows

You can cross build for Windows from Linux (recommended) using with the following commands:

sudo apt install wget cmake make mingw-w64 git unzip
./build_windows.sh

To build natively on Windows using MSVC, you will need: git, ninja and cmake. Then run:

./build_windows.bat

If you only want to build libaptdec, libpng and libsndfile aren’t needed.

References

License

See LICENSE