vibespatial.constructive.make_valid_pipeline¶

Classes¶

`MakeValidPrimitive`	Enum where members are also (and must be) strings
`MakeValidStage`
`MakeValidPlan`
`MakeValidResult`
`MakeValidBenchmark`

Functions¶

`plan_make_valid_pipeline`(→ MakeValidPlan)
`fusion_plan_for_make_valid`(*[, method, keep_collapsed])
`make_valid_owned`(→ MakeValidResult)	Validate and repair geometries using compact-invalid-row pattern (ADR-0019).
`evaluate_geopandas_make_valid`(→ MakeValidResult)	Run make_valid and return the full MakeValidResult.
`benchmark_make_valid`(values, *[, method, ...])

Module Contents¶

class vibespatial.constructive.make_valid_pipeline.MakeValidPrimitive¶

Enum where members are also (and must be) strings

VALIDITY_MASK = 'validity_mask'¶

COMPACT_INVALID = 'compact_invalid'¶

SEGMENTIZE_INVALID = 'segmentize_invalid'¶

POLYGONIZE_REPAIR = 'polygonize_repair'¶

SCATTER_REPAIRED = 'scatter_repaired'¶

EMIT_GEOMETRY = 'emit_geometry'¶

class vibespatial.constructive.make_valid_pipeline.MakeValidStage¶

name: str¶

primitive: MakeValidPrimitive¶

purpose: str¶

inputs: tuple[str, Ellipsis]¶

outputs: tuple[str, Ellipsis]¶

cccl_mapping: tuple[str, Ellipsis]¶

disposition: vibespatial.runtime.fusion.IntermediateDisposition¶

geometry_producing: bool = False¶

class vibespatial.constructive.make_valid_pipeline.MakeValidPlan¶

method: str¶

keep_collapsed: bool¶

stages: tuple[MakeValidStage, Ellipsis]¶

fusion_steps: tuple[vibespatial.runtime.fusion.PipelineStep, Ellipsis]¶

reason: str¶

class vibespatial.constructive.make_valid_pipeline.MakeValidResult¶

geometries: numpy.ndarray¶

row_count: int¶

valid_rows: numpy.ndarray¶

repaired_rows: numpy.ndarray¶

null_rows: numpy.ndarray¶

method: str¶

keep_collapsed: bool¶

owned: object | None = None¶

selected: vibespatial.runtime.ExecutionMode¶

class vibespatial.constructive.make_valid_pipeline.MakeValidBenchmark¶

dataset: str¶

rows: int¶

repaired_rows: int¶

compact_elapsed_seconds: float¶

baseline_elapsed_seconds: float¶

property speedup_vs_baseline: float¶

vibespatial.constructive.make_valid_pipeline.plan_make_valid_pipeline(*, method: str = 'linework', keep_collapsed: bool = True) → MakeValidPlan¶

vibespatial.constructive.make_valid_pipeline.fusion_plan_for_make_valid(*, method: str = 'linework', keep_collapsed: bool = True)¶

vibespatial.constructive.make_valid_pipeline.make_valid_owned(values=None, *, method: str = 'linework', keep_collapsed: bool = True, owned=None, dispatch_mode: vibespatial.runtime.ExecutionMode | str = ExecutionMode.AUTO) → MakeValidResult¶

Validate and repair geometries using compact-invalid-row pattern (ADR-0019).

Parameters¶

valuesarray-like of shapely geometries, optional: When owned is provided, values may be None – Shapely objects will only be materialized if GPU validity checks find invalid rows that require repair (lazy materialization per ADR-0005).

method : repair method (“linework” or “structure”) keep_collapsed : whether to keep collapsed geometries owned : optional pre-built OwnedGeometryArray (avoids shapely->owned conversion

when data is already device-resident, eliminating D->H transfer for the validity check per ADR-0005)

dispatch_mode : requested execution mode (AUTO/GPU/CPU)

vibespatial.constructive.make_valid_pipeline.evaluate_geopandas_make_valid(values, *, method: str = 'linework', keep_collapsed: bool = True, prebuilt_owned=None) → MakeValidResult¶

Run make_valid and return the full MakeValidResult.

Returns MakeValidResult so callers can access .owned for device-resident fast paths and .selected for dispatch event accuracy.

vibespatial.constructive.make_valid_pipeline.benchmark_make_valid(values, *, method: str = 'linework', keep_collapsed: bool = True, dataset: str = 'make-valid')¶