combine_roads_xldcombine_roads_xldCombineRoadsXldCombineRoadsXldcombine_roads_xldcombine_roads_xld
Short description
combine_roads_xldcombine_roads_xldCombineRoadsXldCombineRoadsXldcombine_roads_xldcombine_roads_xld — Combine road hypotheses from two resolution levels.
Signature
combine_roads_xld( xld_poly EdgePolygons, xld_mod_para ModParallels, xld_ext_para ExtParallels, xld_poly CenterLines, out xld_poly RoadSides, angle.rad MaxAngleParallel, angle.rad MaxAngleColinear, real MaxDistanceParallel, real MaxDistanceColinear )combine_roads_xld( EdgePolygons, ModParallels, ExtParallels, CenterLines : RoadSides : MaxAngleParallel, MaxAngleColinear, MaxDistanceParallel, MaxDistanceColinear : )void CombineRoadsXld( const HObject& EdgePolygons, const HObject& ModParallels, const HObject& ExtParallels, const HObject& CenterLines, HObject* RoadSides, const HTuple& MaxAngleParallel, const HTuple& MaxAngleColinear, const HTuple& MaxDistanceParallel, const HTuple& MaxDistanceColinear )static void HOperatorSet.CombineRoadsXld( HObject edgePolygons, HObject modParallels, HObject extParallels, HObject centerLines, out HObject roadSides, HTuple maxAngleParallel, HTuple maxAngleColinear, HTuple maxDistanceParallel, HTuple maxDistanceColinear )def combine_roads_xld( edge_polygons: HObject, mod_parallels: HObject, ext_parallels: HObject, center_lines: HObject, max_angle_parallel: Union[float, int], max_angle_colinear: Union[float, int], max_distance_parallel: Union[float, int], max_distance_colinear: Union[float, int] ) -> HObject
Herror combine_roads_xld( const Hobject EdgePolygons, const Hobject ModParallels, const Hobject ExtParallels, const Hobject CenterLines, Hobject* RoadSides, double MaxAngleParallel, double MaxAngleColinear, double MaxDistanceParallel, double MaxDistanceColinear )
Herror T_combine_roads_xld( const Hobject EdgePolygons, const Hobject ModParallels, const Hobject ExtParallels, const Hobject CenterLines, Hobject* RoadSides, const Htuple MaxAngleParallel, const Htuple MaxAngleColinear, const Htuple MaxDistanceParallel, const Htuple MaxDistanceColinear )
HXLDPoly HXLDPoly::CombineRoadsXld( const HXLDModPara& ModParallels, const HXLDExtPara& ExtParallels, const HXLDPoly& CenterLines, const HTuple& MaxAngleParallel, const HTuple& MaxAngleColinear, const HTuple& MaxDistanceParallel, const HTuple& MaxDistanceColinear ) const
HXLDPoly HXLDPoly::CombineRoadsXld( const HXLDModPara& ModParallels, const HXLDExtPara& ExtParallels, const HXLDPoly& CenterLines, double MaxAngleParallel, double MaxAngleColinear, double MaxDistanceParallel, double MaxDistanceColinear ) const
HXLDPoly HXLDModPara::CombineRoadsXld( const HXLDPoly& EdgePolygons, const HXLDExtPara& ExtParallels, const HXLDPoly& CenterLines, const HTuple& MaxAngleParallel, const HTuple& MaxAngleColinear, const HTuple& MaxDistanceParallel, const HTuple& MaxDistanceColinear ) const
HXLDPoly HXLDModPara::CombineRoadsXld( const HXLDPoly& EdgePolygons, const HXLDExtPara& ExtParallels, const HXLDPoly& CenterLines, double MaxAngleParallel, double MaxAngleColinear, double MaxDistanceParallel, double MaxDistanceColinear ) const
HXLDPoly HXLDPoly.CombineRoadsXld( HXLDModPara modParallels, HXLDExtPara extParallels, HXLDPoly centerLines, HTuple maxAngleParallel, HTuple maxAngleColinear, HTuple maxDistanceParallel, HTuple maxDistanceColinear )
HXLDPoly HXLDPoly.CombineRoadsXld( HXLDModPara modParallels, HXLDExtPara extParallels, HXLDPoly centerLines, double maxAngleParallel, double maxAngleColinear, double maxDistanceParallel, double maxDistanceColinear )
HXLDPoly HXLDModPara.CombineRoadsXld( HXLDPoly edgePolygons, HXLDExtPara extParallels, HXLDPoly centerLines, HTuple maxAngleParallel, HTuple maxAngleColinear, HTuple maxDistanceParallel, HTuple maxDistanceColinear )
HXLDPoly HXLDModPara.CombineRoadsXld( HXLDPoly edgePolygons, HXLDExtPara extParallels, HXLDPoly centerLines, double maxAngleParallel, double maxAngleColinear, double maxDistanceParallel, double maxDistanceColinear )
Description
combine_roads_xldCombineRoadsXld combines road hypotheses obtained from
two different resolution levels. The algorithm selects only those
hypotheses which mutually support each other in both resolution
levels. The parameters EdgePolygonsedgePolygonsedge_polygons,
ModParallelsmodParallelsmod_parallels and ExtParallelsextParallelsext_parallels correspond to
the road hypotheses from the highest resolution level. The
parameter CenterLinescenterLinescenter_lines is the result of road extraction in
a lower resolution level. Those of the polygons EdgePolygonsedgePolygonsedge_polygons
are returned for which evidence of being roadsides is found in
both resolution levels. The parameters MaxAngleParallelmaxAngleParallelmax_angle_parallel
and MaxAngleColinearmaxAngleColinearmax_angle_colinear determine the angle, that may be formed
by two parallel collinear line segments, respectively. The
parameters MaxDistanceParallelmaxDistanceParallelmax_distance_parallel and
MaxDistanceColinearmaxDistanceColinearmax_distance_colinear determine the maximum allowed
distance of two parallel or collinear line segments, respectively.
The combination is done using a number of rules.
Execution information
-
Multithreading type: mutually exclusive (runs in parallel with other non-exclusive operators, but not with itself).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters
EdgePolygonsedgePolygonsedge_polygons (input_object) xld_poly-array → objectobjectHObjectHXLDPolyHObjectHobject
XLD polygons to be examined.
ModParallelsmodParallelsmod_parallels (input_object) xld_mod_para-array → objectobjectHObjectHXLDModParaHObjectHobject
Modified parallels obtained from
EdgePolygonsedgePolygonsedge_polygons.
ExtParallelsextParallelsext_parallels (input_object) xld_ext_para-array → objectobjectHObjectHXLDExtParaHObjectHobject
Extended parallels obtained from
EdgePolygonsedgePolygonsedge_polygons.
CenterLinescenterLinescenter_lines (input_object) xld_poly-array → objectobjectHObjectHXLDPolyHObjectHobject
Road-center-line polygons to be examined.
RoadSidesroadSidesroad_sides (output_object) xld_poly-array → objectobjectHObjectHXLDPolyHObjectHobject *
Roadsides found.
MaxAngleParallelmaxAngleParallelmax_angle_parallel (input_control) angle.rad → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)
Maximum angle between two parallel line segments.
Default: 0.5235987755980.523598775598
Suggested values: 0.349065850399, 0.523598775598, 0.69813170080.349065850399, 0.523598775598, 0.6981317008
Restriction: 0 <= MaxAngleParallel <= pi/2
MaxAngleColinearmaxAngleColinearmax_angle_colinear (input_control) angle.rad → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)
Maximum angle between two collinear line segments.
Default: 0.2617993877990.261799387799
Suggested values: 0.174532925199, 0.261799387799, 0.3490658503990.174532925199, 0.261799387799, 0.349065850399
Restriction: 0 <= MaxAngleColinear <= pi/2
MaxDistanceParallelmaxDistanceParallelmax_distance_parallel (input_control) real → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)
Maximum distance between two parallel line segments.
Default: 4040
Suggested values: 20, 30, 40, 50, 6020, 30, 40, 50, 60
Restriction: MaxDistanceParallel > 0
MaxDistanceColinearmaxDistanceColinearmax_distance_colinear (input_control) real → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[float, int]Htuple (double / Hlong)
Maximum distance between two collinear line segments.
Default: 4040
Suggested values: 20, 30, 40, 50, 6020, 30, 40, 50, 60
Restriction: MaxDistanceColinear > 0
Combinations with other operators
Combinations
Possible predecessors
mod_parallels_xldModParallelsXld, gen_polygons_xldGenPolygonsXld, affine_trans_contour_xldAffineTransContourXld
Possible successors
get_polygon_xldGetPolygonXld, get_lines_xldGetLinesXld
See also
lines_gaussLinesGauss, lines_facetLinesFacet, get_channel_infoGetChannelInfo, edges_sub_pixEdgesSubPix
References
C. Steger, C. Glock, W. Eckstein, H. Mayer, B. Radig; “Model-based
Road Extraction from Images”; in “Automatic Extraction of
Man-Made Objects from Aerial and Space Images”; A. Gruen,
O. Kuebler, P. Agouris (Editors); Birkhäuser Verlag (1995),
pp. 275-284.
C. Heipke, C. Steger, R. Multhammer; “A Hierarchical Approach to
Automatic Road Extraction from Aerial Imagery”; in “Integrating
Photogrammetric Techniques with Scene Analysis and Machine Vision
II”; D. M. McKeown, Jr., I. J. Dowman (Editors); Proc. SPIE 2486
(1995), pp. 222-231.
Module
Foundation