1 VinOfflineSample

data_handling.VinOfflineSample(
    sample_key,
    scene_id,
    snippet_id,
    vin_snippet,
    oracle,
    sample_index=-1,
    split='all',
    source_shard_id=None,
    source_shard_row=None,
    candidates=None,
    backbone_out=None,
    depths=None,
    candidate_pcs=None,
    efm_snippet_view=None,
    gt_obbs=None,
    detected_obbs=None,
    trajectory=None,
)

Canonical root sample for diagnostics and rollout generation.

VinOfflineSample is intentionally richer than VinOracleBatch: it keeps sample-index lineage, optional raw snippet/mesh attachments, and diagnostic blocks needed to regenerate counterfactual candidates. Model training still goes through VinOracleBatch, while rollout writers consume this sample shape and carry its source shard fields into standalone rollout stores.

1.1 Attributes

Name Description
sample_key Stable dataset sample key.
scene_id ASE scene identifier.
snippet_id ASE snippet identifier.
vin_snippet Minimal model-facing VIN snippet view.
oracle Oracle-label block stored for the sample.
sample_index Global zero-based sample index from sample_index.jsonl.
split Split membership from sample_index.jsonl.
source_shard_id VIN offline shard id that stores this immutable source row.
source_shard_row Zero-based row offset inside source_shard_id used for rollout lineage.
candidates Optional candidate-sampling payload preserved for diagnostics.
backbone_out Optional cached EVL backbone outputs.
depths Optional cached candidate depth maps.
candidate_pcs Optional cached candidate point clouds.
efm_snippet_view Optional raw EFM snippet view attached live from the source dataset.
gt_obbs Optional compact GT OBBs decoded from persisted blocks.
detected_obbs Optional compact detected OBBs decoded from persisted blocks.
trajectory Optional persisted trajectory timing and gravity metadata.

1.2 Methods

Name Description
to_vin_oracle_batch Convert the offline sample into a model-facing VIN batch.

1.2.1 to_vin_oracle_batch

data_handling.VinOfflineSample.to_vin_oracle_batch()

Convert the offline sample into a model-facing VIN batch.

1.2.1.1 Returns

Name Type Description
VinOracleBatch VinOracleBatch built from the sample’s VIN and oracle blocks.