Skip to content

Commit 57bef13

Browse files
authored
Merge pull request #476 from AdaWorldAPI/claude/splat-native-adr-024-callout
docs(splat-native): D-SPLAT-4 ADR-024 adoption callout (symmetric to cesium-osm §11)
2 parents 10eb41a + 7d09f75 commit 57bef13

1 file changed

Lines changed: 10 additions & 1 deletion

File tree

.claude/plans/splat-native-ultrasound-v1.md

Lines changed: 10 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -152,7 +152,16 @@ The palette codec is currently `(centroid_palette: u8, edge_weight: u8, scent: u
152152

153153
**Compose-table size doubles** (from 256×256×1 B to 256×256×2 B) — still fits in 128 KB, still L1-resident.
154154

155-
**Tests:** palette compose against ground-truth Gaussians; SH-basis discrimination (cosine ≥ 0.95 against analytic SH on phantom data).
155+
**ADR-024 adoption (palette256 + HHTL codec, OGAR #39).** D-SPLAT-4 is named in `OGAR/docs/ARCHITECTURAL-DECISIONS-2026-06-04.md § ADR-024 Consequences` as one of the two queued ADR-024 adopters (paired with D-OSM-2 — see `cesium-osm-substrate-v1.md §11` for the geographic-side adoption note). Mapping ADR-024's four-step adoption checklist onto D-SPLAT-4:
156+
157+
1. **Prefix.** FMA NiblePath + SH basis-id — the per-region spatial frame (FMA class identity within the atlas + SH basis index spanning the ℓ≤3 carrier).
158+
2. **Palette domain.** Quantized SH coefficients (16 coefficients spanning ℓ≤3 — degree 0: 1, degree 1: 3, degree 2: 5, degree 3: 7 — totaling 16, matching the §3 D-SPLAT-1 carrier shape) clustered per FMA region. Per-region palette captures dominant tissue echo signatures (planar fascia / spherical organ surfaces / Doppler-flow vascular).
159+
3. **ρ-vs-reference target ≥ 0.99**, matching the `lance-graph-arm-discovery` aerial-codebook empirical anchor (ρ = 0.9973 vs cosine). Reference: analytic SH evaluation at the same view direction (the same reference used in the D-SPLAT-4 test plan below). Report empirical ρ on the **first FMA-region palette build** (default region: femur cortical bone — smallest tractable corpus; cf. OGAR PR #30 §6 FMA-bones litmus).
160+
4. **Decode = const-table lookup.** Per-region SH palette is runtime const-table; decode path is zero-allocation. Compile-time HHTL where the palette is shared across regions (e.g. global basis-ID lookup for the 256 SH signatures).
161+
162+
The 256-ceiling escape hatches from ADR-024 apply directly: per-region palettes are the cheapest answer (different FMA region, different 256 SH-signature entries); hierarchical palettes (coarser at OrganSystem level, finer per Bone leaf) mirror the SH ℓ=0/ℓ=1 vs ℓ=2/ℓ=3 split. Palette-64K is reserved for measured-cardinality escalation, not speculation.
163+
164+
**Tests:** palette compose against ground-truth Gaussians; SH-basis discrimination (cosine ≥ 0.95 against analytic SH on phantom data); **NEW: empirical ρ-vs-reference reported on first FMA-region palette build (target ≥ 0.99 per ADR-024 adoption contract)**; per-region palette cardinality distribution (mean / p95 / p99) at FMA region granularity.
156165

157166
**Gates on:** D-SPLAT-1.
158167

0 commit comments

Comments
 (0)