Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
<!doctype html>
<html lang="en" data-type="software">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<meta name="page-type" content="software">
<meta name="site-kind" content="software">
<meta name="theme-color" content="#121816">
<title>Audio Geolocation Examples — DOPPLERGEIST</title>
<meta name="description" content="Real aircraft recordings analyzed with DOPPLERGEIST. Browse Doppler spectrograms, flight-path fits and geographic search results from the repository.">
<meta name="robots" content="index,follow,max-image-preview:large">
<link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/examples.html">
<link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>
<link rel="stylesheet" href="site.css?v=5">
<script src="site.js?v=5" defer></script>
<link rel="icon" href="site-media/favicon.svg" type="image/svg+xml">
<meta property="og:type" content="website">
<meta property="og:site_name" content="DOPPLERGEIST">
<meta property="og:title" content="Audio Geolocation Examples — DOPPLERGEIST">
<meta property="og:description" content="Real aircraft recordings analyzed with DOPPLERGEIST. Browse Doppler spectrograms, flight-path fits and geographic search results from the repository.">
<meta property="og:url" content="https://1337isnot1337.github.io/DOPPLERGEIST/examples.html">
<meta property="og:image" content="https://1337isnot1337.github.io/DOPPLERGEIST/site-media/livermore-automatic-mp3.png">
<meta property="og:image:width" content="2610">
<meta property="og:image:height" content="1278">
<meta property="og:image:alt" content="Aircraft Doppler spectrogram and satellite map from the real Livermore recording">
<meta name="twitter:card" content="summary_large_image">
<meta name="twitter:title" content="Audio Geolocation Examples — DOPPLERGEIST">
<meta name="twitter:description" content="Real aircraft recordings analyzed with DOPPLERGEIST. Browse Doppler spectrograms, flight-path fits and geographic search results from the repository.">
<meta name="twitter:image" content="https://1337isnot1337.github.io/DOPPLERGEIST/site-media/livermore-automatic-mp3.png">
<meta name="twitter:image:alt" content="Aircraft Doppler spectrogram and satellite map from the real Livermore recording">
<script type="application/ld+json">{"@context":"https://schema.org","@graph":[{"@type":"WebSite","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#website","url":"https://1337isnot1337.github.io/DOPPLERGEIST/","name":"DOPPLERGEIST"},{"@type":"WebPage","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/examples.html#page","url":"https://1337isnot1337.github.io/DOPPLERGEIST/examples.html","name":"Audio Geolocation Examples — DOPPLERGEIST","description":"Real aircraft recordings analyzed with DOPPLERGEIST. Browse Doppler spectrograms, flight-path fits and geographic search results from the repository.","isPartOf":{"@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#website"},"primaryImageOfPage":{"@type":"ImageObject","contentUrl":"https://1337isnot1337.github.io/DOPPLERGEIST/site-media/livermore-automatic-mp3.png"}},{"@type":"SoftwareSourceCode","@id":"https://1337isnot1337.github.io/DOPPLERGEIST/#software","name":"DOPPLERGEIST","description":"Audio geolocation software that matches aircraft Doppler signatures to historical ADS-B flight trajectories.","codeRepository":"https://github.com/1337isnot1337/DOPPLERGEIST","programmingLanguage":"Python","runtimePlatform":"Python 3.11 or later","license":"https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/LICENSE","author":{"@type":"Person","name":"Cinna Davis","url":"https://github.com/1337isnot1337"}},{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"DOPPLERGEIST","item":"https://1337isnot1337.github.io/DOPPLERGEIST/"},{"@type":"ListItem","position":2,"name":"Examples","item":"https://1337isnot1337.github.io/DOPPLERGEIST/examples.html"}]}]}</script>
</head>
<body>
<header class="site-header nav">
<a class="skip skip-link" href="#main">Skip to content</a>
<div class="wrap header-content">
<a class="brand" href="./" aria-label="DOPPLERGEIST home">DOPPLERGEIST</a>
<nav aria-label="Main navigation"><a href="./">Overview</a><a href="examples.html" aria-current="page">Examples</a><a href="how-it-works.html">How it works</a><a class="nav-repo" href="https://github.com/1337isnot1337/DOPPLERGEIST">GitHub <span aria-hidden="true">↗</span></a></nav>
</div></header>
<main id="main">
<section class="page-heading wrap"><h1>From the recordings.</h1><p>Real recordings, measured frequency curves, and candidate maps. Each figure shows a different part of the search; a high score alone does not establish a location.</p></section>
<nav class="page-jumps wrap" aria-label="On this page"><a href="#livermore">Livermore</a><a href="#frequency">Frequency</a><a href="#discovery">Discovery</a><a href="#map">Location</a></nav>
<section class="section first wrap" aria-labelledby="livermore"><div class="section-intro"><h2 id="livermore">Livermore, California</h2><p>The automatic MP3 search and a configured run of the same recording. Both produced ranked candidates without accepting a location. <a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/docs/LIVERMORE_DEMO.md">Read the experiment</a>.</p></div>
<figure class="evidence-figure"><div class="figure-heading"><span>Automatic MP3 search</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/livermore-automatic-mp3.png" aria-label="View full-size image: Automatic real MP3 analysis with the observed Doppler curve and ranked locations on a Livermore satellite map"><img src="site-media/livermore-automatic-mp3.webp" srcset="site-media/livermore-automatic-mp3-960.webp 960w, site-media/livermore-automatic-mp3.webp 2610w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="2610" height="1278" fetchpriority="high" alt="Automatic real MP3 analysis with the observed Doppler curve and ranked locations on a Livermore satellite map"></a><figcaption>Recorded audio and ranked candidates. The run remained inconclusive.</figcaption></figure>
<figure class="evidence-figure separate-figure"><div class="figure-heading"><span>Configured search</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/livermore-configured.png" aria-label="View full-size image: Configured Livermore search showing a recorded flyover and a bounded map of candidate microphone positions"><img src="site-media/livermore-configured.webp" srcset="site-media/livermore-configured-960.webp 960w, site-media/livermore-configured.webp 2610w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="2610" height="1278" loading="lazy" decoding="async" alt="Configured Livermore search showing a recorded flyover and a bounded map of candidate microphone positions"></a><figcaption>The same recording with configured event settings. No location was accepted.</figcaption></figure>
</section>
<section class="section wrap" aria-labelledby="frequency"><div class="section-intro"><h2 id="frequency">Reading the frequency.</h2><p>Measured tones and the aircraft models fitted to them.</p></div>
<div class="pair">
<figure class="evidence-figure"><div class="figure-heading"><span>The measured ridge</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/measured-event.png" aria-label="View full-size image: Recorded aircraft Doppler ridge and a fitted straight-pass curve"><img src="site-media/measured-event.webp" srcset="site-media/measured-event-960.webp 960w, site-media/measured-event.webp 1500w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(50vw - 78px), min(554px, calc(50vw - 102px))" width="1500" height="600" loading="lazy" decoding="async" alt="Recorded aircraft Doppler ridge and a fitted straight-pass curve"></a><figcaption>A moving tone in the recording, with a fitted straight-pass curve.</figcaption></figure>
<figure class="evidence-figure"><div class="figure-heading"><span>The flight-path model</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/physical-model.png" aria-label="View full-size image: Observed aircraft spectrogram with a best-fitting sound propagation model"><img src="site-media/physical-model.webp" srcset="site-media/physical-model-960.webp 960w, site-media/physical-model.webp 1600w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(50vw - 78px), min(554px, calc(50vw - 102px))" width="1600" height="640" loading="lazy" decoding="async" alt="Observed aircraft spectrogram with a best-fitting sound propagation model"></a><figcaption>A trajectory-based prediction over the recorded spectrogram.</figcaption></figure>
</div>
<figure class="evidence-figure separate-figure"><div class="figure-heading"><span>A second passage</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/track-overlay.png" aria-label="View full-size image: Second recorded flyover with cyan Doppler model over the descending frequency ridge"><img src="site-media/track-overlay.webp" srcset="site-media/track-overlay-960.webp 960w, site-media/track-overlay.webp 1600w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1600" height="640" loading="lazy" decoding="async" alt="Second recorded flyover with cyan Doppler model over the descending frequency ridge"></a><figcaption>A flight-path prediction laid over another recorded frequency ridge.</figcaption></figure>
</section>
<section class="section wrap" aria-labelledby="discovery"><div class="section-intro"><h2 id="discovery">Finding the flyovers.</h2><p>Automatic discovery across an entire recording, then a closer look at grouped acoustic traces.</p></div>
<figure class="evidence-figure"><div class="figure-heading"><span>Across the recording</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/discovery-overview.png" aria-label="View full-size image: Whole-recording discovery showing candidate moving-frequency traces over recording time"><img src="site-media/discovery-overview.webp" srcset="site-media/discovery-overview-960.webp 960w, site-media/discovery-overview.webp 1560w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1560" height="650" loading="lazy" decoding="async" alt="Whole-recording discovery showing candidate moving-frequency traces over recording time"></a><figcaption>Moving-frequency proposals found by the detector; proposals are not confirmed aircraft.</figcaption></figure>
<figure class="evidence-figure separate-figure"><div class="figure-heading"><span>Grouping the traces</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/acoustic-families.png" aria-label="View full-size image: Frequency traces grouped into a canonical acoustic episode over 60 seconds"><img src="site-media/acoustic-families.webp" srcset="site-media/acoustic-families-960.webp 960w, site-media/acoustic-families.webp 1560w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1560" height="650" loading="lazy" decoding="async" alt="Frequency traces grouped into a canonical acoustic episode over 60 seconds"></a><figcaption>Related tones are grouped so harmonics do not count as independent flyovers.</figcaption></figure>
</section>
<section class="section wrap location-section" aria-labelledby="map"><div><h2 id="map">Searching the map.</h2><p>Each point is a possible microphone location. Color shows the fit score; the star marks the highest score.</p><a class="text-link" href="how-it-works.html">Read the method <span aria-hidden="true">↗</span></a></div>
<figure class="evidence-figure"><div class="figure-heading"><span>The candidate map</span><span aria-hidden="true">↗</span></div><a class="figure-link" href="site-media/location-scores.png" aria-label="View full-size image: Geographic grid colored by location fit score, with the highest-scoring position marked by a red star"><img src="site-media/location-scores.webp" srcset="site-media/location-scores-960.webp 960w, site-media/location-scores.webp 1120w" sizes="(max-width: 700px) calc(100vw - 62px), (max-width: 900px) calc(100vw - 98px), min(1166px, calc(100vw - 146px))" width="1120" height="960" loading="lazy" decoding="async" alt="Geographic grid colored by location fit score, with the highest-scoring position marked by a red star"></a><figcaption>Color encodes fit score, not location probability.</figcaption></figure>
</section>
<p class="wrap source-link"><a href="https://github.com/1337isnot1337/DOPPLERGEIST/tree/main/evidence">Browse the source figures</a></p>
<div class="next-page wrap"><span>What connects these figures?</span><a href="how-it-works.html">Understand the method <span aria-hidden="true">→</span></a></div>
</main>
<footer class="wrap">
<a class="brand" href="./">DOPPLERGEIST</a>
<nav aria-label="Footer navigation"><a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/docs/SETUP.md">Documentation</a><a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/LICENSE">License</a><a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/docs/COMMERCIAL-LICENSING.md">Commercial use</a></nav>
</footer>
</body>
</html>