1 rollouts.presentation.s2

rollouts.presentation.s2

Canonical Plotly construction for target-frame spherical rollout evidence.

The factual reducer remains in aria_nbv.rollouts.inspection, while aria_nbv.rollouts.inspection.s2 owns configured store acquisition. This module owns only deterministic visual encoding. Streamlit and immutable thesis reporting consume its Plotly specifications through the shared report snapshot instead of defining plots in either presentation adapter.

1.1 Functions

Name Description
s2_direction_figure Build one canonical target-frame :math:S^2 evidence figure.

1.1.1 s2_direction_figure

rollouts.presentation.s2.s2_direction_figure(
    payload,
    *,
    channel,
    template='plotly_white',
    font_family='Arial',
    surface_colorscale='Cividis',
    rollout_colorscale='Turbo',
    title_suffix='',
)

Build one canonical target-frame :math:S^2 evidence figure.

Surface colour encodes the complete equal-solid-angle histogram. The bounded incidence overlay preserves factual rollout index :math:j and persisted step index :math:t: continuous colour identifies rollout-chain heritage and marker symbol identifies acquisition time. The overlay is a display reservoir and never replaces the complete counts.

1.1.1.1 Parameters

Name Type Description Default
payload Mapping[str, Any] Serialized :class:~aria_nbv.rollouts.inspection.S2DirectionHistogram, including synchronized projection-provenance arrays. required
channel S2Channel "movement" for :math:\widehat{\boldsymbol{\delta}}_{j,t}^{e}, "view_direction" for :math:\widehat{\boldsymbol{v}}_{j,t}^{e}, or "frustum" for calibrated proxy-surface support :math:\mathcal{F}_{j,t}^{e}. required
template str Plotly template shared by interactive and static reporting. 'plotly_white'
font_family str Font family recorded in the canonical Plotly layout. 'Arial'
surface_colorscale str Sequential scale for complete per-cell counts. 'Cividis'
rollout_colorscale str Continuous scale for rollout-chain incidence. 'Turbo'
title_suffix str Optional provenance label appended to the scientific channel title. ''

1.1.1.2 Returns

Name Type Description
go.Figure A WebGL Plotly figure over the target-object basis
go.Figure math:(x^e,y^e,z^e).

1.1.1.3 Raises

Name Type Description
ValueError If the channel is unknown or projection/count arrays violate their synchronized shape contract.
Back to top