aptdec/README

ATPDEC README (Thierry Leconte 2003)

DESCRIPTION

Atpdec is an open source program that decodes images transmitted by POES 
NOAA weather satellite series.
These satellites transmit continuously, among other things, medium 
resolution images of the earth on 137Mhz.
These transmissions could be easily received with an inexpensive antenna 
and dedicated receiver.
Output from such a receiver, is an audio signal that could be recorded 
into a soundfile with any soundcard.

Atpdec will convert these sounfiles into .png images.

For each soundfile up to 6 images could be generated :

    1. Raw image : contains the 2 transmitted channel images + telemetry 
and synchro pulses.
    2. Calibrated channel A image
    3. Calibrated channel B image
    4. Temperature compensed I.R image
    5. False color image
    6. pixel distribution statistique (usefull for false color cmap debugging).

Input soundfiles must be mono signal sampled at 11025 Hz.
Atpdec use libsnd to read soundfile, so any sound file format supported by libsnd
could be read.(Only tested with .wav file).

COMPILATION

Atpdec is written in plain standart C and must be very portable.
It was only tested on Linux Suse 8.2, but must work on any Unix platform.
Just adapt the Makefile and type make (sorry no configure). 

atpdec use libsnd, libpng and libm.
snd.h and png.h header must be present on your system.
If they are not on standard path, edit the include path in the Makefile.

USAGE

see atpdec.1 man page.