vibespatial.runtime.robustness

Classes

RobustnessGuarantee

Enum where members are also (and must be) strings

PredicateFallback

Enum where members are also (and must be) strings

TopologyPolicy

Enum where members are also (and must be) strings

RobustnessPlan

NumericalErrorEnvelope

Conservative ambiguity bound carried between GPU planning stages.

Functions

select_robustness_plan(→ RobustnessPlan)

Module Contents

class vibespatial.runtime.robustness.RobustnessGuarantee

Enum where members are also (and must be) strings

EXACT = 'exact'
BOUNDED_ERROR = 'bounded-error'
BEST_EFFORT = 'best-effort'
class vibespatial.runtime.robustness.PredicateFallback

Enum where members are also (and must be) strings

NONE = 'none'
SELECTIVE_FP64 = 'selective-fp64'
EXPANSION_ARITHMETIC = 'expansion-arithmetic'
RATIONAL_RECONSTRUCTION = 'rational-reconstruction'
class vibespatial.runtime.robustness.TopologyPolicy

Enum where members are also (and must be) strings

PRESERVE = 'preserve'
SNAP_GRID = 'snap-grid'
BEST_EFFORT = 'best-effort'
class vibespatial.runtime.robustness.RobustnessPlan
kernel_class: vibespatial.runtime.precision.KernelClass
guarantee: RobustnessGuarantee
predicate_fallback: PredicateFallback
topology_policy: TopologyPolicy
handles_nulls: bool
handles_empties: bool
reason: str
class vibespatial.runtime.robustness.NumericalErrorEnvelope

Conservative ambiguity bound carried between GPU planning stages.

bound may be a host scalar or a device scalar. Consumers compare a decision margin with this value and refine only decisions inside the envelope. The carrier deliberately describes numerical uncertainty, not an accuracy preference: exact-mode consumers must still resolve every ambiguous decision with their declared fallback.

bound: Any
quantity: str
arithmetic_precision: vibespatial.runtime.precision.PrecisionMode
derivation: str
conservative: bool = True
classmethod exact(*, quantity: str) NumericalErrorEnvelope
vibespatial.runtime.robustness.select_robustness_plan(*, kernel_class: vibespatial.runtime.precision.KernelClass, precision_plan: vibespatial.runtime.precision.PrecisionPlan, null_state: vibespatial.runtime.nulls.GeometryPresence | None = None, empty_state: vibespatial.runtime.nulls.GeometryPresence | None = None) RobustnessPlan