Operator Reference
gen_parallels_xld (Operator)
gen_parallels_xld — Extract parallel XLD polygons.
Signature
Description
gen_parallels_xld examines the XLD polygons passed in
Polygons for parallelism. The resulting parallel
polygons are returned in Parallels. If the parameter
Merge is set to 'true', adjacent parallel polygons
are returned in a single parallel relation. Otherwise, one parallel
relation is returned for each pair of parallel line segments.
Only polygon segments longer than Len are taken into account.
Whether two polygon segments are parallel depends on a maximum allowed
angle difference Alpha (in radians).
Furthermore, the projections of the two segments onto their angle bisector
have to overlap.
Finally, the overlap on the angle bisector is reprojected onto the two
segments. If the maximal distance of the reprojections is smaller than
Dist, the segments are stored in Parallels.
As a side effect, a quality factor is calculated for each pair of
parallels, compare mod_parallels_xld. It is based on the
normalized angular difference and the
normalized length of the overlap:
Here, is the angle difference of the
polygon segments, is the length of the overlap,
and the lengths of the polygon
segments, and the resulting quality factor.
The quality factor is a measure of parallelism (the larger its
value, the “more parallel” the polygons). Finally, the quality
factors of all parallel polygon segments contained in a single
polygon are added, weighted with their length of the overlapping
area. Note that you can query the range for the quality
factor with info_parallels_xld.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
Parameters
Polygons (input_object) xld_poly-array → object
Input polygons.
Parallels (output_object) xld_para-array → object
Parallel polygons.
Len (input_control) number → (real / integer)
Minimum length of the individual polygon segments.
Default: 10.0
Suggested values: 5.0, 10.0, 15.0, 20.0
Restriction:
Len > 0.0
Dist (input_control) number → (real / integer)
Maximum distance between the polygon segments.
Default: 30.0
Suggested values: 20.0, 25.0, 30.0, 40.0, 50.0, 75.0
Restriction:
Dist > 0.0
Alpha (input_control) number → (real / integer)
Maximum angle difference of the polygon segments.
Default: 0.15
Suggested values: 0.05, 0.10, 0.15, 0.20, 0.30
Restriction:
0 <= Alpha && Alpha <= pi / 2
Merge (input_control) string → (string)
Should adjacent parallel relations be merged?
Default: 'true'
List of values: 'false', 'true'
Possible Predecessors
Possible Successors
mod_parallels_xld,
get_parallels_xld,
info_parallels_xld
Module
Foundation