vibespatial.predicates.point_region_profile¶

Bounded, opt-in measurements for exact point/region GPU refinement.

This module is deliberately private. Public spatial APIs remain the workload entry point; a profiling session only substitutes instrumented copies of the prepared point-location kernels and exports one fixed-size control packet when the session is closed or snapshotted.

Classes¶

PointRegionProfileSession

Collect bounded physical-work evidence around public spatial calls.

Functions¶

`current_point_region_profile`(...)	Return the current private profiling session, if one is active.
`profile_point_region`(→ PointRegionProfileSession)	Create a private profiler to wrap calls made through public APIs.

Module Contents¶

vibespatial.predicates.point_region_profile.current_point_region_profile() → PointRegionProfileSession | None¶: Return the current private profiling session, if one is active.

class vibespatial.predicates.point_region_profile.PointRegionProfileSession(*, label: str, sample_limit: int = _DEFAULT_SAMPLE_LIMIT, force_prepared_index: bool = False)¶

Collect bounded physical-work evidence around public spatial calls.

label = ''¶

sample_limit¶

force_prepared_index = False¶

note_index_cache_hit(prepared) → None¶

note_index_build(prepared, wall_seconds: float) → None¶

launch_arguments(prepared) → tuple[Any, Any, Any, Any]¶: Return persistent device counters for one prepared index.

begin_launch(prepared, *, logical_count, candidate_count: int) → None¶

end_launch(prepared) → None¶

snapshot() → dict[str, Any]¶: Synchronize once and export fixed-size counter packets to host.

vibespatial.predicates.point_region_profile.profile_point_region(*, label: str, sample_limit: int = _DEFAULT_SAMPLE_LIMIT, force_prepared_index: bool = False) → PointRegionProfileSession¶: Create a private profiler to wrap calls made through public APIs.