v0.1.0 — research preview: calibrated, certified splat confidence
Pre-release
Pre-release
[Unreleased]
P0 killer property — calibrated, certified, exported per-carrier confidence (2026-07-01 → 2026-07-02)
The successor axis a bare 3DGS/DBS splat lacks: a per-carrier confidence a
downstream engine can trust and prune against with a guarantee. Answers audit
blocker B1 (no demonstrated killer property) and major M3 (confidence was an
uncalibrated heuristic).
Added
- Calibration module
src/aura/calibration.py(CPU / numpy, 10 tests):IsotonicConfidenceCalibrator(PAVA) — monotone map from the raw multi-view
heuristic to a calibrated reliability.conformal_prune_certificate— distribution-free split-conformal risk control
(Hoeffding UCB on retained-set unreliability): the most-inclusive thresholdτ
that keeps mean unreliability ≤εat confidence1−α.selection_quality_curve— downstream demonstrator (retained reliability across
pruning budgets).attach_calibrated_confidence— replaces the heuristic value with the calibrated
one and flagsconfidence_calibrated=True.
aura calibrate-confidence <package> <reliability.npz>CLI, wiring the
calibrated value into export so it ships as the_AURA_CONFIDENCEvendor
attribute in theKHR_gaussian_splattingGLB.- Occlusion-aware reliability label (
--label depth_aware): a per-block
front-surface z-buffer counts a carrier only in held-out views where it is the
visible front surface, fixing the interior-occlusion false-low of the colour label. - OpenUSD 26.03 schema export:
write_usd_gaussian_splat/aura export-usd --schemaemits the officialUsdVolParticleField3DGaussianSplatschema
(usd-core 26.05) with a confidence vendor channel; 3 round-trip tests. Closes
audit item E6/P2 (USD preview previously predated the official schema). - Experiment drivers
experiments/per_carrier_reliability.pyand
experiments/calibrate_confidence.py; per-scene reports
outputs/calib_<scene>{,_depth}.json. - Authoritative write-up
docs/P0_CALIBRATED_CONFIDENCE.mdand the four-scene
figureassets/p0_selection_auc.png(+ its generator
experiments/make_p0_selection_auc_figure.py).
Changed
- Corrected reliability estimator: the robust observed-colour centre is now a
maskednanmedianover each carrier's observed held-out views, replacing an
earlier sentinel-median that poisoned carriers seen in fewer than half the views.
Required for the occlusion-aware label; it supersedes the earlier (2026-07-01)
Truck/Garden colour figures but leaves the headline conclusion unchanged. - README gains a P0 "Calibrated Confidence (killer property)" section; the Current
Status table now reads "validated on 4 real scenes".
Validated (four real scenes)
Truck (129k carriers), Garden (Mip-NeRF-360 outdoor, 120k), Kitchen (indoor, 120k),
Room (indoor, 107k):
- The export-time train-view colour-agreement feature predicts held-out
reliability r = 0.91–0.98 on all four; the shipped view-count heuristic is
uninformative (|r| ≤ 0.13). - Isotonic calibration drops ECE from 0.46–0.59 to 0.0006–0.0016 (~300–900×).
- Selection AUC (mean retained reliability across pruning budgets): calibrated
confidence 0.58–0.72, within 1–4% of the oracle ceiling, beating opacity
(0.37–0.53, at or below random) at every budget; at a 10%-keep budget calibrated
retains 0.77–0.90 vs opacity's 0.31–0.49. - The property survives the occlusion-aware label (within 1–9% of oracle;
corr 0.75–0.97).
Research preview — pre-release, under active development. Full history: CHANGELOG.md.