Python tool for aircraft Doppler audio geolocation using historical ADS-B flight data (Source-available)
Python acoustic-geolocationads-baircraft-trackingairplaneaudio-forensicsdoppler-effectdoppler-shiftgeolocationosintsignal-processing
Fix Doppler connector alignment and add direct flyover controls (#402)
Cinna Davis805b01db787c
diff --git a/docs/examples.html b/docs/examples.htmlindex e1ce3bf..a6caad7 100644--- a/docs/examples.html+++ b/docs/examples.html@@ -9,8 +9,8 @@<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=2">-<script src="site.js?v=2" defer></script>+<link rel="stylesheet" href="site.css?v=3">+<script src="site.js?v=3" 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">diff --git a/docs/how-it-works.html b/docs/how-it-works.htmlindex fae187a..f28e616 100644--- a/docs/how-it-works.html+++ b/docs/how-it-works.html@@ -9,8 +9,8 @@<meta name="robots" content="index,follow,max-image-preview:large"><link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/how-it-works.html"><link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>-<link rel="stylesheet" href="site.css?v=2">-<script src="site.js?v=2" defer></script>+<link rel="stylesheet" href="site.css?v=3">+<script src="site.js?v=3" 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">@@ -38,24 +38,25 @@<section class="page-heading wrap"><h1>A moving source.<br><span>A changing pitch.</span></h1><p>A passing aircraft’s pitch changes with its motion relative to the microphone. DOPPLERGEIST matches that change to recorded flight paths.</p></section><section class="section first wrap" aria-labelledby="pitch"><div class="section-intro"><h2 id="pitch">Why the pitch falls.</h2><p>On approach, each wave has less distance to travel than the one before it. Waves arrive closer together: a higher pitch. As the aircraft recedes, they arrive farther apart: a lower pitch.</p></div><div class="doppler-demo" data-doppler>-<div class="demo-heading"><span class="eyebrow">A passing aircraft, explained</span><span class="demo-phase" data-phase>Approaching · higher pitch</span></div><svg class="doppler-scene" viewBox="0 0 1080 490" role="img" aria-labelledby="demo-title demo-desc"><title id="demo-title">How motion changes the pitch at a microphone</title><desc id="demo-desc">An aircraft moves from left to right, emitting evenly timed sound waves. Waves are closer together ahead and farther apart behind. The received pitch drops as the aircraft passes. The diagram includes sound travel time and illustrates a constant tone and speed; it is not recorded data.</desc><defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath><linearGradient id="curve-color"><stop stop-color="#bba6fa"/><stop offset="1" stop-color="#79e2d1"/></linearGradient></defs>-<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="400.0" cy="105" r="42.0"/><circle cx="380.0" cy="105" r="98.0"/><circle cx="360.0" cy="105" r="154.0"/><circle cx="340.0" cy="105" r="210.0"/><circle cx="320.0" cy="105" r="266.0"/><circle cx="300.0" cy="105" r="322.0"/><circle cx="280.0" cy="105" r="378.0"/><circle cx="260.0" cy="105" r="434.0"/><circle cx="240.0" cy="105" r="490.0"/><circle cx="220.0" cy="105" r="546.0"/><circle cx="200.0" cy="105" r="602.0"/><circle cx="180.0" cy="105" r="658.0"/></g>-<g class="aircraft" data-plane transform="translate(415 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>-<path class="sound-link" data-sound-link d="M316.97 105L540 265"/>-<circle class="receiver-halo" cx="540" cy="265" r="21"/><g class="receiver"><rect x="536" y="252" width="8" height="15" rx="4"/><path d="M532 262v3a8 8 0 0 0 16 0v-3m-8 11v7m-6 0h12"/></g>+<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="402.86" cy="105" r="42.00"/><circle cx="383.27" cy="105" r="98.00"/><circle cx="363.67" cy="105" r="154.00"/><circle cx="344.08" cy="105" r="210.00"/><circle cx="324.49" cy="105" r="266.00"/><circle cx="304.90" cy="105" r="322.00"/><circle cx="285.31" cy="105" r="378.00"/><circle cx="265.71" cy="105" r="434.00"/><circle cx="246.12" cy="105" r="490.00"/><circle cx="226.53" cy="105" r="546.00"/><circle cx="206.94" cy="105" r="602.00"/><circle cx="187.35" cy="105" r="658.00"/></g>+<path class="sound-link" data-sound-link d="M417.55 105L540 268.27"/>+<g class="aircraft" data-plane transform="translate(417.55 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>+<g data-receiver transform="translate(0 3.27)"><circle class="receiver-hit" cx="540" cy="265" r="30"/><circle class="receiver-halo" cx="540" cy="265" r="21"/><g class="receiver"><rect x="536" y="252" width="8" height="15" rx="4"/><path d="M532 262v3a8 8 0 0 0 16 0v-3m-8 11v7m-6 0h12"/></g><text x="577" y="271">Microphone</text></g></g>-<text x="44" y="40">AIRCRAFT MOTION →</text><text x="577" y="271">Microphone</text>+<text x="44" y="40">AIRCRAFT MOTION →</text><path class="chart-grid" d="M80 340V456H1000M80 405H1000"/><text x="80" y="330">RECEIVED PITCH</text><text x="1000" y="395" text-anchor="end">Source pitch</text>-<path class="pitch-curve" d="M80.00,337.05 L84.60,337.13 L89.20,337.21 L93.80,337.29 L98.40,337.37 L103.00,337.46 L107.60,337.54 L112.20,337.63 L116.80,337.72 L121.40,337.82 L126.00,337.91 L130.60,338.01 L135.20,338.12 L139.80,338.22 L144.40,338.33 L149.00,338.44 L153.60,338.56 L158.20,338.67 L162.80,338.79 L167.40,338.92 L172.00,339.05 L176.60,339.18 L181.20,339.31 L185.80,339.45 L190.40,339.60 L195.00,339.75 L199.60,339.90 L204.20,340.06 L208.80,340.22 L213.40,340.39 L218.00,340.56 L222.60,340.74 L227.20,340.93 L231.80,341.12 L236.40,341.31 L241.00,341.52 L245.60,341.73 L250.20,341.94 L254.80,342.17 L259.40,342.40 L264.00,342.64 L268.60,342.88 L273.20,343.14 L277.80,343.40 L282.40,343.68 L287.00,343.96 L291.60,344.25 L296.20,344.55 L300.80,344.87 L305.40,345.19 L310.00,345.53 L314.60,345.87 L319.20,346.23 L323.80,346.61 L328.40,346.99 L333.00,347.39 L337.60,347.80 L342.20,348.23 L346.80,348.68 L351.40,349.14 L356.00,349.61 L360.60,350.11 L365.20,350.62 L369.80,351.14 L374.40,351.69 L379.00,352.26 L383.60,352.85 L388.20,353.45 L392.80,354.08 L397.40,354.73 L402.00,355.40 L406.60,356.10 L411.20,356.81 L415.80,357.55 L420.40,358.32 L425.00,359.11 L429.60,359.92 L434.20,360.76 L438.80,361.62 L443.40,362.51 L448.00,363.42 L452.60,364.36 L457.20,365.32 L461.80,366.31 L466.40,367.32 L471.00,368.36 L475.60,369.41 L480.20,370.49 L484.80,371.60 L489.40,372.72 L494.00,373.86 L498.60,375.02 L503.20,376.19 L507.80,377.38 L512.40,378.59 L517.00,379.80 L521.60,381.03 L526.20,382.26 L530.80,383.50 L535.40,384.75 L540.00,385.99 L544.60,387.24 L549.20,388.48 L553.80,389.72 L558.40,390.96 L563.00,392.18 L567.60,393.40 L572.20,394.60 L576.80,395.79 L581.40,396.97 L586.00,398.13 L590.60,399.27 L595.20,400.39 L599.80,401.49 L604.40,402.57 L609.00,403.63 L613.60,404.67 L618.20,405.68 L622.80,406.67 L627.40,407.63 L632.00,408.57 L636.60,409.48 L641.20,410.37 L645.80,411.23 L650.40,412.07 L655.00,412.88 L659.60,413.67 L664.20,414.44 L668.80,415.18 L673.40,415.89 L678.00,416.59 L682.60,417.26 L687.20,417.91 L691.80,418.54 L696.40,419.14 L701.00,419.73 L705.60,420.30 L710.20,420.84 L714.80,421.37 L719.40,421.88 L724.00,422.38 L728.60,422.85 L733.20,423.31 L737.80,423.76 L742.40,424.18 L747.00,424.60 L751.60,425.00 L756.20,425.38 L760.80,425.76 L765.40,426.11 L770.00,426.46 L774.60,426.80 L779.20,427.12 L783.80,427.43 L788.40,427.74 L793.00,428.03 L797.60,428.31 L802.20,428.59 L806.80,428.85 L811.40,429.10 L816.00,429.35 L820.60,429.59 L825.20,429.82 L829.80,430.05 L834.40,430.26 L839.00,430.47 L843.60,430.68 L848.20,430.87 L852.80,431.06 L857.40,431.25 L862.00,431.43 L866.60,431.60 L871.20,431.77 L875.80,431.93 L880.40,432.09 L885.00,432.24 L889.60,432.39 L894.20,432.53 L898.80,432.67 L903.40,432.81 L908.00,432.94 L912.60,433.07 L917.20,433.19 L921.80,433.32 L926.40,433.43 L931.00,433.55 L935.60,433.66 L940.20,433.77 L944.80,433.87 L949.40,433.97 L954.00,434.07 L958.60,434.17 L963.20,434.26 L967.80,434.36 L972.40,434.45 L977.00,434.53 L981.60,434.62 L986.20,434.70 L990.80,434.78 L995.40,434.86 L1000.00,434.94"/><path class="chart-cursor" data-cursor d="M375.71 340V456"/><circle class="pitch-dot" data-dot cx="375.71" cy="351.85" r="6"/>+<path class="pitch-curve" data-curve d="M80.00,359.68 L84.60,359.74 L89.20,359.79 L93.80,359.85 L98.40,359.91 L103.00,359.97 L107.60,360.03 L112.20,360.10 L116.80,360.16 L121.40,360.23 L126.00,360.30 L130.60,360.37 L135.20,360.45 L139.80,360.52 L144.40,360.60 L149.00,360.68 L153.60,360.76 L158.20,360.84 L162.80,360.93 L167.40,361.02 L172.00,361.11 L176.60,361.21 L181.20,361.30 L185.80,361.40 L190.40,361.51 L195.00,361.61 L199.60,361.72 L204.20,361.83 L208.80,361.95 L213.40,362.07 L218.00,362.19 L222.60,362.32 L227.20,362.45 L231.80,362.58 L236.40,362.72 L241.00,362.87 L245.60,363.01 L250.20,363.17 L254.80,363.32 L259.40,363.49 L264.00,363.66 L268.60,363.83 L273.20,364.01 L277.80,364.19 L282.40,364.39 L287.00,364.58 L291.60,364.79 L296.20,365.00 L300.80,365.22 L305.40,365.44 L310.00,365.68 L314.60,365.92 L319.20,366.17 L323.80,366.42 L328.40,366.69 L333.00,366.97 L337.60,367.25 L342.20,367.55 L346.80,367.85 L351.40,368.17 L356.00,368.50 L360.60,368.83 L365.20,369.18 L369.80,369.54 L374.40,369.92 L379.00,370.30 L383.60,370.70 L388.20,371.11 L392.80,371.54 L397.40,371.97 L402.00,372.43 L406.60,372.89 L411.20,373.37 L415.80,373.87 L420.40,374.38 L425.00,374.91 L429.60,375.45 L434.20,376.01 L438.80,376.58 L443.40,377.17 L448.00,377.77 L452.60,378.39 L457.20,379.02 L461.80,379.67 L466.40,380.34 L471.00,381.01 L475.60,381.70 L480.20,382.41 L484.80,383.13 L489.40,383.86 L494.00,384.60 L498.60,385.35 L503.20,386.11 L507.80,386.89 L512.40,387.67 L517.00,388.45 L521.60,389.24 L526.20,390.04 L530.80,390.84 L535.40,391.64 L540.00,392.45 L544.60,393.25 L549.20,394.05 L553.80,394.86 L558.40,395.65 L563.00,396.44 L567.60,397.23 L572.20,398.01 L576.80,398.78 L581.40,399.54 L586.00,400.30 L590.60,401.04 L595.20,401.77 L599.80,402.49 L604.40,403.19 L609.00,403.88 L613.60,404.56 L618.20,405.22 L622.80,405.87 L627.40,406.51 L632.00,407.13 L636.60,407.73 L641.20,408.32 L645.80,408.89 L650.40,409.45 L655.00,409.99 L659.60,410.51 L664.20,411.03 L668.80,411.52 L673.40,412.00 L678.00,412.47 L682.60,412.92 L687.20,413.36 L691.80,413.79 L696.40,414.20 L701.00,414.59 L705.60,414.98 L710.20,415.35 L714.80,415.71 L719.40,416.06 L724.00,416.40 L728.60,416.73 L733.20,417.04 L737.80,417.35 L742.40,417.64 L747.00,417.93 L751.60,418.20 L756.20,418.47 L760.80,418.73 L765.40,418.98 L770.00,419.22 L774.60,419.45 L779.20,419.68 L783.80,419.90 L788.40,420.11 L793.00,420.31 L797.60,420.51 L802.20,420.70 L806.80,420.89 L811.40,421.07 L816.00,421.24 L820.60,421.41 L825.20,421.57 L829.80,421.73 L834.40,421.88 L839.00,422.03 L843.60,422.17 L848.20,422.31 L852.80,422.45 L857.40,422.58 L862.00,422.70 L866.60,422.83 L871.20,422.95 L875.80,423.06 L880.40,423.17 L885.00,423.28 L889.60,423.39 L894.20,423.49 L898.80,423.59 L903.40,423.69 L908.00,423.78 L912.60,423.88 L917.20,423.96 L921.80,424.05 L926.40,424.13 L931.00,424.22 L935.60,424.30 L940.20,424.37 L944.80,424.45 L949.40,424.52 L954.00,424.59 L958.60,424.66 L963.20,424.73 L967.80,424.80 L972.40,424.86 L977.00,424.92 L981.60,424.98 L986.20,425.04 L990.80,425.10 L995.40,425.16 L1000.00,425.21"/><path class="chart-cursor" data-cursor d="M375.71 340V456"/><circle class="pitch-dot" data-dot cx="375.71" cy="370.02" r="6"/><text x="80" y="482">Approach</text><text x="1000" y="482" text-anchor="end">Recession · time →</text></svg>-<div class="demo-controls" hidden><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label">Flyover position<input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><output data-pitch>Higher pitch</output></div>-<p class="demo-note">Illustration · constant speed and tone, stationary microphone. The dashed line traces the sound arriving now back to its emission point.</p>+<div class="demo-controls" hidden>+<div class="demo-transport"><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label"><span>Flyover position</span><input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><div class="pitch-readout"><output data-pitch aria-live="off">Higher pitch</output><span class="demo-phase" data-phase>Approaching · higher pitch</span></div></div>+<div class="demo-parameters"><label><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>+</div></div><details class="physics-detail"><summary>The physics behind the curve</summary><div><p>For a steady source tone and a stationary microphone, the received frequency is <code>f = f₀ c / (c + vᵣ)</code>. Here <code>f₀</code> is the source frequency, <code>c</code> is sound speed, and <code>vᵣ</code> is radial velocity at emission, positive when moving away.</p><p>Sound emitted at time <code>τ</code> arrives at <code>t = τ + r(τ) / c</code>. The model solves for that emission time before calculating the pitch. The sound of closest approach arrives after the aircraft has passed.</p><a href="https://github.com/1337isnot1337/DOPPLERGEIST/blob/main/docs/METHODOLOGY.md#physical-model-and-sign-convention">Read the physical model ↗</a></div></details></section><nav class="page-jumps wrap" aria-label="On this page"><a href="#hear">Detect</a><a href="#flight">Match</a><a href="#search">Locate</a><a href="#run">Run locally</a></nav><section class="section wrap" aria-labelledby="hear"><div class="section-intro"><h2 id="hear">Find the aircraft in the audio.</h2><p>The detector scans the full recording for moving frequency ridges and groups harmonics from the same passage.</p></div>diff --git a/docs/index.html b/docs/index.htmlindex 6da1183..5f5efea 100644--- a/docs/index.html+++ b/docs/index.html@@ -9,8 +9,8 @@<meta name="robots" content="index,follow,max-image-preview:large"><link rel="canonical" href="https://1337isnot1337.github.io/DOPPLERGEIST/"><link rel="preload" href="site-fonts/GeistSerif-Regular.woff2" as="font" type="font/woff2" crossorigin>-<link rel="stylesheet" href="site.css?v=2">-<script src="site.js?v=2" defer></script>+<link rel="stylesheet" href="site.css?v=3">+<script src="site.js?v=3" 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">@@ -40,25 +40,26 @@<p class="eyebrow">Aircraft audio geolocation</p><div class="hero-copy"><h1>A flight leaves<br>a trace <span>in sound.</span></h1><div><p>DOPPLERGEIST uses the changing pitch of passing aircraft and historical flight paths to search for where a recording was made.</p><div class="hero-links"><a class="text-link" href="how-it-works.html">Explore the method <span aria-hidden="true">→</span></a><a href="examples.html">See real recordings</a></div></div></div><div class="doppler-demo" data-doppler>-<div class="demo-heading"><span class="eyebrow">A passing aircraft, explained</span><span class="demo-phase" data-phase>Approaching · higher pitch</span></div><svg class="doppler-scene" viewBox="0 0 1080 490" role="img" aria-labelledby="demo-title demo-desc"><title id="demo-title">How motion changes the pitch at a microphone</title><desc id="demo-desc">An aircraft moves from left to right, emitting evenly timed sound waves. Waves are closer together ahead and farther apart behind. The received pitch drops as the aircraft passes. The diagram includes sound travel time and illustrates a constant tone and speed; it is not recorded data.</desc><defs><clipPath id="wave-area"><rect width="1080" height="310"/></clipPath><linearGradient id="curve-color"><stop stop-color="#bba6fa"/><stop offset="1" stop-color="#79e2d1"/></linearGradient></defs>-<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="400.0" cy="105" r="42.0"/><circle cx="380.0" cy="105" r="98.0"/><circle cx="360.0" cy="105" r="154.0"/><circle cx="340.0" cy="105" r="210.0"/><circle cx="320.0" cy="105" r="266.0"/><circle cx="300.0" cy="105" r="322.0"/><circle cx="280.0" cy="105" r="378.0"/><circle cx="260.0" cy="105" r="434.0"/><circle cx="240.0" cy="105" r="490.0"/><circle cx="220.0" cy="105" r="546.0"/><circle cx="200.0" cy="105" r="602.0"/><circle cx="180.0" cy="105" r="658.0"/></g>-<g class="aircraft" data-plane transform="translate(415 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>-<path class="sound-link" data-sound-link d="M316.97 105L540 265"/>-<circle class="receiver-halo" cx="540" cy="265" r="21"/><g class="receiver"><rect x="536" y="252" width="8" height="15" rx="4"/><path d="M532 262v3a8 8 0 0 0 16 0v-3m-8 11v7m-6 0h12"/></g>+<g clip-path="url(#wave-area)"><path class="flight-line" d="M40 105H1040"/><g class="wavefronts" data-waves><circle cx="402.86" cy="105" r="42.00"/><circle cx="383.27" cy="105" r="98.00"/><circle cx="363.67" cy="105" r="154.00"/><circle cx="344.08" cy="105" r="210.00"/><circle cx="324.49" cy="105" r="266.00"/><circle cx="304.90" cy="105" r="322.00"/><circle cx="285.31" cy="105" r="378.00"/><circle cx="265.71" cy="105" r="434.00"/><circle cx="246.12" cy="105" r="490.00"/><circle cx="226.53" cy="105" r="546.00"/><circle cx="206.94" cy="105" r="602.00"/><circle cx="187.35" cy="105" r="658.00"/></g>+<path class="sound-link" data-sound-link d="M417.55 105L540 268.27"/>+<g class="aircraft" data-plane transform="translate(417.55 105)"><path d="M22 0 0-5-14-23-21-23-14-4-29-7-33-3-23 0-33 3-29 7-14 4-21 23-14 23 0 5Z"/></g>+<g data-receiver transform="translate(0 3.27)"><circle class="receiver-hit" cx="540" cy="265" r="30"/><circle class="receiver-halo" cx="540" cy="265" r="21"/><g class="receiver"><rect x="536" y="252" width="8" height="15" rx="4"/><path d="M532 262v3a8 8 0 0 0 16 0v-3m-8 11v7m-6 0h12"/></g><text x="577" y="271">Microphone</text></g></g>-<text x="44" y="40">AIRCRAFT MOTION →</text><text x="577" y="271">Microphone</text>+<text x="44" y="40">AIRCRAFT MOTION →</text><path class="chart-grid" d="M80 340V456H1000M80 405H1000"/><text x="80" y="330">RECEIVED PITCH</text><text x="1000" y="395" text-anchor="end">Source pitch</text>-<path class="pitch-curve" d="M80.00,337.05 L84.60,337.13 L89.20,337.21 L93.80,337.29 L98.40,337.37 L103.00,337.46 L107.60,337.54 L112.20,337.63 L116.80,337.72 L121.40,337.82 L126.00,337.91 L130.60,338.01 L135.20,338.12 L139.80,338.22 L144.40,338.33 L149.00,338.44 L153.60,338.56 L158.20,338.67 L162.80,338.79 L167.40,338.92 L172.00,339.05 L176.60,339.18 L181.20,339.31 L185.80,339.45 L190.40,339.60 L195.00,339.75 L199.60,339.90 L204.20,340.06 L208.80,340.22 L213.40,340.39 L218.00,340.56 L222.60,340.74 L227.20,340.93 L231.80,341.12 L236.40,341.31 L241.00,341.52 L245.60,341.73 L250.20,341.94 L254.80,342.17 L259.40,342.40 L264.00,342.64 L268.60,342.88 L273.20,343.14 L277.80,343.40 L282.40,343.68 L287.00,343.96 L291.60,344.25 L296.20,344.55 L300.80,344.87 L305.40,345.19 L310.00,345.53 L314.60,345.87 L319.20,346.23 L323.80,346.61 L328.40,346.99 L333.00,347.39 L337.60,347.80 L342.20,348.23 L346.80,348.68 L351.40,349.14 L356.00,349.61 L360.60,350.11 L365.20,350.62 L369.80,351.14 L374.40,351.69 L379.00,352.26 L383.60,352.85 L388.20,353.45 L392.80,354.08 L397.40,354.73 L402.00,355.40 L406.60,356.10 L411.20,356.81 L415.80,357.55 L420.40,358.32 L425.00,359.11 L429.60,359.92 L434.20,360.76 L438.80,361.62 L443.40,362.51 L448.00,363.42 L452.60,364.36 L457.20,365.32 L461.80,366.31 L466.40,367.32 L471.00,368.36 L475.60,369.41 L480.20,370.49 L484.80,371.60 L489.40,372.72 L494.00,373.86 L498.60,375.02 L503.20,376.19 L507.80,377.38 L512.40,378.59 L517.00,379.80 L521.60,381.03 L526.20,382.26 L530.80,383.50 L535.40,384.75 L540.00,385.99 L544.60,387.24 L549.20,388.48 L553.80,389.72 L558.40,390.96 L563.00,392.18 L567.60,393.40 L572.20,394.60 L576.80,395.79 L581.40,396.97 L586.00,398.13 L590.60,399.27 L595.20,400.39 L599.80,401.49 L604.40,402.57 L609.00,403.63 L613.60,404.67 L618.20,405.68 L622.80,406.67 L627.40,407.63 L632.00,408.57 L636.60,409.48 L641.20,410.37 L645.80,411.23 L650.40,412.07 L655.00,412.88 L659.60,413.67 L664.20,414.44 L668.80,415.18 L673.40,415.89 L678.00,416.59 L682.60,417.26 L687.20,417.91 L691.80,418.54 L696.40,419.14 L701.00,419.73 L705.60,420.30 L710.20,420.84 L714.80,421.37 L719.40,421.88 L724.00,422.38 L728.60,422.85 L733.20,423.31 L737.80,423.76 L742.40,424.18 L747.00,424.60 L751.60,425.00 L756.20,425.38 L760.80,425.76 L765.40,426.11 L770.00,426.46 L774.60,426.80 L779.20,427.12 L783.80,427.43 L788.40,427.74 L793.00,428.03 L797.60,428.31 L802.20,428.59 L806.80,428.85 L811.40,429.10 L816.00,429.35 L820.60,429.59 L825.20,429.82 L829.80,430.05 L834.40,430.26 L839.00,430.47 L843.60,430.68 L848.20,430.87 L852.80,431.06 L857.40,431.25 L862.00,431.43 L866.60,431.60 L871.20,431.77 L875.80,431.93 L880.40,432.09 L885.00,432.24 L889.60,432.39 L894.20,432.53 L898.80,432.67 L903.40,432.81 L908.00,432.94 L912.60,433.07 L917.20,433.19 L921.80,433.32 L926.40,433.43 L931.00,433.55 L935.60,433.66 L940.20,433.77 L944.80,433.87 L949.40,433.97 L954.00,434.07 L958.60,434.17 L963.20,434.26 L967.80,434.36 L972.40,434.45 L977.00,434.53 L981.60,434.62 L986.20,434.70 L990.80,434.78 L995.40,434.86 L1000.00,434.94"/><path class="chart-cursor" data-cursor d="M375.71 340V456"/><circle class="pitch-dot" data-dot cx="375.71" cy="351.85" r="6"/>+<path class="pitch-curve" data-curve d="M80.00,359.68 L84.60,359.74 L89.20,359.79 L93.80,359.85 L98.40,359.91 L103.00,359.97 L107.60,360.03 L112.20,360.10 L116.80,360.16 L121.40,360.23 L126.00,360.30 L130.60,360.37 L135.20,360.45 L139.80,360.52 L144.40,360.60 L149.00,360.68 L153.60,360.76 L158.20,360.84 L162.80,360.93 L167.40,361.02 L172.00,361.11 L176.60,361.21 L181.20,361.30 L185.80,361.40 L190.40,361.51 L195.00,361.61 L199.60,361.72 L204.20,361.83 L208.80,361.95 L213.40,362.07 L218.00,362.19 L222.60,362.32 L227.20,362.45 L231.80,362.58 L236.40,362.72 L241.00,362.87 L245.60,363.01 L250.20,363.17 L254.80,363.32 L259.40,363.49 L264.00,363.66 L268.60,363.83 L273.20,364.01 L277.80,364.19 L282.40,364.39 L287.00,364.58 L291.60,364.79 L296.20,365.00 L300.80,365.22 L305.40,365.44 L310.00,365.68 L314.60,365.92 L319.20,366.17 L323.80,366.42 L328.40,366.69 L333.00,366.97 L337.60,367.25 L342.20,367.55 L346.80,367.85 L351.40,368.17 L356.00,368.50 L360.60,368.83 L365.20,369.18 L369.80,369.54 L374.40,369.92 L379.00,370.30 L383.60,370.70 L388.20,371.11 L392.80,371.54 L397.40,371.97 L402.00,372.43 L406.60,372.89 L411.20,373.37 L415.80,373.87 L420.40,374.38 L425.00,374.91 L429.60,375.45 L434.20,376.01 L438.80,376.58 L443.40,377.17 L448.00,377.77 L452.60,378.39 L457.20,379.02 L461.80,379.67 L466.40,380.34 L471.00,381.01 L475.60,381.70 L480.20,382.41 L484.80,383.13 L489.40,383.86 L494.00,384.60 L498.60,385.35 L503.20,386.11 L507.80,386.89 L512.40,387.67 L517.00,388.45 L521.60,389.24 L526.20,390.04 L530.80,390.84 L535.40,391.64 L540.00,392.45 L544.60,393.25 L549.20,394.05 L553.80,394.86 L558.40,395.65 L563.00,396.44 L567.60,397.23 L572.20,398.01 L576.80,398.78 L581.40,399.54 L586.00,400.30 L590.60,401.04 L595.20,401.77 L599.80,402.49 L604.40,403.19 L609.00,403.88 L613.60,404.56 L618.20,405.22 L622.80,405.87 L627.40,406.51 L632.00,407.13 L636.60,407.73 L641.20,408.32 L645.80,408.89 L650.40,409.45 L655.00,409.99 L659.60,410.51 L664.20,411.03 L668.80,411.52 L673.40,412.00 L678.00,412.47 L682.60,412.92 L687.20,413.36 L691.80,413.79 L696.40,414.20 L701.00,414.59 L705.60,414.98 L710.20,415.35 L714.80,415.71 L719.40,416.06 L724.00,416.40 L728.60,416.73 L733.20,417.04 L737.80,417.35 L742.40,417.64 L747.00,417.93 L751.60,418.20 L756.20,418.47 L760.80,418.73 L765.40,418.98 L770.00,419.22 L774.60,419.45 L779.20,419.68 L783.80,419.90 L788.40,420.11 L793.00,420.31 L797.60,420.51 L802.20,420.70 L806.80,420.89 L811.40,421.07 L816.00,421.24 L820.60,421.41 L825.20,421.57 L829.80,421.73 L834.40,421.88 L839.00,422.03 L843.60,422.17 L848.20,422.31 L852.80,422.45 L857.40,422.58 L862.00,422.70 L866.60,422.83 L871.20,422.95 L875.80,423.06 L880.40,423.17 L885.00,423.28 L889.60,423.39 L894.20,423.49 L898.80,423.59 L903.40,423.69 L908.00,423.78 L912.60,423.88 L917.20,423.96 L921.80,424.05 L926.40,424.13 L931.00,424.22 L935.60,424.30 L940.20,424.37 L944.80,424.45 L949.40,424.52 L954.00,424.59 L958.60,424.66 L963.20,424.73 L967.80,424.80 L972.40,424.86 L977.00,424.92 L981.60,424.98 L986.20,425.04 L990.80,425.10 L995.40,425.16 L1000.00,425.21"/><path class="chart-cursor" data-cursor d="M375.71 340V456"/><circle class="pitch-dot" data-dot cx="375.71" cy="370.02" r="6"/><text x="80" y="482">Approach</text><text x="1000" y="482" text-anchor="end">Recession · time →</text></svg>-<div class="demo-controls" hidden><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label">Flyover position<input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><output data-pitch>Higher pitch</output></div>-<p class="demo-note">Illustration · constant speed and tone, stationary microphone. The dashed line traces the sound arriving now back to its emission point.</p>-</div><p class="hero-footnote">The pitch curve is a clue. Matching independent flyovers to the same place and time is the test.</p>+<div class="demo-controls" hidden>+<div class="demo-transport"><button type="button" class="play-button" data-play>Play flyover</button><label class="timeline-label"><span>Flyover position</span><input data-time type="range" min="0" max="1000" value="321" aria-label="Scrub through the flyover"></label><div class="pitch-readout"><output data-pitch aria-live="off">Higher pitch</output><span class="demo-phase" data-phase>Approaching · higher pitch</span></div></div>+<div class="demo-parameters"><label><span>Aircraft speed <output data-speed-value for="demo-speed">120 m/s</output></span><input id="demo-speed" data-speed type="range" min="60" max="140" step="5" value="120"></label><label><span>Microphone distance <output data-distance-value for="demo-distance">800 m</output></span><input id="demo-distance" data-distance type="range" min="250" max="850" step="10" value="800"></label></div>+</div>+</div></section><section class="section wrap" aria-labelledby="livermore"><div class="section-intro"><h2 id="livermore">An aircraft over Livermore.</h2><p>An MP3 recorded in Livermore, searched against 466 nearby aircraft. The search ranked candidate locations but did not accept a location.</p></div>diff --git a/docs/site.css b/docs/site.cssindex 31030af..5555195 100644--- a/docs/site.css+++ b/docs/site.css@@ -35,7 +35,6 @@ nav a[aria-current="page"] { color: var(--mint); text-decoration: underline; tex.hero-copy p { color: var(--muted); max-width: 470px; font-size: 19px; }.hero-links { display: flex; flex-wrap: wrap; align-items: center; gap: 16px 26px; margin-top: 24px; font-size: 15px; }.hero-links > a:last-child { text-decoration-color: var(--line); }-.hero-footnote { font-size: 14px; color: var(--muted); margin-top: 18px; }.section { padding-top: 104px; }.section-intro { margin-bottom: 32px; }.section-intro p { color: var(--muted); max-width: 690px; margin-top: 20px; }@@ -76,7 +75,6 @@ pre { margin-block: 28px; padding: 28px; overflow-x: auto; background: var(--sur.next-page > a { font-family: "Geist Serif", Georgia, serif; font-size: 25px; text-decoration: none; }/* The illustration shares the site's palette and retains a useful static state. */.doppler-demo { margin-top: 40px; border: 1px solid var(--line); border-radius: 8px; background: var(--surface); overflow: hidden; }-.demo-heading { display: flex; align-items: center; justify-content: space-between; padding: 19px 26px; gap: 16px; border-bottom: 1px solid var(--line); }.demo-phase { color: var(--mint); font-size: 13px; }.doppler-scene { display: block; width: 100%; height: auto; }.doppler-scene text { fill: var(--muted); font: 14px "Geist", Arial, sans-serif; letter-spacing: .02em; }@@ -90,13 +88,21 @@ pre { margin-block: 28px; padding: 28px; overflow-x: auto; background: var(--sur.pitch-curve { stroke: url(#curve-color); stroke-width: 3; fill: none; }.chart-cursor { stroke: var(--mint); stroke-opacity: .45; }.pitch-dot { fill: var(--mint); stroke: var(--surface); stroke-width: 3; }-.demo-controls { display: flex; align-items: center; gap: 26px; padding: 24px 26px 12px; }+.demo-controls { padding: 24px 26px; }+.demo-transport { display: grid; grid-template-columns: auto minmax(0, 1fr) 190px; align-items: center; gap: 28px; }+.pitch-readout { display: grid; gap: 3px; text-align: right; font-variant-numeric: tabular-nums; }+.pitch-readout output { font-size: 16px; }+.demo-parameters { display: grid; grid-template-columns: 1fr 1fr; gap: 32px; margin-top: 22px; padding-top: 22px; border-top: 1px solid var(--line); }+.demo-parameters label { min-width: 0; }+.demo-parameters label > span { display: flex; justify-content: space-between; gap: 12px; font-size: 13px; color: var(--muted); }+.demo-parameters output { color: var(--text); font-variant-numeric: tabular-nums; }+[data-receiver] { cursor: ns-resize; touch-action: none; }+.receiver-hit { fill: transparent; }+[data-receiver]:hover .receiver-halo { stroke-opacity: 1; }.play-button, .viewer-close { border: 1px solid var(--line); border-radius: 4px; padding: 10px 18px; color: var(--text); background: var(--bg); font-size: 14px; min-width: 128px; min-height: 44px; }.play-button:hover, .viewer-close:hover { border-color: var(--mint); }-.timeline-label { flex: 1; color: var(--muted); font-size: 12px; display: flex; align-items: center; gap: 18px; }+.timeline-label { min-width: 0; color: var(--muted); font-size: 12px; display: grid; gap: 4px; }input[type="range"] { width: 100%; min-width: 60px; accent-color: var(--mint); cursor: ew-resize; min-height: 32px; }-.demo-controls output { min-width: 145px; font-size: 14px; font-variant-numeric: tabular-nums; text-align: right; }-.demo-note { margin: 18px 26px 22px; font-size: 12px; color: var(--muted); }.physics-detail { border-bottom: 1px solid var(--line); padding-block: 24px; font-size: 16px; }.physics-detail summary { cursor: pointer; color: var(--lilac); }.physics-detail > div { max-width: 760px; color: var(--muted); padding-top: 18px; }@@ -123,7 +129,6 @@ body:has(.figure-viewer[open]) { overflow: hidden; }.method-summary { margin-top: 72px; padding-top: 42px; }.method-steps { gap: 24px; }.location-section { gap: 32px; grid-template-columns: 1fr 1fr; }- .timeline-label { font-size: 0; gap: 0; }footer { align-items: start; }footer nav { flex-wrap: wrap; justify-content: flex-end; gap: 12px 20px; }}@@ -154,16 +159,17 @@ body:has(.figure-viewer[open]) { overflow: hidden; }pre { padding: 18px; font-size: 14px; }.page-jumps { gap: 12px 24px; font-size: 13px; margin-top: 28px; }.doppler-demo { margin-top: 28px; }- .demo-heading { padding: 14px 16px; flex-wrap: wrap; gap: 6px; }- .demo-heading .eyebrow { font-size: 10px; }.demo-phase { font-size: 12px; }.doppler-scene { min-height: 210px; }.doppler-scene text { font-size: 30px; }- .demo-controls { flex-wrap: wrap; gap: 8px 18px; padding: 12px 16px 0; }- .timeline-label { order: 3; flex-basis: 100%; }- .demo-controls output { margin-left: auto; min-width: 0; font-size: 12px; }+ .demo-controls { padding: 16px; }+ .demo-transport { grid-template-columns: auto 1fr; gap: 16px; }+ .pitch-readout { grid-column: 2; grid-row: 1; }+ .pitch-readout output { font-size: 14px; }+ .demo-parameters { grid-template-columns: 1fr; gap: 16px; margin-top: 16px; padding-top: 16px; }+ .receiver-hit { r: 66px; }+ .timeline-label { grid-column: 1 / -1; grid-row: 2; }.play-button { min-width: 116px; padding-inline: 12px; }- .demo-note { margin: 14px 16px 18px; font-size: 11px; }.figure-viewer { padding: 12px; }.viewer-toolbar { gap: 12px; }.viewer-close { min-width: auto; }diff --git a/docs/site.js b/docs/site.jsindex 3209248..28b0a3b 100644--- a/docs/site.js+++ b/docs/site.js@@ -15,16 +15,44 @@const play = demo.querySelector('[data-play]');const phase = demo.querySelector('[data-phase]');const pitch = demo.querySelector('[data-pitch]');+ const curve = demo.querySelector('[data-curve]');+ const receiver = demo.querySelector('[data-receiver]');+ const speedInput = demo.querySelector('[data-speed]');+ const distanceInput = demo.querySelector('[data-distance]');const circles = Array.from({ length: 12 }, () => {const circle = document.createElementNS(svgNS, 'circle');circle.setAttribute('cy', '105');return circle;});waves.replaceChildren(...circles);- // Display units, not measured data. v/c = 25/70; microphone is 160 units off track.- const speed = 25, soundSpeed = 70, distance = 160;+ // Educational display geometry. The scale preserves the physical v/c ratio.+ const soundSpeed = 70, scale = soundSpeed / 343;+ let speed = Number(speedInput.value) * scale;+ let distance = Number(distanceInput.value) * scale;let progress = 0.16, playing = !reducedMotion.matches, visible = false;let frame = null, previous = null;+ function frequencyAt(t) {+ // Exact subsonic solution of t = tau + hypot(v*tau, distance)/c.+ const a = soundSpeed ** 2 - speed ** 2;+ const tau = (soundSpeed ** 2 * t - Math.sqrt(soundSpeed ** 2 * speed ** 2 * t ** 2 + a * distance ** 2)) / a;+ const radial = speed ** 2 * tau / Math.hypot(speed * tau, distance);+ return soundSpeed / (soundSpeed + radial);+ }+ function chartY(ratio) { return 405 - (ratio - 1) * 90; }+ function updateParameters() {+ speed = Number(speedInput.value) * scale;+ distance = Number(distanceInput.value) * scale;+ demo.querySelector('[data-speed-value]').textContent = `${speedInput.value} m/s`;+ demo.querySelector('[data-distance-value]').textContent = `${distanceInput.value} m`;+ speedInput.setAttribute('aria-valuetext', `${speedInput.value} meters per second`);+ distanceInput.setAttribute('aria-valuetext', `${distanceInput.value} meters`);+ const points = Array.from({ length: 201 }, (_, i) => {+ const t = -14 + 28 * i / 200;+ return `${i ? 'L' : 'M'}${80 + 920 * i / 200},${chartY(frequencyAt(t))}`;+ });+ curve.setAttribute('d', points.join(' '));+ draw();+ }function draw() {const t = -14 + 28 * progress;const x = 540 + speed * t;@@ -35,21 +63,13 @@circle.setAttribute('cx', 540 + speed * emitted);circle.setAttribute('r', (t - emitted) * soundSpeed);});- // Invert t = tau + r(tau)/c. Frequency depends on velocity at emission.- let low = t - 30, high = t;- for (let i = 0; i < 40; i++) {- const tau = (low + high) / 2;- if (tau + Math.hypot(speed * tau, distance) / soundSpeed < t) low = tau;- else high = tau;- }- const tau = (low + high) / 2;- const radial = speed * speed * tau / Math.hypot(speed * tau, distance);- const ratio = soundSpeed / (soundSpeed + radial);- // Dashed line connects the emission position, rather than the current plane, to the receiver.- line.setAttribute('d', `M${540 + speed * tau} 105L540 265`);+ const ratio = frequencyAt(t);+ // This connector shows present aircraft-to-microphone geometry.+ line.setAttribute('d', `M${x} 105L540 ${105 + distance}`);+ receiver.setAttribute('transform', `translate(0 ${distance - 160})`);const chartX = 80 + progress * 920;dot.setAttribute('cx', chartX);- dot.setAttribute('cy', 405 - (ratio - 1) * 130);+ dot.setAttribute('cy', chartY(ratio));cursor.setAttribute('d', `M${chartX} 340V456`);const label = Math.abs(ratio - 1) < 0.02 ? 'Near source pitch' : ratio > 1 ? 'Approaching · higher pitch' : 'Receding · lower pitch';phase.textContent = label;@@ -88,6 +108,34 @@updateButton();draw();});+ speedInput.addEventListener('input', updateParameters);+ distanceInput.addEventListener('input', updateParameters);+ let dragPointer = null;+ function moveMicrophone(event) {+ const point = scene.createSVGPoint();+ point.x = event.clientX;+ point.y = event.clientY;+ const position = point.matrixTransform(scene.getScreenCTM().inverse());+ distanceInput.value = Math.max(250, Math.min(850, Math.round((position.y - 105) / scale / 10) * 10));+ updateParameters();+ }+ receiver.addEventListener('pointerdown', event => {+ if (event.button !== 0 || dragPointer !== null) return;+ event.preventDefault();+ playing = false;+ previous = null;+ updateButton();+ dragPointer = event.pointerId;+ receiver.setPointerCapture(event.pointerId);+ moveMicrophone(event);+ });+ receiver.addEventListener('pointermove', event => {+ if (event.pointerId === dragPointer) moveMicrophone(event);+ });+ receiver.addEventListener('pointerup', event => {+ if (event.pointerId === dragPointer) receiver.releasePointerCapture(event.pointerId);+ });+ receiver.addEventListener('lostpointercapture', () => { dragPointer = null; });reducedMotion.addEventListener('change', () => {if (reducedMotion.matches) { playing = false; previous = null; updateButton(); }});@@ -100,7 +148,7 @@observer.observe(scene);demo.querySelector('.demo-controls').hidden = false;updateButton();- draw();+ updateParameters();});if (typeof HTMLDialogElement === 'undefined') return;