beamsim v0.2.0

beamsim v0.2.0

This release adds modern evaluation diagnostics for codebook-based mmWave beam-alignment simulation while keeping the repository's scope intentionally narrow.

Added

• Finite-codebook oracle SNR:
  best achievable SNR over the simulated UE × BS codebook for the same channel realization.
• dB SNR regret:
  additive gap between the finite-codebook oracle and the achieved beam pair.
• Outage probability:
  strict-threshold estimate, Pr(SNR_dB < threshold_db).
• Beam-switch rate:
  transition-normalized switching frequency over output beam-pair histories.
• Measurement-budget taxonomy and lifecycle framing in the documentation.
• Roadmap entries for deferred measurement-budget accounting and blockage reacquisition latency.

Methodological positioning

beamsim remains a focused simulator for codebook-based mmWave beam alignment and tracking. It is not a general 5G/6G beam-management benchmark, ML beam-prediction framework, RIS simulator, digital-twin platform, or near-field / sub-THz model.

The central contribution of this release is clearer paired stochastic evaluation and finite-codebook oracle diagnostics for reproducible comparison of beam-alignment policies.

---

Full engineering log: CHANGELOG.md. Scope and out-of-scope items: docs/related_work.md. Deferred work: docs/ROADMAP.md.