gen_parallels_xldπ
Short descriptionπ
gen_parallels_xld β Extract parallel XLD polygons.
Signatureπ
gen_parallels_xld( xld_poly Polygons, out xld_para Parallels, number Len, number Dist, number Alpha, string Merge )
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, \(\delta\alpha\) is the angle difference of the
polygon segments, \(overlap\) is the length of the overlap,
\(len_{1}\) and \(len_{2}\) the lengths of the polygon
segments, and \(q\) 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π
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'
Combinations with other operatorsπ
Combinations
Possible predecessors
Possible successors
Moduleπ
Foundation