Mimir/research/perfect-machine-study-2026-05-23/index.md

2026-05-23 Perfect Machine Study Index

Purpose

This directory is the deeper study pass that sits beside the source map. Use it when the next implementation pass needs more than "where is the file?" and needs the reason a cut exists.

Documents

File	Use It For
[[architecture-rumination	Architecture Rumination]]
[[optimization-ledger	Optimization Ledger]]
[[references	References]]
[[current-hotspot-audit	Current Hotspot Audit]]
[[implementation-roadmap	Implementation Roadmap]]
[[questions-and-hypotheses	Questions And Hypotheses]]
[[reading-guide	Reading Guide]]
[[data-dictionary	Data Dictionary]]
[[volumetric-audio-field	Volumetric Audio Field]]
[[acoustic-field-models	Acoustic Field Models]]
[[chirplet-transform-deep-dive	Chirplet Transform Deep Dive]]
[[decoder-architecture-options	Decoder Architecture Options]]
[[distributed-receiver-spec	Distributed Receiver Spec]]
[[visual-fusion-4dgs-study	Visual Fusion 4DGS Study]]
[[open-implementation-catalog	Open Implementation Catalog]]
[[prior-research-synthesis	Prior Research Synthesis]]
[[research-claims-digest	Research Claims Digest]]
[[fensalir-integration-map	Fensalir Integration Map]]
[[native-boundary-map	Native Boundary Map]]
[[option-matrix	Option Matrix]]
[[benchmark-plan	Benchmark Plan]]
[[calibration-session-spec	Calibration Session Spec]]
[[low-level-implementation-notes	Low-Level Implementation Notes]]
[[microsecond-sync-math	Microsecond Sync Math]]
[[state-machine-invariants	State Machine Invariants]]
[[failure-mode-ledger	Failure Mode Ledger]]
[[hot-path-pseudocode	Hot Path Pseudocode]]
[[glossary	Glossary]]
sample-code-index.json	Machine-readable index for sample sketches.
[[samples/README	Sample Implementation Sketches]]

Sample Code

Sample	Future Production Target	Question It Answers
samples/StreamingChirpBinDecoderSketch.cs	MimirChirpBinStreamingDecoder or equivalent runtime class	What state removes full-window rescans?
samples/Avx2DechirpGoertzelSketch.cpp	Native CPU scorer for chirp-bin candidates	What does SIMD dechirp/bin scoring look like?
samples/BatchedChirpScoreAbiSketch.h	Native scorer ABI	What batch boundary avoids per-candidate managed/native overhead?
samples/ChirpBinScore.compute.hlsl	Fensalir/D3D12 compute scorer	How would batched candidate/bin scoring map to GPU?
samples/FarrowFractionalDelaySketch.cpp	Faust/native DSP actuator	What is the smallest fractional delay proof?
samples/SpscAudioBlockRingSketch.cpp	Native capture worker handoff	What shape should low-jitter audio block transfer take?
samples/CalibrationWeightedChirpLikelihoodSketch.cs	Physical-path active decoder	Where does calibration enter symbol likelihood?
samples/SroPllAsrcControllerSketch.cpp	DSP actuator control	How does delay/SRO state become a resampler command?
samples/GaussianSplatClaimUpdate.compute.hlsl	Fensalir visual fusion	What is the smallest live splat-claim compute shape?
samples/AquariumGpuSensorFrameBridgeSketch.cs	Mimir-to-Fensalir visual lowering	How should runtime video observations become Fensalir sensor frames?
samples/AcousticConstraintLoweringSketch.cs	Mimir-to-Fensalir acoustic lowering	How should decoded anchors/geometry become acoustic constraints?
samples/TemporalEvidenceCandidateSketch.cs	Shared temporal evidence candidates	How can Mimir lower candidates without owning Fensalir tracks?
samples/SrpPhatGridSketch.cpp	Acoustic source localization	What is the smallest TDOA/SRP-PHAT-style grid scoring proof?

Best Next Implementation Sequence

1. Build a streaming chirp-bin decoder state object beside the current analyzer, but keep the old analyzer as proof oracle until outputs match.
2. Load a real physical mic calibration model and compare weighted versus unweighted symbol likelihood on stored Scarlett captures.
3. Emit reduced reliable-bin codebook from the physical model and measure meatspace anchor rate.
4. Add native/Faust actuator proof using logged MimirAudioSynchronizationState before touching live program output.
5. Port one direct camera path into IMimirVideoCaptureDriverSource; Leap first if timing/depth value wins, PS3 Eye first if raw driver throughput is the faster proof.

Index Terms

• active sync
• ASIO
• AVX2
• chirp-bin
• chirplet
• codebook adaptation
• dechirp
• D3D12 compute
• Farrow fractional delay
• Faust actuator
• GCC-PHAT
• group delay
• LoRa CSS
• native reservoir
• Fensalir
• Gaussian splatting
• passive sync
• Raven
• response/confusion matrix
• sample-rate offset
• SPSC ring
• Starfire
• streaming decoder
• volumetric audio
• volumetric visual fusion