1 data_handling.vin_store.target_inventory

data_handling.vin_store.target_inventory

Read-only detected and GT OBB population evidence from a VIN store.

The inventory is deliberately separate from the training-bundle composer and from Streamlit. It reads the manifest-declared compact OBB blocks only; missing blocks and malformed rows are reported as unavailable evidence rather than being inferred from raw source snippets.

1.1 Classes

Name	Description
CanonicalPlotlyFigure	Immutable Plotly JSON evidence reconstructed freshly by presentation code.
TargetFigureExplanation	Domain-neutral interpretation and provenance for one frozen figure.
TargetInventory	Complete detected/GT target inventory for one immutable VIN root.
TargetInventoryAcquisitionIdentity	Generation and complete request identity bound during deep acquisition.
TargetInventoryReport	Frozen, presentation-neutral inventory reduction and figure evidence.
TargetInventoryRow	One finite, non-padding compact OBB row.
TargetPopulationEvidence	Inventory evidence for one detected or GT population.
TargetPopulationSummary	Factual coverage summary which keeps unavailable populations explicit.
TargetSampleCount	Target count for one VIN sample, including zero-target samples.

1.1.1 CanonicalPlotlyFigure

data_handling.vin_store.target_inventory.CanonicalPlotlyFigure(
    key,
    plotly_json,
    explanation,
)

Immutable Plotly JSON evidence reconstructed freshly by presentation code.

1.1.1.1 Methods

Name	Description
build_figure	Return a new mutable figure without mutating canonical evidence bytes.

1.1.1.1.1 build_figure

data_handling.vin_store.target_inventory.CanonicalPlotlyFigure.build_figure()

Return a new mutable figure without mutating canonical evidence bytes.

1.1.2 TargetFigureExplanation

data_handling.vin_store.target_inventory.TargetFigureExplanation(
    question,
    answer,
    denominator_missingness,
    units,
    interpretation,
    warning,
    source_fields,
    external_implementation_reference,
    evidence_role,
    theory,
)

Domain-neutral interpretation and provenance for one frozen figure.

1.1.3 TargetInventory

data_handling.vin_store.target_inventory.TargetInventory(path, detected, gt)

Complete detected/GT target inventory for one immutable VIN root.

1.1.3.1 Methods

Name	Description
to_jsonable	Return deterministic JSON-compatible evidence.

1.1.3.1.1 to_jsonable

data_handling.vin_store.target_inventory.TargetInventory.to_jsonable()

Return deterministic JSON-compatible evidence.

1.1.4 TargetInventoryAcquisitionIdentity

data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity(
    identity_version,
    generation_digest,
    request_digest,
)

Generation and complete request identity bound during deep acquisition.

1.1.4.1 Attributes

Name	Description
identity_version	Generation identity schema version.
generation_digest	Digest of the filesystem generation verified around acquisition.
request_digest	Digest of the complete deep-inspection request.

1.1.5 TargetInventoryReport

data_handling.vin_store.target_inventory.TargetInventoryReport(
    inventory,
    summaries,
    figures,
    admission_handoff,
    provenance,
    acquisition=None,
)

Frozen, presentation-neutral inventory reduction and figure evidence.

1.1.5.1 Methods

Name	Description
to_jsonable	Return deterministic download-ready report evidence.
export_bytes	Serialize exactly the report shown by the application.

1.1.5.1.1 to_jsonable

data_handling.vin_store.target_inventory.TargetInventoryReport.to_jsonable()

Return deterministic download-ready report evidence.

1.1.5.1.2 export_bytes

data_handling.vin_store.target_inventory.TargetInventoryReport.export_bytes()

Serialize exactly the report shown by the application.

1.1.6 TargetInventoryRow

data_handling.vin_store.target_inventory.TargetInventoryRow(
    population,
    sample_index,
    sample_key,
    scene_id,
    snippet_id,
    split,
    source_row,
    target_index,
    semantic_id,
    instance_id,
    class_name,
    confidence,
    center,
    extents,
    diagonal,
    volume,
    aspect_ratio,
)

One finite, non-padding compact OBB row.

1.1.6.1 Methods

Name	Description
to_jsonable	Return a compact JSON-compatible row without the raw OBB payload.

1.1.6.1.1 to_jsonable

data_handling.vin_store.target_inventory.TargetInventoryRow.to_jsonable()

Return a compact JSON-compatible row without the raw OBB payload.

1.1.7 TargetPopulationEvidence

data_handling.vin_store.target_inventory.TargetPopulationEvidence(
    population,
    available,
    reason,
    rows,
    excluded_padding_count,
    excluded_nonfinite_count,
    excluded_invalid_geometry_count,
    sample_rows,
    sample_counts,
    scene_counts,
    split_counts,
    class_counts,
)

Inventory evidence for one detected or GT population.

1.1.7.1 Attributes

Name	Description
row_count	Return the number of valid rows.

1.1.7.2 Methods

Name	Description
to_jsonable	Return deterministic download-ready evidence.

1.1.7.2.1 to_jsonable

data_handling.vin_store.target_inventory.TargetPopulationEvidence.to_jsonable()

Return deterministic download-ready evidence.

1.1.8 TargetPopulationSummary

data_handling.vin_store.target_inventory.TargetPopulationSummary(
    population,
    available,
    unavailable_reason,
    valid_row_count,
    physical_sample_count,
    zero_target_sample_count,
    excluded_padding_count,
    excluded_nonfinite_count,
    excluded_invalid_geometry_count,
)

Factual coverage summary which keeps unavailable populations explicit.

1.1.9 TargetSampleCount

data_handling.vin_store.target_inventory.TargetSampleCount(
    sample_index,
    sample_key,
    scene_id,
    snippet_id,
    split,
    count,
)

Target count for one VIN sample, including zero-target samples.

1.1.9.1 Methods

Name	Description
to_jsonable	Return a JSON-compatible sample count row.

1.1.9.1.1 to_jsonable

data_handling.vin_store.target_inventory.TargetSampleCount.to_jsonable()

Return a JSON-compatible sample count row.

1.2 Functions

Name	Description
build_target_inventory_report	Purely reduce factual target inventory evidence into a frozen report.
inspect_target_inventory	Inspect manifest-declared detected and GT OBB blocks.

1.2.1 build_target_inventory_report

data_handling.vin_store.target_inventory.build_target_inventory_report(
    inventory,
    *,
    acquisition=None,
)

Purely reduce factual target inventory evidence into a frozen report.

1.2.2 inspect_target_inventory

data_handling.vin_store.target_inventory.inspect_target_inventory(root_store)

Inspect manifest-declared detected and GT OBB blocks.

The scan is read-only and deterministic in sample-index/row order. A population is unavailable when its manifest flag or any shard block is absent, or when a block has an invalid shape. No raw-source fallback is attempted. Metadata admission and failure ordering follow the store reader: version and provenance validation precede sample-index parsing.

# data_handling.vin_store.target_inventory { #aria_nbv.data_handling.vin_store.target_inventory } `data_handling.vin_store.target_inventory` Read-only detected and GT OBB population evidence from a VIN store. The inventory is deliberately separate from the training-bundle composer and from Streamlit. It reads the manifest-declared compact OBB blocks only; missing blocks and malformed rows are reported as unavailable evidence rather than being inferred from raw source snippets. ## Classes | Name | Description | | --- | --- | | [CanonicalPlotlyFigure](#aria_nbv.data_handling.vin_store.target_inventory.CanonicalPlotlyFigure) | Immutable Plotly JSON evidence reconstructed freshly by presentation code. | | [TargetFigureExplanation](#aria_nbv.data_handling.vin_store.target_inventory.TargetFigureExplanation) | Domain-neutral interpretation and provenance for one frozen figure. | | [TargetInventory](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventory) | Complete detected/GT target inventory for one immutable VIN root. | | [TargetInventoryAcquisitionIdentity](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity) | Generation and complete request identity bound during deep acquisition. | | [TargetInventoryReport](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport) | Frozen, presentation-neutral inventory reduction and figure evidence. | | [TargetInventoryRow](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryRow) | One finite, non-padding compact OBB row. | | [TargetPopulationEvidence](#aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationEvidence) | Inventory evidence for one detected or GT population. | | [TargetPopulationSummary](#aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationSummary) | Factual coverage summary which keeps unavailable populations explicit. | | [TargetSampleCount](#aria_nbv.data_handling.vin_store.target_inventory.TargetSampleCount) | Target count for one VIN sample, including zero-target samples. | ### CanonicalPlotlyFigure { #aria_nbv.data_handling.vin_store.target_inventory.CanonicalPlotlyFigure } ```python data_handling.vin_store.target_inventory.CanonicalPlotlyFigure( key, plotly_json, explanation, ) ``` Immutable Plotly JSON evidence reconstructed freshly by presentation code. #### Methods | Name | Description | | --- | --- | | [build_figure](#aria_nbv.data_handling.vin_store.target_inventory.CanonicalPlotlyFigure.build_figure) | Return a new mutable figure without mutating canonical evidence bytes. | ##### build_figure { #aria_nbv.data_handling.vin_store.target_inventory.CanonicalPlotlyFigure.build_figure } ```python data_handling.vin_store.target_inventory.CanonicalPlotlyFigure.build_figure() ``` Return a new mutable figure without mutating canonical evidence bytes. ### TargetFigureExplanation { #aria_nbv.data_handling.vin_store.target_inventory.TargetFigureExplanation } ```python data_handling.vin_store.target_inventory.TargetFigureExplanation( question, answer, denominator_missingness, units, interpretation, warning, source_fields, external_implementation_reference, evidence_role, theory, ) ``` Domain-neutral interpretation and provenance for one frozen figure. ### TargetInventory { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventory } ```python data_handling.vin_store.target_inventory.TargetInventory(path, detected, gt) ``` Complete detected/GT target inventory for one immutable VIN root. #### Methods | Name | Description | | --- | --- | | [to_jsonable](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventory.to_jsonable) | Return deterministic JSON-compatible evidence. | ##### to_jsonable { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventory.to_jsonable } ```python data_handling.vin_store.target_inventory.TargetInventory.to_jsonable() ``` Return deterministic JSON-compatible evidence. ### TargetInventoryAcquisitionIdentity { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity } ```python data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity( identity_version, generation_digest, request_digest, ) ``` Generation and complete request identity bound during deep acquisition. #### Attributes | Name | Description | | --- | --- | | [identity_version](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity.identity_version) | Generation identity schema version. | | [generation_digest](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity.generation_digest) | Digest of the filesystem generation verified around acquisition. | | [request_digest](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryAcquisitionIdentity.request_digest) | Digest of the complete deep-inspection request. | ### TargetInventoryReport { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport } ```python data_handling.vin_store.target_inventory.TargetInventoryReport( inventory, summaries, figures, admission_handoff, provenance, acquisition=None, ) ``` Frozen, presentation-neutral inventory reduction and figure evidence. #### Methods | Name | Description | | --- | --- | | [to_jsonable](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport.to_jsonable) | Return deterministic download-ready report evidence. | | [export_bytes](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport.export_bytes) | Serialize exactly the report shown by the application. | ##### to_jsonable { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport.to_jsonable } ```python data_handling.vin_store.target_inventory.TargetInventoryReport.to_jsonable() ``` Return deterministic download-ready report evidence. ##### export_bytes { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryReport.export_bytes } ```python data_handling.vin_store.target_inventory.TargetInventoryReport.export_bytes() ``` Serialize exactly the report shown by the application. ### TargetInventoryRow { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryRow } ```python data_handling.vin_store.target_inventory.TargetInventoryRow( population, sample_index, sample_key, scene_id, snippet_id, split, source_row, target_index, semantic_id, instance_id, class_name, confidence, center, extents, diagonal, volume, aspect_ratio, ) ``` One finite, non-padding compact OBB row. #### Methods | Name | Description | | --- | --- | | [to_jsonable](#aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryRow.to_jsonable) | Return a compact JSON-compatible row without the raw OBB payload. | ##### to_jsonable { #aria_nbv.data_handling.vin_store.target_inventory.TargetInventoryRow.to_jsonable } ```python data_handling.vin_store.target_inventory.TargetInventoryRow.to_jsonable() ``` Return a compact JSON-compatible row without the raw OBB payload. ### TargetPopulationEvidence { #aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationEvidence } ```python data_handling.vin_store.target_inventory.TargetPopulationEvidence( population, available, reason, rows, excluded_padding_count, excluded_nonfinite_count, excluded_invalid_geometry_count, sample_rows, sample_counts, scene_counts, split_counts, class_counts, ) ``` Inventory evidence for one detected or GT population. #### Attributes | Name | Description | | --- | --- | | [row_count](#aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationEvidence.row_count) | Return the number of valid rows. | #### Methods | Name | Description | | --- | --- | | [to_jsonable](#aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationEvidence.to_jsonable) | Return deterministic download-ready evidence. | ##### to_jsonable { #aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationEvidence.to_jsonable } ```python data_handling.vin_store.target_inventory.TargetPopulationEvidence.to_jsonable() ``` Return deterministic download-ready evidence. ### TargetPopulationSummary { #aria_nbv.data_handling.vin_store.target_inventory.TargetPopulationSummary } ```python data_handling.vin_store.target_inventory.TargetPopulationSummary( population, available, unavailable_reason, valid_row_count, physical_sample_count, zero_target_sample_count, excluded_padding_count, excluded_nonfinite_count, excluded_invalid_geometry_count, ) ``` Factual coverage summary which keeps unavailable populations explicit. ### TargetSampleCount { #aria_nbv.data_handling.vin_store.target_inventory.TargetSampleCount } ```python data_handling.vin_store.target_inventory.TargetSampleCount( sample_index, sample_key, scene_id, snippet_id, split, count, ) ``` Target count for one VIN sample, including zero-target samples. #### Methods | Name | Description | | --- | --- | | [to_jsonable](#aria_nbv.data_handling.vin_store.target_inventory.TargetSampleCount.to_jsonable) | Return a JSON-compatible sample count row. | ##### to_jsonable { #aria_nbv.data_handling.vin_store.target_inventory.TargetSampleCount.to_jsonable } ```python data_handling.vin_store.target_inventory.TargetSampleCount.to_jsonable() ``` Return a JSON-compatible sample count row. ## Functions | Name | Description | | --- | --- | | [build_target_inventory_report](#aria_nbv.data_handling.vin_store.target_inventory.build_target_inventory_report) | Purely reduce factual target inventory evidence into a frozen report. | | [inspect_target_inventory](#aria_nbv.data_handling.vin_store.target_inventory.inspect_target_inventory) | Inspect manifest-declared detected and GT OBB blocks. | ### build_target_inventory_report { #aria_nbv.data_handling.vin_store.target_inventory.build_target_inventory_report } ```python data_handling.vin_store.target_inventory.build_target_inventory_report( inventory, *, acquisition=None, ) ``` Purely reduce factual target inventory evidence into a frozen report. ### inspect_target_inventory { #aria_nbv.data_handling.vin_store.target_inventory.inspect_target_inventory } ```python data_handling.vin_store.target_inventory.inspect_target_inventory(root_store) ``` Inspect manifest-declared detected and GT OBB blocks. The scan is read-only and deterministic in sample-index/row order. A population is unavailable when its manifest flag or any shard block is absent, or when a block has an invalid shape. No raw-source fallback is attempted. Metadata admission and failure ordering follow the store reader: version and provenance validation precede sample-index parsing.