diff --git a/utils/weather_sat.py b/utils/weather_sat.py index ee58b72..cdb3344 100644 --- a/utils/weather_sat.py +++ b/utils/weather_sat.py @@ -1,17 +1,14 @@ -"""Weather Satellite decoder for NOAA APT and Meteor LRPT imagery. - -Provides automated capture and decoding of weather satellite images using SatDump. - -Supported satellites: - - NOAA-15: 137.620 MHz (APT) [DEFUNCT - decommissioned Aug 2025] - - NOAA-18: 137.9125 MHz (APT) [DEFUNCT - decommissioned Jun 2025] - - NOAA-19: 137.100 MHz (APT) [DEFUNCT - decommissioned Aug 2025] - - Meteor-M2-3: 137.900 MHz (LRPT) - - Meteor-M2-4: 137.900 MHz (LRPT) - -Uses SatDump CLI for live SDR capture and decoding, with fallback to -rtl_fm capture for manual decoding when SatDump is unavailable. -""" +"""Weather satellite decoder focused on Meteor LRPT workflows. + +Provides automated capture and decoding of weather imagery using SatDump. + +Active satellites: + - Meteor-M2-3: 137.900 MHz (LRPT) + - Meteor-M2-4: 137.900 MHz (LRPT) + +Legacy NOAA APT entries remain in ``WEATHER_SATELLITES`` for compatibility +and historical metadata, but they are no longer active operational targets. +""" 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 = { 'NOAA-15': { 'name': 'NOAA 15', @@ -155,12 +153,12 @@ class CaptureProgress: return result -class WeatherSatDecoder: - """Weather satellite decoder using SatDump CLI. - - Manages live SDR capture and decoding of NOAA APT and Meteor LRPT - satellite transmissions. - """ +class WeatherSatDecoder: + """Weather satellite decoder using SatDump CLI. + + Manages live SDR capture and offline decode for the active Meteor LRPT + workflow, while preserving compatibility with older weather-sat metadata. + """ def __init__(self, output_dir: str | Path | None = None): self._process: subprocess.Popen | None = None @@ -253,7 +251,7 @@ class WeatherSatDecoder: No SDR hardware is required — SatDump runs in offline mode. 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 sample_rate: Sample rate of the recording in Hz @@ -370,7 +368,7 @@ class WeatherSatDecoder: """Start weather satellite capture and decode. 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 gain: SDR gain in dB sample_rate: Sample rate in Hz