1 oracle.pipelines.endpoint_measurement

oracle.pipelines.endpoint_measurement

Independent zero-render endpoint measurement for evaluated rollouts.

The helper reconstructs root and final Oracle states from retained selected candidate clouds, then delegates preparation and point–mesh measurement to the public TargetRriScorer seam. It never renders another view and never derives the endpoint metric by summing stored one-step rewards.

1.1 Classes

Name Description
EndpointParentIdentity Canonical writer/store identity owning an endpoint sidecar.
EvaluatedEndpointReceipt Independent endpoint result plus its rollout and stored-label audit.

1.1.1 EndpointParentIdentity

oracle.pipelines.endpoint_measurement.EndpointParentIdentity(
    writer_config_hash,
    writer_config,
    store_dir,
    source_manifest_hash,
    split_manifest_hash,
)

Canonical writer/store identity owning an endpoint sidecar.

1.1.2 EvaluatedEndpointReceipt

oracle.pipelines.endpoint_measurement.EvaluatedEndpointReceipt(
    sample_key,
    target_id,
    chain_id,
    step_count,
    termination_reason,
    measurement,
    stored_root_error_m2,
    stored_final_error_m2,
    scene_id,
    snippet_id,
    source_sample_index,
    source_shard_id,
    source_shard_row,
    root_pose_world_rig,
    root_camera_pose_world,
    root_time_ns,
    root_trajectory_index,
    root_frame_index,
    scorer_config_hash,
    scorer_config,
    parent,
)

Independent endpoint result plus its rollout and stored-label audit.

1.1.2.1 Attributes

Name Description
sample_key Stable source sample identity.
target_id Stable fixed target identity used throughout the rollout.
chain_id Zero-based retained replay chain measured by this receipt.
step_count Number of selected observations included in the final state.
termination_reason Authoritative replay termination classification for the measured chain.
measurement Canonical independently prepared root/final measurement.
stored_root_error_m2 First selected-row target_pm_dist_before label, when retained.
stored_final_error_m2 Last selected-row target_pm_dist_after label, when retained.

1.2 Functions

Name Description
bind_endpoint_receipts_to_promoted_shard Rebind staged endpoint receipts to frozen shard identity and final path.
measure_evaluated_endpoint Measure one retained chain from raw selected clouds with zero renders.
write_evaluated_endpoint_receipt Persist full prepared endpoint clouds and a JSON measurement receipt.

1.2.1 bind_endpoint_receipts_to_promoted_shard

oracle.pipelines.endpoint_measurement.bind_endpoint_receipts_to_promoted_shard(
    staging_store_dir,
    *,
    canonical_parent,
)

Rebind staged endpoint receipts to frozen shard identity and final path.

The writer executes against a temporary store path and therefore records a useful execution identity. Shard promotion replaces only the canonical parent binding while preserving that raw staging identity separately.

1.2.2 measure_evaluated_endpoint

oracle.pipelines.endpoint_measurement.measure_evaluated_endpoint(
    prepared,
    evaluated,
    *,
    chain_id=0,
    parent,
)

Measure one retained chain from raw selected clouds with zero renders.

1.2.3 write_evaluated_endpoint_receipt

oracle.pipelines.endpoint_measurement.write_evaluated_endpoint_receipt(
    receipt,
    output_dir,
)

Persist full prepared endpoint clouds and a JSON measurement receipt.

Back to top