wifi-densepose/examples/research-sota/01-physics-floor
rUv eb88035699
docs(examples/research-sota): add main + 9 sub-folder READMEs (follow-up to #744) (#745)
PR #744 moved the files into 9 thematic folders via git mv but missed
the READMEs due to a working-directory issue with git add. This PR
adds the actual READMEs:

- examples/research-sota/README.md (main overview)
- examples/research-sota/01-physics-floor/README.md
- examples/research-sota/02-placement/README.md
- examples/research-sota/03-spatial-intelligence/README.md
- examples/research-sota/04-rssi/README.md
- examples/research-sota/05-cross-room-reid/README.md
- examples/research-sota/06-structure-detection/README.md
- examples/research-sota/07-negative-results/README.md
- examples/research-sota/08-verticals/README.md
- examples/research-sota/09-quantum-fusion/README.md

Each sub-README documents:
- Scripts + headlines table
- Why this folder bounds/composes with others
- Sample output / honest scope
- Cross-references to related loop notes + ADRs

Main README covers:
- Folder map with thread numbers
- Cross-folder dependency graph
- 8-entry headline findings table
- Reading order for newcomers (4 scripts in suggested order)
- Honest scope (synthetic-physics caveats)
2026-05-22 07:54:19 -04:00
..
README.md docs(examples/research-sota): add main + 9 sub-folder READMEs (follow-up to #744) (#745) 2026-05-22 07:54:19 -04:00
r1_toa_crlb.py chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r1_toa_crlb_results.json chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r6_1_multiscatterer.py chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r6_1_multiscatterer_results.json chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r6_fresnel_results.json chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r6_fresnel_zone.py chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00

README.md

01 — Physics-floor primitives

Bedrock physics that bounds everything else in the loop. Three primitives:

Scripts

Script Thread Headline
r1_toa_crlb.py R1 20 MHz HT20 @ 20 dB SNR ToA CRLB: 41 cm single-shot, 4 cm with 100× averaging. Phase vs ToA: 238× advantage with cycle-slip resolution.
r6_fresnel_zone.py R6 First-Fresnel envelope at 5 m link, 2.4 GHz: 40 cm wide ellipsoid at midpoint. Per-subcarrier phase predictions for 4 canonical scatterer scenarios.
r6_1_multiscatterer.py R6.1 6-scatterer human body model. Multi-scatterer penalty: +4.7 dB worse than idealised single-scatterer (matches R13's 5-dB shortfall to 0.3 dB).

Why this folder bounds the rest

  • R1 CRLB sets the temporal-resolution floor for any localisation feature.
  • R6 Fresnel gives the spatial envelope of CSI sensitivity (~40 cm wide at 5 m link).
  • R6.1 multi-scatterer extends R6 from point-scatterer to realistic distributed body; quantifies the gap between idealised and real physics.

Together: physics floors that bound R6.2 family (placement), R12 family (structure detection), R14 (vitals), R20 (quantum integration).

Sample output

=== R6 first Fresnel radii (m) ===
 freq   lambda   link  p=0.10  p=0.25  p=0.50  p=0.75  p=0.90
  2.4 124.9mm  5.0m   0.237   0.342   0.395   0.342   0.237

=== R6.1 multi-scatterer penalty ===
  Single-scatterer ideal:  +23.7 dB
  Multi-scatterer (6 body parts): +19.0 dB
  Penalty: +4.7 dB

Honest scope

  • All numbers are best-case physics; real CSI has additional noise channels.
  • Body model is 6 point-scatterers; real body is distributed continuous RCS.
  • 2D (top-down) approximations; 3D extensions live in 02-placement/.

See also

  • Loop research notes: docs/research/sota-2026-05-22/R{1,6,6_1}-*.md
  • Used by: 02-placement/, 03-spatial-intelligence/, 06-structure-detection/, 09-quantum-fusion/