1 targets.selection

targets.selection

Actor-visible observed-target selection.

This module deliberately stops at immutable detector descriptors. Privileged GT matching belongs to aria_nbv.oracle.target_selection and is a separate, evaluation-only step.

1.1 Classes

Name	Description
ObservedTargetDescriptor	One actor-visible detected OBB and its stable descriptor identity.

1.1.1 ObservedTargetDescriptor

targets.selection.ObservedTargetDescriptor(
    sample_key,
    source,
    source_row,
    target_id,
    descriptor,
    confidence,
    inst_id,
    obb_data=None,
)

One actor-visible detected OBB and its stable descriptor identity.

No ground-truth row, match score, or privileged label is present. The descriptor_hash is intended for manifest/evidence provenance only.

1.1.1.1 Attributes

Name	Description
sample_key	Immutable source sample identity.
source	Actor-visible OBB source label.
source_row	Row index in the detected OBB table before padding removal.
target_id	Stable identity for this detected source row.
descriptor	Sanitized actor instruction, or `None` for retained invalid geometry.
confidence	Detector confidence retained for audit.
inst_id	Detector instance identifier.
obb_data	Flattened actor OBB payload retained for privileged evaluation only.
descriptor_hash	Return the canonical hash of actor-visible identity fields.

1.2 Functions

Name	Description
observed_target_descriptors	Convert detected OBB rows into deterministic actor-visible descriptors.
snippet_t_world_snippet	Return the canonical world-from-snippet transform for OBB normalization.

1.2.1 observed_target_descriptors

targets.selection.observed_target_descriptors(sample)

Convert detected OBB rows into deterministic actor-visible descriptors.

Padded rows are omitted and source-row order is preserved. The function reads only actor-visible geometry, the neutral reference-frame pose, and sample identity; it never accesses the oracle payload or GT OBBs.

1.2.2 snippet_t_world_snippet

targets.selection.snippet_t_world_snippet(sample)

Return the canonical world-from-snippet transform for OBB normalization.

# targets.selection { #aria_nbv.targets.selection } `targets.selection` Actor-visible observed-target selection. This module deliberately stops at immutable detector descriptors. Privileged GT matching belongs to :mod:`aria_nbv.oracle.target_selection` and is a separate, evaluation-only step. ## Classes | Name | Description | | --- | --- | | [ObservedTargetDescriptor](#aria_nbv.targets.selection.ObservedTargetDescriptor) | One actor-visible detected OBB and its stable descriptor identity. | ### ObservedTargetDescriptor { #aria_nbv.targets.selection.ObservedTargetDescriptor } ```python targets.selection.ObservedTargetDescriptor( sample_key, source, source_row, target_id, descriptor, confidence, inst_id, obb_data=None, ) ``` One actor-visible detected OBB and its stable descriptor identity. No ground-truth row, match score, or privileged label is present. The ``descriptor_hash`` is intended for manifest/evidence provenance only. #### Attributes | Name | Description | | --- | --- | | [sample_key](#aria_nbv.targets.selection.ObservedTargetDescriptor.sample_key) | Immutable source sample identity. | | [source](#aria_nbv.targets.selection.ObservedTargetDescriptor.source) | Actor-visible OBB source label. | | [source_row](#aria_nbv.targets.selection.ObservedTargetDescriptor.source_row) | Row index in the detected OBB table before padding removal. | | [target_id](#aria_nbv.targets.selection.ObservedTargetDescriptor.target_id) | Stable identity for this detected source row. | | [descriptor](#aria_nbv.targets.selection.ObservedTargetDescriptor.descriptor) | Sanitized actor instruction, or ``None`` for retained invalid geometry. | | [confidence](#aria_nbv.targets.selection.ObservedTargetDescriptor.confidence) | Detector confidence retained for audit. | | [inst_id](#aria_nbv.targets.selection.ObservedTargetDescriptor.inst_id) | Detector instance identifier. | | [obb_data](#aria_nbv.targets.selection.ObservedTargetDescriptor.obb_data) | Flattened actor OBB payload retained for privileged evaluation only. | | [descriptor_hash](#aria_nbv.targets.selection.ObservedTargetDescriptor.descriptor_hash) | Return the canonical hash of actor-visible identity fields. | ## Functions | Name | Description | | --- | --- | | [observed_target_descriptors](#aria_nbv.targets.selection.observed_target_descriptors) | Convert detected OBB rows into deterministic actor-visible descriptors. | | [snippet_t_world_snippet](#aria_nbv.targets.selection.snippet_t_world_snippet) | Return the canonical world-from-snippet transform for OBB normalization. | ### observed_target_descriptors { #aria_nbv.targets.selection.observed_target_descriptors } ```python targets.selection.observed_target_descriptors(sample) ``` Convert detected OBB rows into deterministic actor-visible descriptors. Padded rows are omitted and source-row order is preserved. The function reads only actor-visible geometry, the neutral reference-frame pose, and sample identity; it never accesses the oracle payload or GT OBBs. ### snippet_t_world_snippet { #aria_nbv.targets.selection.snippet_t_world_snippet } ```python targets.selection.snippet_t_world_snippet(sample) ``` Return the canonical world-from-snippet transform for OBB normalization.