1 rollouts.inspection.s2

rollouts.inspection.s2

Acquire and fingerprint target-frame spherical evidence from rollout stores.

This module is the presentation-free seam for S2 diagnostics. It owns the validated analysis configuration, rollout-store opening, complete-population reduction, and canonical evidence digest. Plot construction belongs to aria_nbv.rollouts.presentation.s2; Streamlit and immutable reporting consume the same acquired evidence without reopening or reimplementing the reducer.

1.1 Classes

Name Description
S2AnalysisConfig Configure complete target-frame S2 reduction and bounded overlays.
S2StoreEvidence One immutable rollout store’s analyzed spherical evidence.

1.1.1 S2AnalysisConfig

rollouts.inspection.s2.S2AnalysisConfig()

Configure complete target-frame S2 reduction and bounded overlays.

1.1.1.1 Attributes

Name Description
azimuth_bins Number of uniform target-frame azimuth cells.
elevation_bins Number of uniform target-frame z cells, yielding equal solid angle.
projection_limit Maximum deterministic incidence points retained per channel and store.

1.1.2 S2StoreEvidence

rollouts.inspection.s2.S2StoreEvidence(
    slot,
    store_id,
    path,
    config,
    payload,
    payload_sha256,
)

One immutable rollout store’s analyzed spherical evidence.

The payload is the dataclass projection returned by the canonical rollout reducer. payload_sha256 covers its normalized arrays, scalar support, provenance, and exclusions; callers may therefore bind figures and tables to the exact analyzed evidence rather than only to a filesystem path.

1.1.2.1 Attributes

Name Description
slot One-based deterministic store slot within a report acquisition.
store_id Persisted rollout manifest SHA-256 identifying the immutable store.
path Resolved rollout Zarr directory used for this acquisition.
config Validated reducer configuration frozen with the evidence.
payload Serialized S2DirectionHistogram.
payload_sha256 SHA-256 of canonical_s2_payload for payload.

1.2 Functions

Name Description
acquire_s2_store_evidence Open one immutable store and execute the canonical S2 reducer once.
canonical_s2_payload Serialize one reducer result for immutable source identity.

1.2.1 acquire_s2_store_evidence

rollouts.inspection.s2.acquire_s2_store_evidence(path, *, slot, config)

Open one immutable store and execute the canonical S2 reducer once.

1.2.1.1 Parameters

Name Type Description Default
path Path Rollout Zarr directory. The strict reader and manifest projection validate persisted structure before analysis. required
slot int One-based stable report slot assigned by the caller’s sorted source population. required
config S2AnalysisConfig Complete-count binning and display-reservoir configuration. required

1.2.1.2 Returns

Name Type Description
S2StoreEvidence Acquired evidence with resolved source identity, serialized reducer
S2StoreEvidence output, and a canonical payload digest.

1.2.2 canonical_s2_payload

rollouts.inspection.s2.canonical_s2_payload(payload)

Serialize one reducer result for immutable source identity.

Back to top