PolygonizerOptions
The canonical configuration object for the geo-polygonize engine.
This struct controls every aspect of the polygonization pipeline, including topological robustness, feature output, containment policies, noding, and determinism.
Fields
node_input
Type: bool
Whether to robustly node the input before polygonization.
Enable this for real-world linework where segment intersections may not already exist as explicit vertices. This is slower than the fast path but avoids missing faces and unresolved crossings.
Default: false
precision_model
Type: PrecisionModel
Coordinate precision used for topology and noding.
Default: PrecisionModel::Floating
pre_snap_tolerance
Type: f64
Snap input segments to nearby vertices from exact-noded input linework before grid noding.
A value of 0.0 disables pre-snap. This mirrors the CFB/Shapely snap(line, unary_union(all_lines), tolerance) step closely enough to close small CAD gaps before polygonization.
Default: 0.0
extract_only_polygonal
Type: bool
If true, only pure, outermost polygonal shells are returned.
Floating dangles, internal cut-lines, or invalid rings will be discarded.
Default: false
snap_strategy
Type: SnapStrategy
Controls robust snap noding and output coordinate handling.
See SnapStrategy for differences between strict Grid snapping and Shapely/GEOS GeosCompat strategies.
Default: SnapStrategy::Grid
noding
Type: NodingOptions
Configures the noding engine backend and behavior.
containment
Type: ContainmentOptions
Configures how topological relationships (containment) are calculated during face formation.
determinism
Type: DeterminismOptions
Configuration for enforcing exact topological determinism.
diagnostics
Type: DiagnosticsOptions
Options for capturing diagnostic topology failures.
provenance
Type: ProvenanceOptions
Options for mapping final faces back to original input geometry IDs.
z
Type: ZOptions
Controls Z reconstruction and same-XY conflict handling.
output_filter
Type: OutputFilterOptions
Optional application-level filtering applied after topology is established.
input_profile_id
Type: Option<String> (Optional)
An optional identifier for the input dataset.