v0.2.1

v0.2.1 — Repository cleanup

Maintenance release after v0.2.0. No change to default GUI simulation behavior.

Changes

• Removed deprecated matlab_port shim and unused UI modules (matlab_scene, viewmodel)
• Removed orphan README images and stale v0.1 publish docs/scripts
• Vendor packing binaries no longer committed; build via bash scripts/demo.sh or CI
• Aligned pyproject.toml author with citation pack (Ramanathan Subramanian)
• Simplified docs/RELEASE.md and generate_readme_assets.py (map + packing previews only)

Quick start

git clone https://github.com/linux-ram/mmwave-v2i-sim.git
cd mmwave-v2i-sim
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements-lock.txt
pip install -e ".[dev,gui]"
bash scripts/demo.sh   # builds local 2drbp binaries (recommended)
python -m mmwave_v2i_sim.cli --gui

Full feature set

See RELEASE_NOTES_v0.2.0.md for ZIP export, paper PDF, city presets, and citation helpers.

v0.2.0

v0.2.0 — Inviting release + research snapshot

Highlights

• README: stacked GUI previews (map + packing), tagline mmWave V2I link-layer simulator in Python
• Session export: completed runs save as ZIP (manifest.json, CSV trim-loss, JSONL, embedded session.npz)
• City presets: Boston, San Francisco, RTP configs + scripts/demo_city_presets.py (research path)
• Channel: Dual-band 28/39 GHz, geometric LOS, codebook vs ideal beam modes (research path)
• Paper: Two-page IEEE-style paper/main.pdf with GUI figures; author Ramanathan Subramanian
• Citation: docs/CITATION.md, CITATION.cff, Tectonic build via bash scripts/build_paper.sh
• CI: Linux 2DRBP parity build; validation report artifacts

Quick start

git clone https://github.com/linux-ram/mmwave-v2i-sim.git
cd mmwave-v2i-sim
python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements-lock.txt
pip install -e ".[dev,gui]"
python -m mmwave_v2i_sim.cli --gui

After a run completes, use Save to download mmwave_sim_session.zip.

Study the paper

bash scripts/build_paper.sh
open paper/main.pdf

Or download the paper-pdf artifact from the latest Paper PDF workflow run.

Since v0.1.0

• ZIP session export (replaces standalone .npz as the default download)
• README and technical report refresh (no separate hero aerial / density-sweep README section)
• Citation pack and committed PDF
• City presets and dual-band research path (YAML; not wired into default desktop sim_engine GUI)

Known limits (post-v0.2 issues)

Tracked on GitHub: #1 3D/KPI panel, #2 scale, #3 paper-in-CI polish.

v0.1.0

v0.1.0 — Initial public release

Highlights

• MATLAB-parity desktop simulator (sim_engine): aerial map, LoS beams, 2DRBP packing (Guillotine / Shelf / MaxRects).
• PySide6 GUI: Figure 1 + Figure 2 layout, playback controls, batch runs (1/5/20/50), session .zip export (JSON/CSV + embedded session.npz).
• Trim-loss trend plot with multi-run statistics.
• Optional OSM road-snapped routes (Boston Seaport).
• Legacy research engine (core/) for protocol-phase experiments.

Install

python3 -m venv .venv && source .venv/bin/activate
pip install -r requirements-lock.txt
pip install -e ".[dev,gui]"
pytest
python -m mmwave_v2i_sim.cli --gui

Related work

• Original MATLAB simulator: linux-ram/mmWave-V2I-2DRBP
• MathWorks File Exchange: 84948

Known limits (v0.2 roadmap)

• GUI vehicle count capped at 50 (not interactive 200-vehicle scale).
• 2D matplotlib viewport (no 3D city mesh).
• IEEE PDF build not automated in CI.