vibespatial.overlay.host_fallback

Pure-Python / NumPy / Shapely host-path helpers for the overlay pipeline.

These functions implement the CPU fallback path for overlay operations. They are extracted from gpu.py to reduce file size and clarify the boundary between GPU and host code.

None of these functions touch CuPy or CUDA directly. When GPU-accelerated batch PIP is needed (inside _build_polygon_output_from_faces), the GPU function is imported lazily to avoid circular imports.

Attributes

cp

Functions

spatial_overlay_owned_host(left, right, ...)

Explicit Shapely oracle for geometry-only planar overlay.

Module Contents

vibespatial.overlay.host_fallback.cp = None
vibespatial.overlay.host_fallback.spatial_overlay_owned_host(left, right, candidate_pairs, *, how: str)

Explicit Shapely oracle for geometry-only planar overlay.