# SHWRP-2026-034 - DJI Mavic 3M end-to-end digital-twin demo

## v1.1 focused public revision

Version 1.1 is the focused correctness and scope revision identified by version DOI `10.5281/zenodo.21791470` under the unchanged concept DOI `10.5281/zenodo.21789963`. The immutable public v1.0 remains independently citable at DOI `10.5281/zenodo.21789964`.

The revision narrows the claim to a Mavic 3M specification-constrained data contract and relative spectral-low screening workflow. It fixes receipt idempotence, tests an actually missing red-edge file, makes the final review mask and functional metrics use the same >=100 m² rule, discloses the bundled OFL font, analyses SHA-256-verified measured filter responses from Zenodo 11102543, and evaluates 35 altitude/overlap mission scenarios. It still does not process real Mavic 3M imagery.

Revision reproduction commands:

```powershell
python run_demo.py
python run_focused_analysis.py
python -m pytest -q -p no:cacheprovider tests tests_v1_1
python build_pdf.py
python render_pdf.py
```

See `requirements-traceability-v1.1.csv` and the merged canonical `source-registry.csv` for the revision-specific evidence chain. `source-registry-v1.1-addendum.csv` is retained only as a transparent change record.

This package demonstrates a specification-constrained, software-in-the-loop path from a virtual field to a review-priority map:

`virtual field → route geometry → 408 synchronized capture events → fail-closed QC → synthetic DN → relative-reflectance normalization → NDVI/NDRE/GNDVI → review zones → machine-readable receipt`

It does **not** connect to a DJI aircraft, execute a flight, process real Mavic 3M files, identify disease, assign an agronomic cause or authorize treatment.

## Reproduce the demo

```powershell
python -m pip install -r requirements.txt
python run_demo.py
python -m pytest -q
python verify_reproducibility.py
python build_pdf.py
python render_pdf.py
```

`python run_demo.py` reads `config/mission.example.json` and `config/virtual-field.json`; these files are executable inputs, not illustrative documentation. Canonical configuration: 400×300 m virtual rice field, 60 m AGL, 5 m/s, 80% forward and 70% side overlap, two-second multispectral interval, deterministic seed `20260804`.

The module CLI accepts `--mission-config`, `--field-config` and `--output-root` for an alternate validated configuration and isolated output directory. Every accepted configuration remains simulation-only, non-operational and free of real parcels or precise coordinates.

## Main outputs

- `outputs/demo/mission-summary.json`: GSD, footprint, route, timing and planning budget.
- `outputs/demo/capture-manifest.csv`: one RGB plus four multispectral filenames and QC data per simulated trigger.
- `outputs/demo/synthetic-analysis-arrays.npz`: compact synthetic DN, relative reflectance, indices, coverage and truth masks.
- `outputs/demo/system-analysis.json`: review zones and explicitly simulation-only functional metrics.
- `outputs/demo/engineering-demo-receipt.json`: provenance and SHA-256 manifest.
- `outputs/focused/m3m-spectral-response-summary.csv`: attributed derivative spectral-response statistics; no source CSV is repackaged.
- `outputs/focused/mission-feasibility-envelope.csv`: 35 specification-constrained altitude and overlap scenarios.
- `outputs/focused/focused-analysis-receipt.json`: hashes for the focused derived outputs and figures.
- `outputs/figures/`: original explanatory figures.

## Citation, rights and data

Version 1.1 is the current public working-paper release identified by DOI `10.5281/zenodo.21791470`; v1.0 remains preserved at DOI `10.5281/zenodo.21789964`. Author-licensable original analysis, prose, code and original figures are released under CC BY 4.0. Third-party names, trademarks, specifications, documents and datasets retain their original rights and source terms; no third-party raw research-data files are redistributed. See `LICENSE.txt`, `RIGHTS-NOTICE.txt`, `source-registry.csv` and `data-management-plan.md`.

The reproducibility archive includes an unmodified Noto Sans TC font solely for searchable-PDF generation. That font remains under the SIL Open Font License 1.1; its copyright notice and complete licence are in `assets/fonts/OFL.txt` and it is not relicensed under CC BY 4.0.