https://github.com/alexander-barth/aptdecoder.jl

Decoder for the Automatic Picture Transmission protocol used by some weather satellites in Julia
https://github.com/alexander-barth/aptdecoder.jl

noaa-satellite satellite-data satellite-imagery software-defined-radio

Last synced: 6 months ago
JSON representation

Decoder for the Automatic Picture Transmission protocol used by some weather satellites in Julia

• Host: GitHub
• URL: https://github.com/alexander-barth/aptdecoder.jl
• Owner: Alexander-Barth
• License: mit
• Created: 2019-08-25T18:49:20.000Z (about 6 years ago)
• Default Branch: master
• Last Pushed: 2024-12-11T12:12:03.000Z (10 months ago)
• Last Synced: 2025-03-29T03:24:21.836Z (7 months ago)
• Topics: noaa-satellite, satellite-data, satellite-imagery, software-defined-radio
• Language: Julia
• Homepage:
• Size: 16.5 MB
• Stars: 12
• Watchers: 4
• Forks: 3
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

          
# Decoder for the Automatic Picture Transmission protocol

[![Build Status](https://github.com/Alexander-Barth/APTDecoder.jl/workflows/CI/badge.svg)](https://github.com/Alexander-Barth/APTDecoder.jl/actions)

[![Build Status Windows](https://ci.appveyor.com/api/projects/status/github/Alexander-Barth/APTDecoder.jl?branch=master&svg=true)](https://ci.appveyor.com/project/Alexander-Barth/aptdecoder-jl)

[![codecov](https://codecov.io/github/Alexander-Barth/APTDecoder.jl/graph/badge.svg?token=joW0OlUdLI)](https://codecov.io/github/Alexander-Barth/APTDecoder.jl)

[![documentation latest](https://img.shields.io/badge/docs-latest-blue.svg)](https://alexander-barth.github.io/APTDecoder.jl/latest/)

This packages allows to decode data from the NOAA weather satellites NOAA 15, NOAA 18 and NOAA 19.

All you need is a (relatively inexpensive) software-defined radio and antenna for 137 MHz (following for example these [instructions](https://www.instructables.com/id/NOAA-Satellite-Signals-with-a-PVC-QFH-Antenna-and-/)) to receive data from these weather satellites.

The data is first recorded using a software like GQRX (https://noaa-apt.mbernardi.com.ar/guide.html).

## Installation of APDDecoder.jl

* Install [julia](https://julialang.org/downloads/)

* Launch julia and run to following commands to install `APTDecoder`:

```julia

using Pkg

Pkg.develop(PackageSpec(url="https://github.com/Alexander-Barth/APTDecoder.jl"))

```

* Make plots of a decoded and georefenced data stream with the following Julia command:

```julia

import APTDecoder

APTDecoder.makeplots("gqrx_20190825_182745_137620000.wav","NOAA 15")

```

The first argument of `APTDecoder.makeplots` is the wav file which should include the date and time in UTC (which is the default for GQRX) and the name of the satellite, e.g. "NOAA 15", "NOAA 18" or "NOAA 19".

This produces the following images:

![raw](examples/gqrx_20190825_182745_137620000_raw.png "raw")

This is the raw data. Channel a is on the right and channel b on the left. Note that channel b is just switching the wave-length during the capture. In part of Europe the sun went already down.

![channel A](examples/gqrx_20190825_182745_137620000_channel_a.png "A")

![channel B](examples/gqrx_20190825_182745_137620000_channel_b.png "B")

# Alternatives

* [NOAA-APT](https://github.com/martinber/noaa-apt) with some [excellent documentation](https://noaa-apt.mbernardi.com.ar/guide.html)

* [apt-decoder](https://github.com/zacstewart/apt-decoder)

* [aptdec](https://github.com/csete/aptdec)

* [DirectDemod](https://github.com/aerospaceresearch/DirectDemod)

* [apt137](https://github.com/pietern/apt137)

* [APT3000](https://github.com/ThatcherC/APT3000)

* ...

# Credits

Many thanks to the authors of the [SatelliteToolbox.jl](https://github.com/JuliaSpace/SatelliteToolbox.jl) and the [DSP.jl](https://github.com/JuliaDSP/DSP.jl). These packages are used to predict the satellite orbit and to extract the APT signal.