1 rollouts.zarr_store
rollouts.zarr_store
Standalone Zarr replay store for finite-candidate rollout traces.
This module is the implementation-contract owner for rollouts.zarr. A store contains compact row tables for rollout chains, steps, full-shell candidates, shared VIN source rows, lineage, target records, masks, and reason codes. The padded Q_H tensors used by finite-candidate value learning are persisted in a derived q_h/ group for high-throughput training and are validated against the canonical factual steps/ and candidates/ tables. The store deliberately does not mutate or migrate the strict VIN offline store; rollout replay is a separate artifact with source manifest, split, target, candidate-mixture, policy, and oracle config hashes.
q_train_mask is true only when a candidate row is actor-selectable, target-valid, GT-label-valid, and has a finite target-root-gain reward. Invalid candidates keep their full-shell row but carry false masks and NaN labels. Q_H padding exists only in the derived dense q_h/ view. Target RRI and scene RRI are state-relative diagnostics; target labels must not be silently filled from scene scores or low-quality invalid rows.
1.1 Attributes
| Name | Description |
|---|---|
| ROLLOUT_ZARR_SCHEMA_ID | Schema id stored as a root attribute on rollout replay stores. |
| ROLLOUT_ZARR_SCHEMA_VERSION | Target-first rollout schema with hot candidate provenance and core parent-depth history. |
| DEFAULT_RETURN_SEMANTICS | Default return target family for root-normalized Q_H replay views. |
1.2 Classes
| Name | Description |
|---|---|
| RolloutZarrWriteResult | Summary of one rollout Zarr write. |
| RolloutZarrValidationResult | Validation summary for a rollout Zarr store. |
| RolloutZarrStoreConfig | Filesystem and target metadata for one standalone rollout replay store. |
| RolloutZarrStoreReader | Open and validate standalone rollout replay stores. |
1.3 Functions
| Name | Description |
|---|---|
| write_rollout_zarr_store | Write rollout records into a standalone rollouts.zarr store. |
| validate_rollout_zarr_store | Validate a standalone rollout replay store and return all discovered errors. |