1 data_handling._target_selection

data_handling._target_selection

Target-task sampling and actor-visible target selection for ARIA-NBV.

This module separates two target-facing contracts that must not be conflated:

  • OracleTargetTaskSampler builds the data-generation target-task pool from oracle GT OBBs. It is the source for rollout labels and target-conditioned supervision. Identity validity is a GT OBB IoU/ambiguity contract; projected visibility, support, confidence, distance, and downstream headroom are descriptor/audit fields, not first-pass eligibility gates.
  • ActorVisibleTargetSelector is the legacy/diagnostic V1 OBS-SEL / PRED-Q / GT-EVAL selector. It resolves observed or predicted OBB records by actor-visible evidence only: OBB confidence, clipped projected visible area, semidense support, EVL support, and support deficit. GT OBBs are allowed only in explicit V0 sanity/upper-bound mode or after selection for label/evaluation matching.

Both contracts store actor-facing descriptors and oracle-side audit fields. Unmatched, ambiguous, empty-crop, or no-source cases are target-invalid states, not low target-RRI examples.

1.1 Theory

Target handling is a three-stage contract. First, hard eligibility checks confidence, finite OBB geometry, clipped projected visibility policy, and effective actor-visible support. Second, an interest score ranks or samples eligible rows; the current baseline interest remains \(S_e=p_e s_e^{\mathrm{vis}}s_e^{\mathrm{sup}}s_e^{\mathrm{def}}\) while stratified target sampling is deferred to scale audits. Third, GT matching is a deterministic oracle/evaluation association based on semantic compatibility, 3D IoU, and top-1/top-2 ambiguity. Support and visibility are eligibility/audit fields, not GT-match ranking multipliers.

1.2 Attributes

Name Description
TARGET_INVALID_REASON_CODES Version-1 target invalidity reason bit positions.
TARGET_INVALID_REASON_VERSION Version label for TARGET_INVALID_REASON_CODES.
ORACLE_TARGET_TASK_SOURCE Source label for oracle target-task rows sampled from GT OBBs.

1.3 Classes

Name Description
TargetSelectionPolicy Supported top-K target selection policies.
TargetSourceMode Selector source protocol.
TargetCandidateRow One actor-visible target candidate and its oracle audit fields.
TargetSelectionResult Ranked target table and selected top-K rows for one snippet.
TargetTaskIdentityStatus Identity-gate status for oracle target-task rows.
OracleTargetTaskRow One oracle target-task row for rollout/data-generation labeling.
OracleTargetTaskSweepCell Coverage count for one oracle identity-threshold cell.
OracleTargetTaskSamplingResult Oracle target-task pool and seeded capped sample for one snippet.
TargetSelectorConfig Configuration for ActorVisibleTargetSelector.
OracleTargetTaskSamplerConfig Configuration for OracleTargetTaskSampler.
OracleTargetTaskSampler Sample oracle GT target tasks for rollout/data-generation labeling.
ActorVisibleTargetSelector Select top-K target OBBs from actor-visible snippet evidence.

1.4 Functions

Name Description
target_gt_obb_world Resolve the matched GT target OBB in world coordinates.