Skip to content

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đź”—

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