Architecture Decision Records

Architecture Decision Records (ADRs) document the significant technical decisions made during Heterodyne’s development — what was decided, why, and what alternatives were considered.

• ADR-001: JAX CPU-Only Backend
• ADR-002: NLSQ / CMC Architectural Split
• ADR-003: Anti-Degeneracy Layer for Velocity-Phase Model
• ADR-004: Consensus Monte Carlo for Bayesian Inference
• ADR-005: Per-Angle Scaling Modes
• ADR-006: No GPU Acceleration on Consumer Hardware

---

ADR Summary:

ADR	Title	Status
001	JAX CPU-only backend	Accepted
002	NLSQ / CMC architectural split	Accepted
003	Anti-degeneracy layer for velocity-phase model	Accepted
004	Consensus Monte Carlo over standard MCMC	Accepted
005	Per-angle scaling modes (auto/constant/individual/fourier)	Accepted
006	No GPU acceleration on consumer hardware	Accepted

Note

New ADRs should follow the template in docs/source/developer/adrs/. Each ADR covers: Context, Decision, Consequences, and Alternatives Considered.