1 data_handling.vin_store.inspection

data_handling.vin_store.inspection

Immutable numeric summaries for validated VIN root stores.

The reducer keeps storage facts separate from semantic interpretation. A nonzero voxel value is counted, but is not relabelled as occupied or free, and the declared semidense point prefix is evaluated independently from padding.

1.1 Classes

Name	Description
RootNumericEvidence	Detached, canonical JSON evidence for one immutable VIN root store.

1.1.1 RootNumericEvidence

data_handling.vin_store.inspection.RootNumericEvidence(payload_json)

Detached, canonical JSON evidence for one immutable VIN root store.

1.1.1.1 Attributes

Name	Description
payload_json	Canonical UTF-8 JSON containing source bindings and numeric tables.

1.1.1.2 Methods

Name	Description
to_payload	Decode and validate a detached result payload.

1.1.1.2.1 to_payload

data_handling.vin_store.inspection.RootNumericEvidence.to_payload()

Decode and validate a detached result payload.

1.2 Functions

Name	Description
summarize_root_numeric_evidence	Summarize numeric storage facts without interpreting voxel semantics.

1.2.1 summarize_root_numeric_evidence

data_handling.vin_store.inspection.summarize_root_numeric_evidence(
    root_dir,
    sample_indices=None,
)

Summarize numeric storage facts without interpreting voxel semantics.

1.2.1.1 Parameters

Name	Type	Description	Default
root_dir	Path	Immutable VIN root-store directory.	required
sample_indices	list[int] | tuple[int, …] | None	Optional unique global source indices. None reads every index row in stored order.	None

1.2.1.2 Returns

Name	Type	Description
	RootNumericEvidence	Canonical detached tables for numeric blocks and point-prefix support.

1.2.1.3 Raises

Name	Type	Description
	ValueError	A selected index is missing/duplicated or a point-prefix declaration is malformed.