1 prepare_vin_offline_sample

data_handling.prepare_vin_offline_sample(
    scene_id,
    snippet_id,
    vin_snippet,
    candidates,
    depths,
    rri,
    candidate_pcs,
    backbone_out,
    max_candidates,
    source_sample=None,
    include_depths=True,
    include_candidate_pcs=True,
    include_backbone=True,
    include_diagnostic_payloads=False,
    include_gt_obbs=True,
    include_detected_obbs=True,
    include_trajectory_metadata=True,
    backbone_numeric_keep_fields=None,
    backbone_payload_keep_fields=None,
    sample_key=None,
)

Normalize one oracle-labelled snippet into offline row blocks.

1.1 Parameters

Name	Type	Description	Default
scene_id	str	ASE scene identifier.	required
snippet_id	str	ASE snippet identifier.	required
vin_snippet	VinSnippetView	Canonical VIN snippet for the row.	required
candidates	CandidateSamplingResult | None	Optional candidate-sampling payload for diagnostics.	required
depths	CandidateDepths	Candidate-depth payload aligned with the oracle labels.	required
rri	RriResult	Oracle metrics aligned with the rendered candidates.	required
candidate_pcs	CandidatePointClouds | None	Optional candidate point clouds for diagnostics.	required
backbone_out	EvlBackboneOutput | None	Optional backbone outputs for training or diagnostics.	required
source_sample	EfmSnippetView | None	Optional raw EFM snippet used for compact GT modalities.	None
max_candidates	int	Maximum number of candidates stored in fixed blocks.	required
include_depths	bool	Whether to materialize numeric depth blocks.	True
include_candidate_pcs	bool	Whether candidate point clouds may be written when rich diagnostic payloads are enabled.	True
include_backbone	bool	Whether to materialize backbone outputs.	True
include_diagnostic_payloads	bool	Whether to write rich msgpack records such as full depth DTOs, candidate DTOs, candidate point clouds, and full backbone payloads. Defaults off because numeric blocks are the canonical training contract.	False
include_gt_obbs	bool	Whether to persist compact GT OBB tensors from the raw snippet.	True
include_detected_obbs	bool	Whether to persist compact detected OBB tensors from the backbone.	True
include_trajectory_metadata	bool	Whether to persist trajectory timestamps and gravity.	True
backbone_numeric_keep_fields	set[str] | None	Optional EVL backbone field keep-list for fixed numeric blocks. None preserves legacy behavior by writing all supported numeric fields.	None
backbone_payload_keep_fields	set[str] | None	Optional EVL backbone field keep-list for rich diagnostic payloads. None preserves legacy behavior by serializing all available fields.	None
sample_key	str | None	Optional explicit sample key.	None

1.2 Returns

Name	Type	Description
	PreparedVinOfflineSample	Prepared row ready for shard materialization.