1 vin.modules.qh_volume_readout

vin.modules.qh_volume_readout

Candidate-independent attention over causally fused volume evidence.

1.1 Classes

Name	Description
QhVolumeReadout	Fuse one causal state volume and attend its supported spatial tokens.
QhVolumeReadoutConfig	Configure causal volume construction and candidate-local token reading.

1.1.1 QhVolumeReadout

vin.modules.qh_volume_readout.QhVolumeReadout(config)

Fuse one causal state volume and attend its supported spatial tokens.

Each state is constructed from immutable root evidence and exactly the selected observations with indices j < s. All state volumes are encoded once in one batched encoder call. For each candidate, the existing target OBB lattice and candidate-to-target ray supply tokens. Their learned volume values are concatenated with deterministic scene channels, candidate-frame relative XYZ, and a target/ray region identity before masked attention.

A candidate occupies its own attention batch row. Candidate rows cannot exchange features, action validity is never read, and an all-unsupported token set returns finite zero learned features plus explicit support or mass/absence statistics. Weighted modes normalize each region separately and retain a fixed one-half mixture without empty-region renormalization. No state survives beyond one :meth:forward call.

1.1.1.1 Methods

Name	Description
forward	Return candidate-aligned volume features for every causal state.

1.1.1.1.1 forward

vin.modules.qh_volume_readout.QhVolumeReadout.forward(actor)

Return candidate-aligned volume features for every causal state.

1.1.1.1.1.1 Parameters

Name	Type	Description	Default
actor	QhActorTensors	Batched QH actor. root_only rejects any privileged selected carrier. selected_depth requires the exact CF-GT causal prefix and integrates it in factual index order.	required

1.1.1.1.1.2 Returns

Name	Type	Description
	QhCandidateFeatures	class:QhCandidateFeatures with Tensor["B S N F", float32]
	QhCandidateFeatures	values. The learned prefix of width attention_dim is available
	QhCandidateFeatures	for positive-measure in-map tokens, including explicit unknown
	QhCandidateFeatures	space (legacy attention does not require positive measure). Legacy
	QhCandidateFeatures	outputs append four measured-support statistics; weighted outputs
	QhCandidateFeatures	append fourteen region-wise mass/fraction/absence columns, all
	QhCandidateFeatures	defined for every materialized candidate.

1.1.2 QhVolumeReadoutConfig

vin.modules.qh_volume_readout.QhVolumeReadoutConfig()

Configure causal volume construction and candidate-local token reading.

1.1.2.1 Attributes

Name	Description
propagation_exclude_fields	Readout identity and regularization never overwrite nested configs.
kind	Closed candidate-readout discriminator.
aggregation	Legacy joint attention or versioned, measure-aware region-wise reductions.
evidence_mode	Immutable root evidence or privileged causal selected-depth fusion.
fusion	Fixed chart, grid, source normalization, and fusion tolerances.
encoder	Learned two-scale volume encoder or projection-only ablation.
ray_samples	Existing candidate-to-target ray sample count, including endpoints.
attention_dim	Candidate-local token and attended-feature width.
attention_heads	Multi-head attention count; candidates never share an attention row.
dropout	Attention dropout used only in training mode.
candidate_chunk_size	Maximum candidate rows sampled and attended at once.
feature_spec	Return learned feature and explicit support-statistic identities.
target_type	Return the configured candidate-local volume readout.