1 vin.feature_bank.point_feature_bank

vin.feature_bank.point_feature_bank

Point-feature bank container with actor-source validation.

The module owns the structured payload returned by logged-view feature sampling; projection, pooling, and provenance validation remain separate.

1.1 Classes

Name Description
PointFeatureBank Feature bank derived from logged actor-visible observations.

1.1.1 PointFeatureBank

vin.feature_bank.point_feature_bank.PointFeatureBank(
    points_world,
    features,
    valid_mask,
    valid_frame_count,
    weight_sum,
    per_frame_valid,
    source_frame_indices,
    feature_source,
    source_role='actor_visible',
    compression_id='raw',
    point_support=None,
)

Feature bank derived from logged actor-visible observations.

The dataclass validates provenance at construction but is not frozen; callers that require immutable cache records must enforce immutability at the storage boundary.

Descriptor values are learned-source-local rather than globally comparable. feature_source and compression_id are human-readable provenance labels, not content hashes. Persistent EVL-derived banks must be paired by their cache owner with source-config and checkpoint hashes.

1.1.1.1 Attributes

Name Description
points_world Tensor["B N_p 3", float32] world-frame point coordinates in metres.
features Tensor["B N_p C", float32] logged-view descriptors pooled per point.
valid_mask Tensor["B N_p", bool] mask for points with descriptor support.
valid_frame_count Tensor["B N_p", int64] valid logged-frame samples per point.
weight_sum Tensor["B N_p", float32] pooling-weight sum before epsilon.
per_frame_valid Tensor["B T N_p", bool] per-frame projection-valid mask.
source_frame_indices Tensor["B T", int64] logged source-frame indices.
feature_source Approved actor-visible source label; not a checkpoint content hash.
source_role Provenance role; actor banks accept only "actor_visible".
compression_id Descriptor compression label; not a projection-matrix content hash.
point_support Optional point/sample weights broadcast by the multiview pooler.

1.1.1.2 Methods

Name Description
validate_actor_visible Reject oracle, GT, future-candidate, or unapproved feature sources.
1.1.1.2.1 validate_actor_visible
vin.feature_bank.point_feature_bank.PointFeatureBank.validate_actor_visible()

Reject oracle, GT, future-candidate, or unapproved feature sources.

Back to top