Release: v0.2.0-pre — Tethered Nozzle Mode

Introduces a tethered (roof-fed hose) suppression mode with a nozzle/hose model, basic safety checks, and new metrics. Includes a ready-to-run scenario configs/tethered_case.yaml and quick CLI entry points.

Highlights

Tethered nozzle (roof-fed hose) mode

Quasi-static hose approximation (gravity + wind drag).

Lightweight safety nudges (tension / bend-radius proxies).

New online, time-weighted metrics

time_on_target_s, ir_over_limit_s, tension_N_peak, min_bend_radius_m.

New scenario

configs/tethered_case.yaml — minimal config for tethered demo.

Docs

README updated with tethered quick-run instructions.

What changed since v0.1.0

Added: tethered mode, scenario, metrics.

Changed: README (scenarios + quick run).

CI/Tests: smoke tests remain green; added checks for the new scenario.

What changed since v0.1.0

Added: tethered mode, scenario, metrics.

Changed: README (scenarios + quick run).

CI/Tests: smoke tests remain green; added checks for the new scenario.

Install / Run

Runtime deps
pip install -r requirements.txt

(Optional) Dev/test tools
pip install -r requirements-dev.txt

Default scenario
python -m src.run_scenario --config configs/default.yaml

Tethered scenario (new)
python -m src.run_scenario --config configs/tethered_case.yaml

Artifacts (written to ./reports)

reports/mission_log.csv — per-step mission log

reports/summary.json — aggregated metrics (includes new tethered metrics)

reports/paths.png — UAV paths and fire locations

Backward compatibility / Breaking changes

Breaking changes: none. Existing scenarios and CLI remain compatible.

summary.json now includes additional fields (older consumers won’t break).

Known limitations

Hose model is quasi-static (coarse). No full dynamics/CFD/smoke occlusion.

No water refills or multi-goal routing yet.

For research/education only; not for operational use.

Roadmap (next)

Richer hose dynamics (damping, separation warnings).

Refills, multi-goal routes, task re-allocation.

Expanded safety taxonomy and event dashboards.

CV stubs (thermal/video), stronger wind/smoke models.

Checks & CI

Tests/linters run in CI (see ci.yml workflow).

Local run:

pytest -q

Assets (attach to the release, if available)

reports/paths.png — example mission plot

reports/summary.json — example summary metrics

(opt.) reports_demo.zip — bundled examples

Full Changelog

See CHANGELOG.md:

[0.2.0-pre] - 2025-11-17

Added

• Tethered nozzle (roof-fed hose) mode: nozzle model, quasi-static hose approximation, basic safety checks.
• Scenario: configs/tethered_case.yaml.
• Online/time-weighted metrics: time_on_target_s, ir_over_limit_s, tension_N_peak, min_bend_radius_m.

Changed

• README: scenarios section and quick-run instructions for tethered mode.

[0.1.0] - 2025-11-16

Added

• Initial public release: baseline high-rise UAV fire response simulator, smoke tests, and CI.

Suggested release title

v0.2.0-pre — Tethered nozzle mode (hose model + safety metrics)