chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744)

Browse Source

User request: organise examples/research-sota/ into folders with READMEs and main overview.

Moved 46 files into 9 thematic folders by thread family + research category:

01-physics-floor/      (R1, R6, R6.1) — bedrock primitives
02-placement/          (R6.2 family, 7 sub-ticks) — antenna placement
03-spatial-intelligence/ (R5, R7) — saliency + mincut
04-rssi/               (R8, R9) — RSSI-only sensing
05-cross-room-reid/    (R3 arc, 3 ticks) — cross-room identity
06-structure-detection/ (R12 arc, 3 ticks) — PABS + closed loop
07-negative-results/   (R13) — productive failure
08-verticals/          (R10, R11) — wildlife + maritime physics
09-quantum-fusion/     (R20.1) — ADR-114 quantum-classical demo

Each folder has its own README.md documenting:
- Scripts + headlines table
- Why this folder bounds / composes with others
- Sample output / honest scope
- Cross-references to related loop notes + ADRs

Main README.md at the top covers:
- Folder map with thread numbers
- Cross-folder dependency graph
- Headline findings table (8 entries)
- Reading order for newcomers (4 scripts in suggested order)
- Honest scope (synthetic-physics caveats)

All git mv operations preserve file history. Total: 46 files moved, 10
new READMEs (main + 9 sub) totalling ~1300 lines of organising
documentation.

...

This commit is contained in:

rUv authored and GitHub committed 2026-05-22 07:52:57 -04:00

1 parent 759b487a82

commit 4e879bf62a

47 files changed

Show all changes Ignore whitespace when comparing lines Ignore changes in amount of whitespace Ignore changes in whitespace at EOL

Download Patch File Download Diff File Expand all files Collapse all files

No files matched your search

examples/research-sota/r1_toa_crlb.py → examples/research-sota/01-physics-floor/r1_toa_crlb.py

File renamed without changes.

examples/research-sota/r1_toa_crlb_results.json → examples/research-sota/01-physics-floor/r1_toa_crlb_results.json

File renamed without changes.

examples/research-sota/r6_1_multiscatterer.py → examples/research-sota/01-physics-floor/r6_1_multiscatterer.py

File renamed without changes.

examples/research-sota/r6_1_multiscatterer_results.json → examples/research-sota/01-physics-floor/r6_1_multiscatterer_results.json

File renamed without changes.

examples/research-sota/r6_fresnel_results.json → examples/research-sota/01-physics-floor/r6_fresnel_results.json

File renamed without changes.

examples/research-sota/r6_fresnel_zone.py → examples/research-sota/01-physics-floor/r6_fresnel_zone.py

File renamed without changes.

examples/research-sota/r6_2_1_3d_placement.py → examples/research-sota/02-placement/r6_2_1_3d_placement.py

File renamed without changes.

examples/research-sota/r6_2_1_3d_results.json → examples/research-sota/02-placement/r6_2_1_3d_results.json

File renamed without changes.

examples/research-sota/r6_2_2_1_3d_multistatic.py → examples/research-sota/02-placement/r6_2_2_1_3d_multistatic.py

File renamed without changes.

examples/research-sota/r6_2_2_1_3d_multistatic_results.json → examples/research-sota/02-placement/r6_2_2_1_3d_multistatic_results.json

File renamed without changes.

examples/research-sota/r6_2_2_multistatic_placement.py → examples/research-sota/02-placement/r6_2_2_multistatic_placement.py

File renamed without changes.

examples/research-sota/r6_2_2_multistatic_results.json → examples/research-sota/02-placement/r6_2_2_multistatic_results.json

File renamed without changes.

examples/research-sota/r6_2_3_chest_centric.py → examples/research-sota/02-placement/r6_2_3_chest_centric.py

File renamed without changes.

examples/research-sota/r6_2_3_chest_centric_results.json → examples/research-sota/02-placement/r6_2_3_chest_centric_results.json

File renamed without changes.

examples/research-sota/r6_2_4_3d_chest_multistatic.py → examples/research-sota/02-placement/r6_2_4_3d_chest_multistatic.py

File renamed without changes.

examples/research-sota/r6_2_4_3d_chest_results.json → examples/research-sota/02-placement/r6_2_4_3d_chest_results.json

File renamed without changes.

examples/research-sota/r6_2_5_multi_subject.py → examples/research-sota/02-placement/r6_2_5_multi_subject.py

File renamed without changes.

examples/research-sota/r6_2_5_multi_subject_results.json → examples/research-sota/02-placement/r6_2_5_multi_subject_results.json

File renamed without changes.

examples/research-sota/r6_2_antenna_placement.py → examples/research-sota/02-placement/r6_2_antenna_placement.py

File renamed without changes.

examples/research-sota/r6_2_placement_results.json → examples/research-sota/02-placement/r6_2_placement_results.json

File renamed without changes.

examples/research-sota/r5_subcarrier_saliency.py → examples/research-sota/03-spatial-intelligence/r5_subcarrier_saliency.py

File renamed without changes.

examples/research-sota/r7_multilink_consistency.py → examples/research-sota/03-spatial-intelligence/r7_multilink_consistency.py

File renamed without changes.

examples/research-sota/r7_multilink_consistency_results.json → examples/research-sota/03-spatial-intelligence/r7_multilink_consistency_results.json

File renamed without changes.

examples/research-sota/r8_rssi_only_count.py → examples/research-sota/04-rssi/r8_rssi_only_count.py

File renamed without changes.

examples/research-sota/r8_rssi_only_results.json → examples/research-sota/04-rssi/r8_rssi_only_results.json

File renamed without changes.

examples/research-sota/r9_rssi_fingerprint_knn.py → examples/research-sota/04-rssi/r9_rssi_fingerprint_knn.py

File renamed without changes.

examples/research-sota/r9_rssi_fingerprint_results.json → examples/research-sota/04-rssi/r9_rssi_fingerprint_results.json

File renamed without changes.

examples/research-sota/r3_1_physics_env_results.json → examples/research-sota/05-cross-room-reid/r3_1_physics_env_results.json

File renamed without changes.

examples/research-sota/r3_1_physics_informed_env.py → examples/research-sota/05-cross-room-reid/r3_1_physics_informed_env.py

File renamed without changes.

examples/research-sota/r3_2_embedding_physics_env.py → examples/research-sota/05-cross-room-reid/r3_2_embedding_physics_env.py

File renamed without changes.

examples/research-sota/r3_2_embedding_results.json → examples/research-sota/05-cross-room-reid/r3_2_embedding_results.json

File renamed without changes.

examples/research-sota/r3_crossroom_reid.py → examples/research-sota/05-cross-room-reid/r3_crossroom_reid.py

File renamed without changes.

examples/research-sota/r3_reid_results.json → examples/research-sota/05-cross-room-reid/r3_reid_results.json

File renamed without changes.

examples/research-sota/r12_1_pose_pabs_loop.py → examples/research-sota/06-structure-detection/r12_1_pose_pabs_loop.py

File renamed without changes.

examples/research-sota/r12_1_pose_pabs_results.json → examples/research-sota/06-structure-detection/r12_1_pose_pabs_results.json

File renamed without changes.

examples/research-sota/r12_pabs_implementation.py → examples/research-sota/06-structure-detection/r12_pabs_implementation.py

File renamed without changes.

examples/research-sota/r12_pabs_results.json → examples/research-sota/06-structure-detection/r12_pabs_results.json

File renamed without changes.

examples/research-sota/r12_rf_weather_eigenshift.py → examples/research-sota/06-structure-detection/r12_rf_weather_eigenshift.py

File renamed without changes.

examples/research-sota/r12_rf_weather_results.json → examples/research-sota/06-structure-detection/r12_rf_weather_results.json

File renamed without changes.

examples/research-sota/r13_bp_physics_floor.py → examples/research-sota/07-negative-results/r13_bp_physics_floor.py

File renamed without changes.

examples/research-sota/r13_bp_results.json → examples/research-sota/07-negative-results/r13_bp_results.json

File renamed without changes.

examples/research-sota/r10_foliage_attenuation.py → examples/research-sota/08-verticals/r10_foliage_attenuation.py

File renamed without changes.

examples/research-sota/r10_foliage_results.json → examples/research-sota/08-verticals/r10_foliage_results.json

File renamed without changes.

examples/research-sota/r11_maritime_propagation.py → examples/research-sota/08-verticals/r11_maritime_propagation.py

File renamed without changes.

examples/research-sota/r11_maritime_results.json → examples/research-sota/08-verticals/r11_maritime_results.json

File renamed without changes.

examples/research-sota/r20_1_fusion_results.json → examples/research-sota/09-quantum-fusion/r20_1_fusion_results.json

File renamed without changes.

examples/research-sota/r20_1_quantum_classical_fusion.py → examples/research-sota/09-quantum-fusion/r20_1_quantum_classical_fusion.py

File renamed without changes.