Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
Expose Spain in the automatic CLI profile (#369)
Cinna Davis6b0c4b06f9a3
diff --git a/README.md b/README.mdindex 926a7f3..f0e6c3a 100644--- a/README.md+++ b/README.md@@ -30,7 +30,7 @@ Colsto did not release the original tools or source code from his [aircraft Dopp| **Automatic acoustic discovery** | Scans an entire recording for moving frequency tracks and groups related harmonics, without manually selecting event windows or frequency bands. || **Historical aircraft data** | Acquires and indexes ADSB.lol flight archives; caches reusable trajectory, terrain, and geoid inputs. || **Location search** | Compares predicted Doppler and sound-arrival patterns across candidate receiver locations, including evidence from multiple independent flyovers. |-| **Geographic profiles** | Search profiles for the contiguous United States and Germany, with optional user-provided regional bounds. |+| **Geographic profiles** | Search profiles for the contiguous United States, Germany, and Spain, with optional user-provided regional bounds. || **Local browser application** | Recording uploads, persistent analysis jobs, inspectable results, progress monitoring, and supported resume/cancellation workflows. || **Research and reproducibility** | Configured measurement/replay commands, documented experiments, diagnostic artifacts, and decision rules for unresolved searches. |@@ -72,7 +72,7 @@ To check progress after the job ID is printed:.venv/bin/dopplergeist job JOB_ID --jobs jobs --watch```-The default country profile is `US` (contiguous United States); use `--country DE` for Germany. If you already have independent regional context, `--bounds WEST SOUTH EAST NORTH` can restrict the search. See [country profiles](docs/COUNTRIES.md) and the [local upload workflow](docs/PRODUCT.md) for request options, cancellation, resuming jobs, and upload limits.+The default country profile is `US` (contiguous United States); use `--country DE` for Germany or `--country ES` for Spain. Spain uses a broad geographic envelope, so add independently justified `--bounds WEST SOUTH EAST NORTH` for a regional search. See [country profiles](docs/COUNTRIES.md) and the [local upload workflow](docs/PRODUCT.md) for request options, cancellation, resuming jobs, and upload limits.**Data requirements:** Initial online acquisition may take hours and tens of gigabytes of disk space, depending on the recording time and search region. Downloads and caches are reusable; the application does not enforce an automatic disk-space cap.diff --git a/src/dopplergeist/cli.py b/src/dopplergeist/cli.pyindex 886201c..d19b215 100644--- a/src/dopplergeist/cli.py+++ b/src/dopplergeist/cli.py@@ -120,8 +120,8 @@ def main():analyze.add_argument("--start-utc",help="Earliest UTC recording start, including explicit timezone")analyze.add_argument("--end-utc",help="Latest UTC recording start; defaults to earliest")analyze.add_argument("--time-source",help="How the recording start window was established")- analyze.add_argument("--country",type=str.upper,choices=("US", "DE"),- help="Receiver country: US (CONUS, default) or DE (Germany)")+ analyze.add_argument("--country",type=str.upper,choices=("US", "DE", "ES"),+ help="Receiver country: US (CONUS, default), DE (Germany), or ES (Spain)")analyze.add_argument("--bounds",type=float,nargs=4,metavar=("WEST", "SOUTH", "EAST", "NORTH"),help="Limit the selected country profile to a WGS84 rectangle in decimal degrees")analyze.add_argument("--jobs",default="jobs",help="Persistent job directory")