From 4e879bf62a29270a2611a8a7e715598587d377cc Mon Sep 17 00:00:00 2001 From: rUv Date: Fri, 22 May 2026 07:52:57 -0400 Subject: [PATCH] chore: organise examples/research-sota/ into 9 thematic folders with READMEs (#744) MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- examples/research-sota/{ => 01-physics-floor}/r1_toa_crlb.py | 0 .../research-sota/{ => 01-physics-floor}/r1_toa_crlb_results.json | 0 .../research-sota/{ => 01-physics-floor}/r6_1_multiscatterer.py | 0 .../{ => 01-physics-floor}/r6_1_multiscatterer_results.json | 0 .../research-sota/{ => 01-physics-floor}/r6_fresnel_results.json | 0 examples/research-sota/{ => 01-physics-floor}/r6_fresnel_zone.py | 0 examples/research-sota/{ => 02-placement}/r6_2_1_3d_placement.py | 0 examples/research-sota/{ => 02-placement}/r6_2_1_3d_results.json | 0 .../research-sota/{ => 02-placement}/r6_2_2_1_3d_multistatic.py | 0 .../{ => 02-placement}/r6_2_2_1_3d_multistatic_results.json | 0 .../{ => 02-placement}/r6_2_2_multistatic_placement.py | 0 .../{ => 02-placement}/r6_2_2_multistatic_results.json | 0 examples/research-sota/{ => 02-placement}/r6_2_3_chest_centric.py | 0 .../{ => 02-placement}/r6_2_3_chest_centric_results.json | 0 .../{ => 02-placement}/r6_2_4_3d_chest_multistatic.py | 0 .../research-sota/{ => 02-placement}/r6_2_4_3d_chest_results.json | 0 examples/research-sota/{ => 02-placement}/r6_2_5_multi_subject.py | 0 .../{ => 02-placement}/r6_2_5_multi_subject_results.json | 0 .../research-sota/{ => 02-placement}/r6_2_antenna_placement.py | 0 .../research-sota/{ => 02-placement}/r6_2_placement_results.json | 0 .../{ => 03-spatial-intelligence}/r5_subcarrier_saliency.py | 0 .../{ => 03-spatial-intelligence}/r7_multilink_consistency.py | 0 .../r7_multilink_consistency_results.json | 0 examples/research-sota/{ => 04-rssi}/r8_rssi_only_count.py | 0 examples/research-sota/{ => 04-rssi}/r8_rssi_only_results.json | 0 examples/research-sota/{ => 04-rssi}/r9_rssi_fingerprint_knn.py | 0 .../research-sota/{ => 04-rssi}/r9_rssi_fingerprint_results.json | 0 .../{ => 05-cross-room-reid}/r3_1_physics_env_results.json | 0 .../{ => 05-cross-room-reid}/r3_1_physics_informed_env.py | 0 .../{ => 05-cross-room-reid}/r3_2_embedding_physics_env.py | 0 .../{ => 05-cross-room-reid}/r3_2_embedding_results.json | 0 .../research-sota/{ => 05-cross-room-reid}/r3_crossroom_reid.py | 0 .../research-sota/{ => 05-cross-room-reid}/r3_reid_results.json | 0 .../{ => 06-structure-detection}/r12_1_pose_pabs_loop.py | 0 .../{ => 06-structure-detection}/r12_1_pose_pabs_results.json | 0 .../{ => 06-structure-detection}/r12_pabs_implementation.py | 0 .../{ => 06-structure-detection}/r12_pabs_results.json | 0 .../{ => 06-structure-detection}/r12_rf_weather_eigenshift.py | 0 .../{ => 06-structure-detection}/r12_rf_weather_results.json | 0 .../{ => 07-negative-results}/r13_bp_physics_floor.py | 0 .../research-sota/{ => 07-negative-results}/r13_bp_results.json | 0 .../research-sota/{ => 08-verticals}/r10_foliage_attenuation.py | 0 .../research-sota/{ => 08-verticals}/r10_foliage_results.json | 0 .../research-sota/{ => 08-verticals}/r11_maritime_propagation.py | 0 .../research-sota/{ => 08-verticals}/r11_maritime_results.json | 0 .../{ => 09-quantum-fusion}/r20_1_fusion_results.json | 0 .../{ => 09-quantum-fusion}/r20_1_quantum_classical_fusion.py | 0 47 files changed, 0 insertions(+), 0 deletions(-) rename examples/research-sota/{ => 01-physics-floor}/r1_toa_crlb.py (100%) rename examples/research-sota/{ => 01-physics-floor}/r1_toa_crlb_results.json (100%) rename examples/research-sota/{ => 01-physics-floor}/r6_1_multiscatterer.py (100%) rename examples/research-sota/{ => 01-physics-floor}/r6_1_multiscatterer_results.json (100%) rename examples/research-sota/{ => 01-physics-floor}/r6_fresnel_results.json (100%) rename examples/research-sota/{ => 01-physics-floor}/r6_fresnel_zone.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_1_3d_placement.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_1_3d_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_2_1_3d_multistatic.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_2_1_3d_multistatic_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_2_multistatic_placement.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_2_multistatic_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_3_chest_centric.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_3_chest_centric_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_4_3d_chest_multistatic.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_4_3d_chest_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_5_multi_subject.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_5_multi_subject_results.json (100%) rename examples/research-sota/{ => 02-placement}/r6_2_antenna_placement.py (100%) rename examples/research-sota/{ => 02-placement}/r6_2_placement_results.json (100%) rename examples/research-sota/{ => 03-spatial-intelligence}/r5_subcarrier_saliency.py (100%) rename examples/research-sota/{ => 03-spatial-intelligence}/r7_multilink_consistency.py (100%) rename examples/research-sota/{ => 03-spatial-intelligence}/r7_multilink_consistency_results.json (100%) rename examples/research-sota/{ => 04-rssi}/r8_rssi_only_count.py (100%) rename examples/research-sota/{ => 04-rssi}/r8_rssi_only_results.json (100%) rename examples/research-sota/{ => 04-rssi}/r9_rssi_fingerprint_knn.py (100%) rename examples/research-sota/{ => 04-rssi}/r9_rssi_fingerprint_results.json (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_1_physics_env_results.json (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_1_physics_informed_env.py (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_2_embedding_physics_env.py (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_2_embedding_results.json (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_crossroom_reid.py (100%) rename examples/research-sota/{ => 05-cross-room-reid}/r3_reid_results.json (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_1_pose_pabs_loop.py (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_1_pose_pabs_results.json (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_pabs_implementation.py (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_pabs_results.json (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_rf_weather_eigenshift.py (100%) rename examples/research-sota/{ => 06-structure-detection}/r12_rf_weather_results.json (100%) rename examples/research-sota/{ => 07-negative-results}/r13_bp_physics_floor.py (100%) rename examples/research-sota/{ => 07-negative-results}/r13_bp_results.json (100%) rename examples/research-sota/{ => 08-verticals}/r10_foliage_attenuation.py (100%) rename examples/research-sota/{ => 08-verticals}/r10_foliage_results.json (100%) rename examples/research-sota/{ => 08-verticals}/r11_maritime_propagation.py (100%) rename examples/research-sota/{ => 08-verticals}/r11_maritime_results.json (100%) rename examples/research-sota/{ => 09-quantum-fusion}/r20_1_fusion_results.json (100%) rename examples/research-sota/{ => 09-quantum-fusion}/r20_1_quantum_classical_fusion.py (100%) diff --git a/examples/research-sota/r1_toa_crlb.py b/examples/research-sota/01-physics-floor/r1_toa_crlb.py similarity index 100% rename from examples/research-sota/r1_toa_crlb.py rename to examples/research-sota/01-physics-floor/r1_toa_crlb.py diff --git a/examples/research-sota/r1_toa_crlb_results.json b/examples/research-sota/01-physics-floor/r1_toa_crlb_results.json similarity index 100% rename from examples/research-sota/r1_toa_crlb_results.json rename to examples/research-sota/01-physics-floor/r1_toa_crlb_results.json diff --git a/examples/research-sota/r6_1_multiscatterer.py b/examples/research-sota/01-physics-floor/r6_1_multiscatterer.py similarity index 100% rename from examples/research-sota/r6_1_multiscatterer.py rename to examples/research-sota/01-physics-floor/r6_1_multiscatterer.py diff --git a/examples/research-sota/r6_1_multiscatterer_results.json b/examples/research-sota/01-physics-floor/r6_1_multiscatterer_results.json similarity index 100% rename from examples/research-sota/r6_1_multiscatterer_results.json rename to examples/research-sota/01-physics-floor/r6_1_multiscatterer_results.json diff --git a/examples/research-sota/r6_fresnel_results.json b/examples/research-sota/01-physics-floor/r6_fresnel_results.json similarity index 100% rename from examples/research-sota/r6_fresnel_results.json rename to examples/research-sota/01-physics-floor/r6_fresnel_results.json diff --git a/examples/research-sota/r6_fresnel_zone.py b/examples/research-sota/01-physics-floor/r6_fresnel_zone.py similarity index 100% rename from examples/research-sota/r6_fresnel_zone.py rename to examples/research-sota/01-physics-floor/r6_fresnel_zone.py diff --git a/examples/research-sota/r6_2_1_3d_placement.py b/examples/research-sota/02-placement/r6_2_1_3d_placement.py similarity index 100% rename from examples/research-sota/r6_2_1_3d_placement.py rename to examples/research-sota/02-placement/r6_2_1_3d_placement.py diff --git a/examples/research-sota/r6_2_1_3d_results.json b/examples/research-sota/02-placement/r6_2_1_3d_results.json similarity index 100% rename from examples/research-sota/r6_2_1_3d_results.json rename to examples/research-sota/02-placement/r6_2_1_3d_results.json diff --git a/examples/research-sota/r6_2_2_1_3d_multistatic.py b/examples/research-sota/02-placement/r6_2_2_1_3d_multistatic.py similarity index 100% rename from examples/research-sota/r6_2_2_1_3d_multistatic.py rename to examples/research-sota/02-placement/r6_2_2_1_3d_multistatic.py diff --git a/examples/research-sota/r6_2_2_1_3d_multistatic_results.json b/examples/research-sota/02-placement/r6_2_2_1_3d_multistatic_results.json similarity index 100% rename from examples/research-sota/r6_2_2_1_3d_multistatic_results.json rename to examples/research-sota/02-placement/r6_2_2_1_3d_multistatic_results.json diff --git a/examples/research-sota/r6_2_2_multistatic_placement.py b/examples/research-sota/02-placement/r6_2_2_multistatic_placement.py similarity index 100% rename from examples/research-sota/r6_2_2_multistatic_placement.py rename to examples/research-sota/02-placement/r6_2_2_multistatic_placement.py diff --git a/examples/research-sota/r6_2_2_multistatic_results.json b/examples/research-sota/02-placement/r6_2_2_multistatic_results.json similarity index 100% rename from examples/research-sota/r6_2_2_multistatic_results.json rename to examples/research-sota/02-placement/r6_2_2_multistatic_results.json diff --git a/examples/research-sota/r6_2_3_chest_centric.py b/examples/research-sota/02-placement/r6_2_3_chest_centric.py similarity index 100% rename from examples/research-sota/r6_2_3_chest_centric.py rename to examples/research-sota/02-placement/r6_2_3_chest_centric.py diff --git a/examples/research-sota/r6_2_3_chest_centric_results.json b/examples/research-sota/02-placement/r6_2_3_chest_centric_results.json similarity index 100% rename from examples/research-sota/r6_2_3_chest_centric_results.json rename to examples/research-sota/02-placement/r6_2_3_chest_centric_results.json diff --git a/examples/research-sota/r6_2_4_3d_chest_multistatic.py b/examples/research-sota/02-placement/r6_2_4_3d_chest_multistatic.py similarity index 100% rename from examples/research-sota/r6_2_4_3d_chest_multistatic.py rename to examples/research-sota/02-placement/r6_2_4_3d_chest_multistatic.py diff --git a/examples/research-sota/r6_2_4_3d_chest_results.json b/examples/research-sota/02-placement/r6_2_4_3d_chest_results.json similarity index 100% rename from examples/research-sota/r6_2_4_3d_chest_results.json rename to examples/research-sota/02-placement/r6_2_4_3d_chest_results.json diff --git a/examples/research-sota/r6_2_5_multi_subject.py b/examples/research-sota/02-placement/r6_2_5_multi_subject.py similarity index 100% rename from examples/research-sota/r6_2_5_multi_subject.py rename to examples/research-sota/02-placement/r6_2_5_multi_subject.py diff --git a/examples/research-sota/r6_2_5_multi_subject_results.json b/examples/research-sota/02-placement/r6_2_5_multi_subject_results.json similarity index 100% rename from examples/research-sota/r6_2_5_multi_subject_results.json rename to examples/research-sota/02-placement/r6_2_5_multi_subject_results.json diff --git a/examples/research-sota/r6_2_antenna_placement.py b/examples/research-sota/02-placement/r6_2_antenna_placement.py similarity index 100% rename from examples/research-sota/r6_2_antenna_placement.py rename to examples/research-sota/02-placement/r6_2_antenna_placement.py diff --git a/examples/research-sota/r6_2_placement_results.json b/examples/research-sota/02-placement/r6_2_placement_results.json similarity index 100% rename from examples/research-sota/r6_2_placement_results.json rename to examples/research-sota/02-placement/r6_2_placement_results.json diff --git a/examples/research-sota/r5_subcarrier_saliency.py b/examples/research-sota/03-spatial-intelligence/r5_subcarrier_saliency.py similarity index 100% rename from examples/research-sota/r5_subcarrier_saliency.py rename to examples/research-sota/03-spatial-intelligence/r5_subcarrier_saliency.py diff --git a/examples/research-sota/r7_multilink_consistency.py b/examples/research-sota/03-spatial-intelligence/r7_multilink_consistency.py similarity index 100% rename from examples/research-sota/r7_multilink_consistency.py rename to examples/research-sota/03-spatial-intelligence/r7_multilink_consistency.py diff --git a/examples/research-sota/r7_multilink_consistency_results.json b/examples/research-sota/03-spatial-intelligence/r7_multilink_consistency_results.json similarity index 100% rename from examples/research-sota/r7_multilink_consistency_results.json rename to examples/research-sota/03-spatial-intelligence/r7_multilink_consistency_results.json diff --git a/examples/research-sota/r8_rssi_only_count.py b/examples/research-sota/04-rssi/r8_rssi_only_count.py similarity index 100% rename from examples/research-sota/r8_rssi_only_count.py rename to examples/research-sota/04-rssi/r8_rssi_only_count.py diff --git a/examples/research-sota/r8_rssi_only_results.json b/examples/research-sota/04-rssi/r8_rssi_only_results.json similarity index 100% rename from examples/research-sota/r8_rssi_only_results.json rename to examples/research-sota/04-rssi/r8_rssi_only_results.json diff --git a/examples/research-sota/r9_rssi_fingerprint_knn.py b/examples/research-sota/04-rssi/r9_rssi_fingerprint_knn.py similarity index 100% rename from examples/research-sota/r9_rssi_fingerprint_knn.py rename to examples/research-sota/04-rssi/r9_rssi_fingerprint_knn.py diff --git a/examples/research-sota/r9_rssi_fingerprint_results.json b/examples/research-sota/04-rssi/r9_rssi_fingerprint_results.json similarity index 100% rename from examples/research-sota/r9_rssi_fingerprint_results.json rename to examples/research-sota/04-rssi/r9_rssi_fingerprint_results.json diff --git a/examples/research-sota/r3_1_physics_env_results.json b/examples/research-sota/05-cross-room-reid/r3_1_physics_env_results.json similarity index 100% rename from examples/research-sota/r3_1_physics_env_results.json rename to examples/research-sota/05-cross-room-reid/r3_1_physics_env_results.json diff --git a/examples/research-sota/r3_1_physics_informed_env.py b/examples/research-sota/05-cross-room-reid/r3_1_physics_informed_env.py similarity index 100% rename from examples/research-sota/r3_1_physics_informed_env.py rename to examples/research-sota/05-cross-room-reid/r3_1_physics_informed_env.py diff --git a/examples/research-sota/r3_2_embedding_physics_env.py b/examples/research-sota/05-cross-room-reid/r3_2_embedding_physics_env.py similarity index 100% rename from examples/research-sota/r3_2_embedding_physics_env.py rename to examples/research-sota/05-cross-room-reid/r3_2_embedding_physics_env.py diff --git a/examples/research-sota/r3_2_embedding_results.json b/examples/research-sota/05-cross-room-reid/r3_2_embedding_results.json similarity index 100% rename from examples/research-sota/r3_2_embedding_results.json rename to examples/research-sota/05-cross-room-reid/r3_2_embedding_results.json diff --git a/examples/research-sota/r3_crossroom_reid.py b/examples/research-sota/05-cross-room-reid/r3_crossroom_reid.py similarity index 100% rename from examples/research-sota/r3_crossroom_reid.py rename to examples/research-sota/05-cross-room-reid/r3_crossroom_reid.py diff --git a/examples/research-sota/r3_reid_results.json b/examples/research-sota/05-cross-room-reid/r3_reid_results.json similarity index 100% rename from examples/research-sota/r3_reid_results.json rename to examples/research-sota/05-cross-room-reid/r3_reid_results.json diff --git a/examples/research-sota/r12_1_pose_pabs_loop.py b/examples/research-sota/06-structure-detection/r12_1_pose_pabs_loop.py similarity index 100% rename from examples/research-sota/r12_1_pose_pabs_loop.py rename to examples/research-sota/06-structure-detection/r12_1_pose_pabs_loop.py diff --git a/examples/research-sota/r12_1_pose_pabs_results.json b/examples/research-sota/06-structure-detection/r12_1_pose_pabs_results.json similarity index 100% rename from examples/research-sota/r12_1_pose_pabs_results.json rename to examples/research-sota/06-structure-detection/r12_1_pose_pabs_results.json diff --git a/examples/research-sota/r12_pabs_implementation.py b/examples/research-sota/06-structure-detection/r12_pabs_implementation.py similarity index 100% rename from examples/research-sota/r12_pabs_implementation.py rename to examples/research-sota/06-structure-detection/r12_pabs_implementation.py diff --git a/examples/research-sota/r12_pabs_results.json b/examples/research-sota/06-structure-detection/r12_pabs_results.json similarity index 100% rename from examples/research-sota/r12_pabs_results.json rename to examples/research-sota/06-structure-detection/r12_pabs_results.json diff --git a/examples/research-sota/r12_rf_weather_eigenshift.py b/examples/research-sota/06-structure-detection/r12_rf_weather_eigenshift.py similarity index 100% rename from examples/research-sota/r12_rf_weather_eigenshift.py rename to examples/research-sota/06-structure-detection/r12_rf_weather_eigenshift.py diff --git a/examples/research-sota/r12_rf_weather_results.json b/examples/research-sota/06-structure-detection/r12_rf_weather_results.json similarity index 100% rename from examples/research-sota/r12_rf_weather_results.json rename to examples/research-sota/06-structure-detection/r12_rf_weather_results.json diff --git a/examples/research-sota/r13_bp_physics_floor.py b/examples/research-sota/07-negative-results/r13_bp_physics_floor.py similarity index 100% rename from examples/research-sota/r13_bp_physics_floor.py rename to examples/research-sota/07-negative-results/r13_bp_physics_floor.py diff --git a/examples/research-sota/r13_bp_results.json b/examples/research-sota/07-negative-results/r13_bp_results.json similarity index 100% rename from examples/research-sota/r13_bp_results.json rename to examples/research-sota/07-negative-results/r13_bp_results.json diff --git a/examples/research-sota/r10_foliage_attenuation.py b/examples/research-sota/08-verticals/r10_foliage_attenuation.py similarity index 100% rename from examples/research-sota/r10_foliage_attenuation.py rename to examples/research-sota/08-verticals/r10_foliage_attenuation.py diff --git a/examples/research-sota/r10_foliage_results.json b/examples/research-sota/08-verticals/r10_foliage_results.json similarity index 100% rename from examples/research-sota/r10_foliage_results.json rename to examples/research-sota/08-verticals/r10_foliage_results.json diff --git a/examples/research-sota/r11_maritime_propagation.py b/examples/research-sota/08-verticals/r11_maritime_propagation.py similarity index 100% rename from examples/research-sota/r11_maritime_propagation.py rename to examples/research-sota/08-verticals/r11_maritime_propagation.py diff --git a/examples/research-sota/r11_maritime_results.json b/examples/research-sota/08-verticals/r11_maritime_results.json similarity index 100% rename from examples/research-sota/r11_maritime_results.json rename to examples/research-sota/08-verticals/r11_maritime_results.json diff --git a/examples/research-sota/r20_1_fusion_results.json b/examples/research-sota/09-quantum-fusion/r20_1_fusion_results.json similarity index 100% rename from examples/research-sota/r20_1_fusion_results.json rename to examples/research-sota/09-quantum-fusion/r20_1_fusion_results.json diff --git a/examples/research-sota/r20_1_quantum_classical_fusion.py b/examples/research-sota/09-quantum-fusion/r20_1_quantum_classical_fusion.py similarity index 100% rename from examples/research-sota/r20_1_quantum_classical_fusion.py rename to examples/research-sota/09-quantum-fusion/r20_1_quantum_classical_fusion.py