1 data_handling.qh_data.dataset

data_handling.qh_data.dataset

Validated rollout-to-VIN joins for finite-candidate Q_H chains.

The dataset joins private rollout source references to the exact immutable VIN actor sample and verifies manifest and split identity before iteration. Typed chain materialization lives in aria_nbv.data_handling.qh_data.materialization; rollout decoding and VIN storage remain with their respective readers.

1.1 Classes

Name Description
QhDataset Join validated rollout chains to one immutable actor snippet per chain.
QhDatasetConfig Configure ordered rollout stores and their exact immutable VIN actor source.

1.1.1 QhDataset

data_handling.qh_data.dataset.QhDataset(
    rollout_reader,
    actor_reader=None,
    actor_readers=None,
    split=None,
    root_evl_profile='none',
    selected_observation_protocol='none',
    experiment_profile=None,
    include_audit=False,
)

Join validated rollout chains to one immutable actor snippet per chain.

Construction preflights every private source reference against the actor manifest and complete immutable actor index. split has already selected campaign chains at the rollout-reader boundary. __getitem__ then reads one stored chain and its chain-constant root snippet exactly once. The result separates actor state from label support and other oracle transition facts; it does not decide fitted-Q admission.

1.1.1.1 Attributes

Name Description
scenes Return immutable ASE scene identifiers represented by the validated corpus.
max_horizon Return the largest configured horizon among the validated stores.
contract Return semantic compatibility and the exact replay-support mixture.
actor_state_contract Return metadata-only scorer-input compatibility facts for this stage.
requires_empirical_pooling_qualification Flag a readable multi-root corpus whose backend pooling lacks empirical approval.
provenance Return rollout/actor store identity for audit displays, never scorer input.
target_descriptor_identity Return receipt-only target descriptor lineage for admitted rollout rows.
admission_coverage Report source coverage without inventing a target-task denominator.

1.1.1.2 Methods

Name Description
chain_identity Return metadata-only chain identity for bounded diagnostics.
1.1.1.2.1 chain_identity
data_handling.qh_data.dataset.QhDataset.chain_identity(index)

Return metadata-only chain identity for bounded diagnostics.

This pass-through deliberately bypasses actor-store reads and tensor materialization. It is suitable for deterministic population census and selection, but it is not part of the scorer’s actor-visible state.

1.1.2 QhDatasetConfig

data_handling.qh_data.dataset.QhDatasetConfig()

Configure ordered rollout stores and their exact immutable VIN actor source.

1.1.2.1 Attributes

Name Description
rollout_store_dirs Non-empty rollout-store paths; tuple order defines QhChainKey.store_index.
actor Immutable VIN store whose actor-visible root rows must match every rollout source reference.
actors Explicit V2 root population; mutually exclusive with explicitly supplied actor.
split Learning/campaign split admitted by the rollout reader; None reads all chains.
root_evl_profile Root scene-evidence profile; evl_v1 requires the canonical eight-block EVL carrier.
selected_observation_protocol Causal selected-observation source; cf_gt explicitly enables privileged rendered depth.
experiment_profile Closed CF0/CF+ role; None retains legacy diagnostic-only setup.
include_audit Attach CPU-only chain provenance for debugging; never adds payloads to scorer tensors or device transfer.
target_type Return QhDataset for config-as-factory construction.

1.1.2.2 Methods

Name Description
setup_target Construct both readers and preflight rollout-to-actor source identity.
1.1.2.2.1 setup_target
data_handling.qh_data.dataset.QhDatasetConfig.setup_target()

Construct both readers and preflight rollout-to-actor source identity.

1.1.2.2.1.1 Returns
Name Type Description
QhDataset class:QhDataset ready for indexed chain reads after validating
QhDataset the configured actor manifest, split, and source rows.
Back to top