Refresh weather decoder docs for Meteor flow

This commit is contained in:
James Smith
2026-03-18 22:30:54 +00:00
parent 6dc0936d6d
commit d0402f4746
+21 -23
View File
@@ -1,17 +1,14 @@
"""Weather Satellite decoder for NOAA APT and Meteor LRPT imagery. """Weather satellite decoder focused on Meteor LRPT workflows.
Provides automated capture and decoding of weather satellite images using SatDump. Provides automated capture and decoding of weather imagery using SatDump.
Supported satellites: Active satellites:
- NOAA-15: 137.620 MHz (APT) [DEFUNCT - decommissioned Aug 2025] - Meteor-M2-3: 137.900 MHz (LRPT)
- NOAA-18: 137.9125 MHz (APT) [DEFUNCT - decommissioned Jun 2025] - Meteor-M2-4: 137.900 MHz (LRPT)
- NOAA-19: 137.100 MHz (APT) [DEFUNCT - decommissioned Aug 2025]
- Meteor-M2-3: 137.900 MHz (LRPT) Legacy NOAA APT entries remain in ``WEATHER_SATELLITES`` for compatibility
- Meteor-M2-4: 137.900 MHz (LRPT) and historical metadata, but they are no longer active operational targets.
"""
Uses SatDump CLI for live SDR capture and decoding, with fallback to
rtl_fm capture for manual decoding when SatDump is unavailable.
"""
from __future__ import annotations from __future__ import annotations
@@ -41,7 +38,8 @@ ALLOWED_OFFLINE_INPUT_DIRS = (
) )
# Weather satellite definitions # Weather satellite definitions.
# NOAA APT entries are retained as inactive compatibility metadata.
WEATHER_SATELLITES = { WEATHER_SATELLITES = {
'NOAA-15': { 'NOAA-15': {
'name': 'NOAA 15', 'name': 'NOAA 15',
@@ -155,12 +153,12 @@ class CaptureProgress:
return result return result
class WeatherSatDecoder: class WeatherSatDecoder:
"""Weather satellite decoder using SatDump CLI. """Weather satellite decoder using SatDump CLI.
Manages live SDR capture and decoding of NOAA APT and Meteor LRPT Manages live SDR capture and offline decode for the active Meteor LRPT
satellite transmissions. workflow, while preserving compatibility with older weather-sat metadata.
""" """
def __init__(self, output_dir: str | Path | None = None): def __init__(self, output_dir: str | Path | None = None):
self._process: subprocess.Popen | None = None self._process: subprocess.Popen | None = None
@@ -253,7 +251,7 @@ class WeatherSatDecoder:
No SDR hardware is required — SatDump runs in offline mode. No SDR hardware is required — SatDump runs in offline mode.
Args: Args:
satellite: Satellite key (e.g. 'NOAA-18', 'METEOR-M2-3') satellite: Satellite key (for example ``'METEOR-M2-3'``)
input_file: Path to IQ baseband or WAV audio file input_file: Path to IQ baseband or WAV audio file
sample_rate: Sample rate of the recording in Hz sample_rate: Sample rate of the recording in Hz
@@ -370,7 +368,7 @@ class WeatherSatDecoder:
"""Start weather satellite capture and decode. """Start weather satellite capture and decode.
Args: Args:
satellite: Satellite key (e.g. 'NOAA-18', 'METEOR-M2-3') satellite: Satellite key (for example ``'METEOR-M2-3'``)
device_index: RTL-SDR device index device_index: RTL-SDR device index
gain: SDR gain in dB gain: SDR gain in dB
sample_rate: Sample rate in Hz sample_rate: Sample rate in Hz