1 pose_generation.config

pose_generation.config

Composable authoring values for mixed candidate center and gaze groups.

1.1 Attributes

Name	Description
CenterConfig	Discriminated center-family authoring accepted by mixed generation.
SampledCenterMode	Center modes whose geometry is produced by the sampled-center kernel.
TargetShellSupportConfig	Discriminated directional support for target-centric shell centers.
ViewJitterConfig	Discriminated residual-orientation support for one gaze variant.

1.2 Classes

Name	Description
ActorFacingCapSupportConfig	Configure rotationally symmetric support about the target-to-actor ray.
AngularBoxSupportConfig	Configure a target-relative azimuth/elevation support box.
BoxViewJitterConfig	Configure independent bounded local-camera yaw, pitch, and roll jitter.
CandidateGazeConfig	Apply one named orientation family to every center in a component.
CandidateMixtureComponentConfig	Configure one center table and its ordered gaze variants.
DistanceScaledTargetOrbitCenterConfig	Configure bilateral orbit centers bounded by the current motion budget.
NoViewJitterConfig	Represent a deterministic gaze with no residual orientation jitter.
PowerSphericalConfig	Select forward-biased power-spherical sampling.
SampledCenterConfig	Configure one sampled candidate-center family in the proposal frame.
SphericalViewJitterConfig	Configure uncapped spherical forward-axis jitter plus bounded roll.
TargetOrbitCenterConfig	Configure bilateral target-relative centers at current horizontal standoff.
TargetShellCenterConfig	Configure an opt-in target-centric spherical-shell center family.
UniformSphereConfig	Select area-uniform directional sampling without inert parameters.

1.2.1 ActorFacingCapSupportConfig

pose_generation.config.ActorFacingCapSupportConfig()

Configure rotationally symmetric support about the target-to-actor ray.

1.2.1.1 Attributes

Name	Description
support_kind	Discriminator for actor-facing spherical-cap support.
half_angle_deg	Cone half-angle about the three-dimensional target-to-actor ray, in degrees.

1.2.2 AngularBoxSupportConfig

pose_generation.config.AngularBoxSupportConfig()

Configure a target-relative azimuth/elevation support box.

1.2.2.1 Attributes

Name	Description
support_kind	Discriminator for world-horizontal angular-box support.
azimuth_half_width_deg	Signed half-width about the target-to-actor horizontal bearing, in degrees.
elevation_min_deg	Minimum world-horizontal elevation in the target-aligned frame, in degrees.
elevation_max_deg	Maximum world-horizontal elevation in the target-aligned frame, in degrees.

1.2.3 BoxViewJitterConfig

pose_generation.config.BoxViewJitterConfig()

Configure independent bounded local-camera yaw, pitch, and roll jitter.

1.2.3.1 Attributes

Name	Description
kind	Discriminator for bounded local-camera angular support.
yaw_half_width_deg	Symmetric local-camera yaw half-width in degrees; seminar default is 60.
pitch_half_width_deg	Symmetric local-camera pitch half-width in degrees; seminar default is 30.
roll_half_width_deg	Symmetric roll half-width about the sampled forward axis, in degrees.

1.2.4 CandidateGazeConfig

pose_generation.config.CandidateGazeConfig()

Apply one named orientation family to every center in a component.

1.2.4.1 Attributes

Name	Description
name	Variant name used only for later-gaze provenance and seed identity.
mode	Base camera orientation family applied before residual jitter.
jitter	Residual local-camera orientation support used during generation.

1.2.4.2 Methods

Name	Description
from_legacy	Validate the retained flat gaze controls into one nested value.

1.2.4.2.1 from_legacy

pose_generation.config.CandidateGazeConfig.from_legacy(
    mode,
    sampling_strategy,
    concentration,
    yaw_half_width_deg,
    pitch_half_width_deg,
    roll_half_width_deg,
    name='primary',
)

Validate the retained flat gaze controls into one nested value.

1.2.5 CandidateMixtureComponentConfig

pose_generation.config.CandidateMixtureComponentConfig()

Configure one center table and its ordered gaze variants.

1.2.5.1 Attributes

Name	Description
name	Stable component name retained as provenance for the first gaze.
count	Number of attempted centers sampled once before gaze expansion.
center	Complete positional proposal configuration for the shared center table.
gazes	Ordered gaze variants; row order is gaze-major within this component.

1.2.5.2 Methods

Name	Description
with_count	Return a fully revalidated component with a replacement count.

1.2.5.2.1 with_count

pose_generation.config.CandidateMixtureComponentConfig.with_count(count)

Return a fully revalidated component with a replacement count.

1.2.6 DistanceScaledTargetOrbitCenterConfig

pose_generation.config.DistanceScaledTargetOrbitCenterConfig()

Configure bilateral orbit centers bounded by the current motion budget.

At every generated state, the sampler measures the current world-horizontal target standoff d and caps the largest orbit angle by the inverse chord relation theta = 2 asin(s / (2 d)) for step budget s. The configured fractions preserve the receipt-backed relative angle spacing while the existing motion and collision rules retain final authority over validity.

1.2.6.1 Attributes

Name	Description
kind	Discriminator for the opt-in motion-bounded target-orbit geometry.
step_budget_m	Maximum desired straight-line center displacement per proposal, in metres.
maximum_angle_deg	Semantic cap on the largest partial-orbit angle, in degrees.
step_margin	Multiplicative numerical margin applied before inverting the chord relation.
positive_angle_fractions	Strictly increasing positive fractions ending at one for angle-bank spacing.
standoff_mode	Recompute bounds from the current committed horizontal target radius.

1.2.7 NoViewJitterConfig

pose_generation.config.NoViewJitterConfig()

Represent a deterministic gaze with no residual orientation jitter.

1.2.7.1 Attributes

Name	Description
kind	Discriminator whose generation meaning is exactly zero residual jitter.

1.2.8 PowerSphericalConfig

pose_generation.config.PowerSphericalConfig()

Select forward-biased power-spherical sampling.

1.2.9 SampledCenterConfig

pose_generation.config.SampledCenterConfig()

Configure one sampled candidate-center family in the proposal frame.

1.2.9.1 Attributes

Name	Description
kind	Discriminator for sampled-center authoring; provenance uses `mode`.
mode	Semantic center family applied in the gravity-aligned proposal frame.
distribution	Distribution used to draw proposal directions before family shaping.
min_radius_m	Minimum sampled displacement from the reference center, in metres.
max_radius_m	Maximum sampled displacement from the reference center, in metres.
min_elevation_deg	Lower world-horizontal elevation bound in degrees, inclusive.
max_elevation_deg	Upper world-horizontal elevation bound in degrees, inclusive.
azimuth_width_deg	Full azimuth support width about proposal-frame forward, in degrees.

1.2.9.2 Methods

Name	Description
from_legacy	Validate retained flat center controls into one nested value.

1.2.9.2.1 from_legacy

pose_generation.config.SampledCenterConfig.from_legacy(
    base,
    *,
    mode,
    min_radius_m=None,
    max_radius_m=None,
)

Validate retained flat center controls into one nested value.

1.2.10 SphericalViewJitterConfig

pose_generation.config.SphericalViewJitterConfig()

Configure uncapped spherical forward-axis jitter plus bounded roll.

1.2.10.1 Attributes

Name	Description
kind	Discriminator for uncapped spherical directional support.
distribution	Closed sphere distribution used to sample the local-camera forward direction.
roll_half_width_deg	Symmetric roll half-width about the sampled forward axis, in degrees.

1.2.11 TargetOrbitCenterConfig

pose_generation.config.TargetOrbitCenterConfig()

Configure bilateral target-relative centers at current horizontal standoff.

1.2.11.1 Attributes

Name	Description
kind	Discriminator for target-orbit authoring; provenance is target orbit.
angles_deg	Ordered signed orbit angles in degrees; both target sides are required.
standoff_mode	Keep each center at the actor’s current world-horizontal target radius.

1.2.12 TargetShellCenterConfig

pose_generation.config.TargetShellCenterConfig()

Configure an opt-in target-centric spherical-shell center family.

1.2.12.1 Attributes

Name	Description
kind	Discriminator for target-shell authoring; provenance is target shell.
radius_min_m	Minimum target-to-candidate radius in metres; equal bounds are valid.
radius_max_m	Maximum target-to-candidate radius in metres; equal bounds are valid.
support	Complete directional support; serialized identity contains only active fields.

1.2.13 UniformSphereConfig

pose_generation.config.UniformSphereConfig()

Select area-uniform directional sampling without inert parameters.

1.3 Functions

Name	Description
sphere_distribution_from_legacy	Validate retained flat distribution controls into one closed value.

1.3.1 sphere_distribution_from_legacy

pose_generation.config.sphere_distribution_from_legacy(strategy, concentration)

Validate retained flat distribution controls into one closed value.

# pose_generation.config { #aria_nbv.pose_generation.config } `pose_generation.config` Composable authoring values for mixed candidate center and gaze groups. ## Attributes | Name | Description | | --- | --- | | [CenterConfig](#aria_nbv.pose_generation.config.CenterConfig) | Discriminated center-family authoring accepted by mixed generation. | | [SampledCenterMode](#aria_nbv.pose_generation.config.SampledCenterMode) | Center modes whose geometry is produced by the sampled-center kernel. | | [TargetShellSupportConfig](#aria_nbv.pose_generation.config.TargetShellSupportConfig) | Discriminated directional support for target-centric shell centers. | | [ViewJitterConfig](#aria_nbv.pose_generation.config.ViewJitterConfig) | Discriminated residual-orientation support for one gaze variant. | ## Classes | Name | Description | | --- | --- | | [ActorFacingCapSupportConfig](#aria_nbv.pose_generation.config.ActorFacingCapSupportConfig) | Configure rotationally symmetric support about the target-to-actor ray. | | [AngularBoxSupportConfig](#aria_nbv.pose_generation.config.AngularBoxSupportConfig) | Configure a target-relative azimuth/elevation support box. | | [BoxViewJitterConfig](#aria_nbv.pose_generation.config.BoxViewJitterConfig) | Configure independent bounded local-camera yaw, pitch, and roll jitter. | | [CandidateGazeConfig](#aria_nbv.pose_generation.config.CandidateGazeConfig) | Apply one named orientation family to every center in a component. | | [CandidateMixtureComponentConfig](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig) | Configure one center table and its ordered gaze variants. | | [DistanceScaledTargetOrbitCenterConfig](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig) | Configure bilateral orbit centers bounded by the current motion budget. | | [NoViewJitterConfig](#aria_nbv.pose_generation.config.NoViewJitterConfig) | Represent a deterministic gaze with no residual orientation jitter. | | [PowerSphericalConfig](#aria_nbv.pose_generation.config.PowerSphericalConfig) | Select forward-biased power-spherical sampling. | | [SampledCenterConfig](#aria_nbv.pose_generation.config.SampledCenterConfig) | Configure one sampled candidate-center family in the proposal frame. | | [SphericalViewJitterConfig](#aria_nbv.pose_generation.config.SphericalViewJitterConfig) | Configure uncapped spherical forward-axis jitter plus bounded roll. | | [TargetOrbitCenterConfig](#aria_nbv.pose_generation.config.TargetOrbitCenterConfig) | Configure bilateral target-relative centers at current horizontal standoff. | | [TargetShellCenterConfig](#aria_nbv.pose_generation.config.TargetShellCenterConfig) | Configure an opt-in target-centric spherical-shell center family. | | [UniformSphereConfig](#aria_nbv.pose_generation.config.UniformSphereConfig) | Select area-uniform directional sampling without inert parameters. | ### ActorFacingCapSupportConfig { #aria_nbv.pose_generation.config.ActorFacingCapSupportConfig } ```python pose_generation.config.ActorFacingCapSupportConfig() ``` Configure rotationally symmetric support about the target-to-actor ray. #### Attributes | Name | Description | | --- | --- | | [support_kind](#aria_nbv.pose_generation.config.ActorFacingCapSupportConfig.support_kind) | Discriminator for actor-facing spherical-cap support. | | [half_angle_deg](#aria_nbv.pose_generation.config.ActorFacingCapSupportConfig.half_angle_deg) | Cone half-angle about the three-dimensional target-to-actor ray, in degrees. | ### AngularBoxSupportConfig { #aria_nbv.pose_generation.config.AngularBoxSupportConfig } ```python pose_generation.config.AngularBoxSupportConfig() ``` Configure a target-relative azimuth/elevation support box. #### Attributes | Name | Description | | --- | --- | | [support_kind](#aria_nbv.pose_generation.config.AngularBoxSupportConfig.support_kind) | Discriminator for world-horizontal angular-box support. | | [azimuth_half_width_deg](#aria_nbv.pose_generation.config.AngularBoxSupportConfig.azimuth_half_width_deg) | Signed half-width about the target-to-actor horizontal bearing, in degrees. | | [elevation_min_deg](#aria_nbv.pose_generation.config.AngularBoxSupportConfig.elevation_min_deg) | Minimum world-horizontal elevation in the target-aligned frame, in degrees. | | [elevation_max_deg](#aria_nbv.pose_generation.config.AngularBoxSupportConfig.elevation_max_deg) | Maximum world-horizontal elevation in the target-aligned frame, in degrees. | ### BoxViewJitterConfig { #aria_nbv.pose_generation.config.BoxViewJitterConfig } ```python pose_generation.config.BoxViewJitterConfig() ``` Configure independent bounded local-camera yaw, pitch, and roll jitter. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.BoxViewJitterConfig.kind) | Discriminator for bounded local-camera angular support. | | [yaw_half_width_deg](#aria_nbv.pose_generation.config.BoxViewJitterConfig.yaw_half_width_deg) | Symmetric local-camera yaw half-width in degrees; seminar default is 60. | | [pitch_half_width_deg](#aria_nbv.pose_generation.config.BoxViewJitterConfig.pitch_half_width_deg) | Symmetric local-camera pitch half-width in degrees; seminar default is 30. | | [roll_half_width_deg](#aria_nbv.pose_generation.config.BoxViewJitterConfig.roll_half_width_deg) | Symmetric roll half-width about the sampled forward axis, in degrees. | ### CandidateGazeConfig { #aria_nbv.pose_generation.config.CandidateGazeConfig } ```python pose_generation.config.CandidateGazeConfig() ``` Apply one named orientation family to every center in a component. #### Attributes | Name | Description | | --- | --- | | [name](#aria_nbv.pose_generation.config.CandidateGazeConfig.name) | Variant name used only for later-gaze provenance and seed identity. | | [mode](#aria_nbv.pose_generation.config.CandidateGazeConfig.mode) | Base camera orientation family applied before residual jitter. | | [jitter](#aria_nbv.pose_generation.config.CandidateGazeConfig.jitter) | Residual local-camera orientation support used during generation. | #### Methods | Name | Description | | --- | --- | | [from_legacy](#aria_nbv.pose_generation.config.CandidateGazeConfig.from_legacy) | Validate the retained flat gaze controls into one nested value. | ##### from_legacy { #aria_nbv.pose_generation.config.CandidateGazeConfig.from_legacy } ```python pose_generation.config.CandidateGazeConfig.from_legacy( mode, sampling_strategy, concentration, yaw_half_width_deg, pitch_half_width_deg, roll_half_width_deg, name='primary', ) ``` Validate the retained flat gaze controls into one nested value. ### CandidateMixtureComponentConfig { #aria_nbv.pose_generation.config.CandidateMixtureComponentConfig } ```python pose_generation.config.CandidateMixtureComponentConfig() ``` Configure one center table and its ordered gaze variants. #### Attributes | Name | Description | | --- | --- | | [name](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.name) | Stable component name retained as provenance for the first gaze. | | [count](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.count) | Number of attempted centers sampled once before gaze expansion. | | [center](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.center) | Complete positional proposal configuration for the shared center table. | | [gazes](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.gazes) | Ordered gaze variants; row order is gaze-major within this component. | #### Methods | Name | Description | | --- | --- | | [with_count](#aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.with_count) | Return a fully revalidated component with a replacement count. | ##### with_count { #aria_nbv.pose_generation.config.CandidateMixtureComponentConfig.with_count } ```python pose_generation.config.CandidateMixtureComponentConfig.with_count(count) ``` Return a fully revalidated component with a replacement count. ### DistanceScaledTargetOrbitCenterConfig { #aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig } ```python pose_generation.config.DistanceScaledTargetOrbitCenterConfig() ``` Configure bilateral orbit centers bounded by the current motion budget. At every generated state, the sampler measures the current world-horizontal target standoff ``d`` and caps the largest orbit angle by the inverse chord relation ``theta = 2 asin(s / (2 d))`` for step budget ``s``. The configured fractions preserve the receipt-backed relative angle spacing while the existing motion and collision rules retain final authority over validity. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.kind) | Discriminator for the opt-in motion-bounded target-orbit geometry. | | [step_budget_m](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.step_budget_m) | Maximum desired straight-line center displacement per proposal, in metres. | | [maximum_angle_deg](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.maximum_angle_deg) | Semantic cap on the largest partial-orbit angle, in degrees. | | [step_margin](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.step_margin) | Multiplicative numerical margin applied before inverting the chord relation. | | [positive_angle_fractions](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.positive_angle_fractions) | Strictly increasing positive fractions ending at one for angle-bank spacing. | | [standoff_mode](#aria_nbv.pose_generation.config.DistanceScaledTargetOrbitCenterConfig.standoff_mode) | Recompute bounds from the current committed horizontal target radius. | ### NoViewJitterConfig { #aria_nbv.pose_generation.config.NoViewJitterConfig } ```python pose_generation.config.NoViewJitterConfig() ``` Represent a deterministic gaze with no residual orientation jitter. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.NoViewJitterConfig.kind) | Discriminator whose generation meaning is exactly zero residual jitter. | ### PowerSphericalConfig { #aria_nbv.pose_generation.config.PowerSphericalConfig } ```python pose_generation.config.PowerSphericalConfig() ``` Select forward-biased power-spherical sampling. ### SampledCenterConfig { #aria_nbv.pose_generation.config.SampledCenterConfig } ```python pose_generation.config.SampledCenterConfig() ``` Configure one sampled candidate-center family in the proposal frame. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.SampledCenterConfig.kind) | Discriminator for sampled-center authoring; provenance uses ``mode``. | | [mode](#aria_nbv.pose_generation.config.SampledCenterConfig.mode) | Semantic center family applied in the gravity-aligned proposal frame. | | [distribution](#aria_nbv.pose_generation.config.SampledCenterConfig.distribution) | Distribution used to draw proposal directions before family shaping. | | [min_radius_m](#aria_nbv.pose_generation.config.SampledCenterConfig.min_radius_m) | Minimum sampled displacement from the reference center, in metres. | | [max_radius_m](#aria_nbv.pose_generation.config.SampledCenterConfig.max_radius_m) | Maximum sampled displacement from the reference center, in metres. | | [min_elevation_deg](#aria_nbv.pose_generation.config.SampledCenterConfig.min_elevation_deg) | Lower world-horizontal elevation bound in degrees, inclusive. | | [max_elevation_deg](#aria_nbv.pose_generation.config.SampledCenterConfig.max_elevation_deg) | Upper world-horizontal elevation bound in degrees, inclusive. | | [azimuth_width_deg](#aria_nbv.pose_generation.config.SampledCenterConfig.azimuth_width_deg) | Full azimuth support width about proposal-frame forward, in degrees. | #### Methods | Name | Description | | --- | --- | | [from_legacy](#aria_nbv.pose_generation.config.SampledCenterConfig.from_legacy) | Validate retained flat center controls into one nested value. | ##### from_legacy { #aria_nbv.pose_generation.config.SampledCenterConfig.from_legacy } ```python pose_generation.config.SampledCenterConfig.from_legacy( base, *, mode, min_radius_m=None, max_radius_m=None, ) ``` Validate retained flat center controls into one nested value. ### SphericalViewJitterConfig { #aria_nbv.pose_generation.config.SphericalViewJitterConfig } ```python pose_generation.config.SphericalViewJitterConfig() ``` Configure uncapped spherical forward-axis jitter plus bounded roll. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.SphericalViewJitterConfig.kind) | Discriminator for uncapped spherical directional support. | | [distribution](#aria_nbv.pose_generation.config.SphericalViewJitterConfig.distribution) | Closed sphere distribution used to sample the local-camera forward direction. | | [roll_half_width_deg](#aria_nbv.pose_generation.config.SphericalViewJitterConfig.roll_half_width_deg) | Symmetric roll half-width about the sampled forward axis, in degrees. | ### TargetOrbitCenterConfig { #aria_nbv.pose_generation.config.TargetOrbitCenterConfig } ```python pose_generation.config.TargetOrbitCenterConfig() ``` Configure bilateral target-relative centers at current horizontal standoff. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.TargetOrbitCenterConfig.kind) | Discriminator for target-orbit authoring; provenance is target orbit. | | [angles_deg](#aria_nbv.pose_generation.config.TargetOrbitCenterConfig.angles_deg) | Ordered signed orbit angles in degrees; both target sides are required. | | [standoff_mode](#aria_nbv.pose_generation.config.TargetOrbitCenterConfig.standoff_mode) | Keep each center at the actor's current world-horizontal target radius. | ### TargetShellCenterConfig { #aria_nbv.pose_generation.config.TargetShellCenterConfig } ```python pose_generation.config.TargetShellCenterConfig() ``` Configure an opt-in target-centric spherical-shell center family. #### Attributes | Name | Description | | --- | --- | | [kind](#aria_nbv.pose_generation.config.TargetShellCenterConfig.kind) | Discriminator for target-shell authoring; provenance is target shell. | | [radius_min_m](#aria_nbv.pose_generation.config.TargetShellCenterConfig.radius_min_m) | Minimum target-to-candidate radius in metres; equal bounds are valid. | | [radius_max_m](#aria_nbv.pose_generation.config.TargetShellCenterConfig.radius_max_m) | Maximum target-to-candidate radius in metres; equal bounds are valid. | | [support](#aria_nbv.pose_generation.config.TargetShellCenterConfig.support) | Complete directional support; serialized identity contains only active fields. | ### UniformSphereConfig { #aria_nbv.pose_generation.config.UniformSphereConfig } ```python pose_generation.config.UniformSphereConfig() ``` Select area-uniform directional sampling without inert parameters. ## Functions | Name | Description | | --- | --- | | [sphere_distribution_from_legacy](#aria_nbv.pose_generation.config.sphere_distribution_from_legacy) | Validate retained flat distribution controls into one closed value. | ### sphere_distribution_from_legacy { #aria_nbv.pose_generation.config.sphere_distribution_from_legacy } ```python pose_generation.config.sphere_distribution_from_legacy(strategy, concentration) ``` Validate retained flat distribution controls into one closed value.