wifi-densepose/examples/research-sota/03-spatial-intelligence
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
r5_subcarrier_saliency.py chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r7_multilink_consistency.py chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00
r7_multilink_consistency_results.json chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) 2026-05-22 07:52:57 -04:00

README.md

03 — Spatial intelligence

Subcarrier-selection and multi-link adversarial-defence primitives.

Scripts

Script Thread Headline
r5_subcarrier_saliency.py R5 Top-8 most-informative subcarriers for person-count classification. Band-spread (not band-clustered) — explained by R6 Fresnel forward model (zone-1 occupancy has flat per-subcarrier phase). Max/mean ratio 2.85×.
r7_multilink_consistency.py R7 Stoer-Wagner minimum cut detects 3/3 adversarial spoofs across multi-link CSI graphs. Identifies which links were compromised; reports "physically impossible CSI" via topological consistency.

Why these compose

  • R5 saliency tells us WHICH subcarriers carry the discriminative information for each cog.
  • R7 mincut tells us WHEN we should trust the CSI at all (multi-link consistency check).

Both feed into the production cogs (R8 RSSI counter uses R5's top-8 subcarriers; R12 PABS uses R7's per-link consistency check as an adversarial defence layer).

Sample output

=== R5 subcarrier saliency ===
Top 8 most informative subcarriers (out of 56):
  [41, 52, 30, 31, 10, 35, 2, 38]
  Max/mean ratio: 2.85x (band-spread, not band-clustered)

=== R7 mincut adversarial detection ===
Scenario A (no adversary):    detected as compromised: []
Scenario B (link 0 spoofed):  detected as compromised: [0]   ✓
Scenario C (link 2 spoofed):  detected as compromised: [2]   ✓
Scenario D (multi compromised): detected as compromised: [1,3] ✓
Detection rate: 3/3

See also

  • R5 explained by 01-physics-floor/r6_fresnel_zone.py (band-spread = zone-1 occupancy signature)
  • R7 used by 06-structure-detection/r12_pabs_implementation.py and 09-quantum-fusion/
  • Research notes: docs/research/sota-2026-05-22/R5-*.md, R7-*.md