Operator Reference

HALCON Operator Reference / XLD / Transformations
ClassesClasses | | Operators

combine_roads_xldcombine_roads_xldCombineRoadsXldCombineRoadsXldcombine_roads_xld (Operator)

combine_roads_xldcombine_roads_xldCombineRoadsXldCombineRoadsXldcombine_roads_xld — Combine road hypotheses from two resolution levels.

Signature

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)

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)

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

static void HOperatorSet.CombineRoadsXld(HObject edgePolygons, HObject modParallels, HObject extParallels, HObject centerLines, out HObject roadSides, HTuple maxAngleParallel, HTuple maxAngleColinear, HTuple maxDistanceParallel, HTuple maxDistanceColinear)

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)

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

Description

combine_roads_xldcombine_roads_xldCombineRoadsXldCombineRoadsXldcombine_roads_xld 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 EdgePolygonsEdgePolygonsEdgePolygonsedgePolygonsedge_polygons, ModParallelsModParallelsModParallelsmodParallelsmod_parallels and ExtParallelsExtParallelsExtParallelsextParallelsext_parallels correspond to the road hypotheses from the highest resolution level. The parameter CenterLinesCenterLinesCenterLinescenterLinescenter_lines is the result of road extraction in a lower resolution level. Those of the polygons EdgePolygonsEdgePolygonsEdgePolygonsedgePolygonsedge_polygons are returned for which evidence of being roadsides is found in both resolution levels. The parameters MaxAngleParallelMaxAngleParallelMaxAngleParallelmaxAngleParallelmax_angle_parallel and MaxAngleColinearMaxAngleColinearMaxAngleColinearmaxAngleColinearmax_angle_colinear determine the angle, that may be formed by two parallel collinear line segments, respectively. The parameters MaxDistanceParallelMaxDistanceParallelMaxDistanceParallelmaxDistanceParallelmax_distance_parallel and MaxDistanceColinearMaxDistanceColinearMaxDistanceColinearmaxDistanceColinearmax_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

EdgePolygonsEdgePolygonsEdgePolygonsedgePolygonsedge_polygons (input_object)  xld_poly-array → objectHXLDPolyHObjectHObjectHobject

XLD polygons to be examined.

ModParallelsModParallelsModParallelsmodParallelsmod_parallels (input_object)  xld_mod_para-array → objectHXLDModParaHObjectHObjectHobject

Modified parallels obtained from EdgePolygonsEdgePolygonsEdgePolygonsedgePolygonsedge_polygons.

ExtParallelsExtParallelsExtParallelsextParallelsext_parallels (input_object)  xld_ext_para-array → objectHXLDExtParaHObjectHObjectHobject

Extended parallels obtained from EdgePolygonsEdgePolygonsEdgePolygonsedgePolygonsedge_polygons.

CenterLinesCenterLinesCenterLinescenterLinescenter_lines (input_object)  xld_poly-array → objectHXLDPolyHObjectHObjectHobject

Road-center-line polygons to be examined.

RoadSidesRoadSidesRoadSidesroadSidesroad_sides (output_object)  xld_poly-array → objectHXLDPolyHObjectHObjectHobject *

Roadsides found.

MaxAngleParallelMaxAngleParallelMaxAngleParallelmaxAngleParallelmax_angle_parallel (input_control)  angle.rad → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum angle between two parallel line segments.

Default: 0.523598775598

Suggested values: 0.349065850399, 0.523598775598, 0.6981317008

Restriction: 0 <= MaxAngleParallel <= pi / 2

MaxAngleColinearMaxAngleColinearMaxAngleColinearmaxAngleColinearmax_angle_colinear (input_control)  angle.rad → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum angle between two collinear line segments.

Default: 0.261799387799

Suggested values: 0.174532925199, 0.261799387799, 0.349065850399

Restriction: 0 <= MaxAngleColinear <= pi / 2

MaxDistanceParallelMaxDistanceParallelMaxDistanceParallelmaxDistanceParallelmax_distance_parallel (input_control)  real → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum distance between two parallel line segments.

Default: 40

Suggested values: 20, 30, 40, 50, 60

Restriction: MaxDistanceParallel > 0

MaxDistanceColinearMaxDistanceColinearMaxDistanceColinearmaxDistanceColinearmax_distance_colinear (input_control)  real → HTupleUnion[float, int]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Maximum distance between two collinear line segments.

Default: 40

Suggested values: 20, 30, 40, 50, 60

Restriction: MaxDistanceColinear > 0

Possible Predecessors

mod_parallels_xldmod_parallels_xldModParallelsXldModParallelsXldmod_parallels_xld, gen_polygons_xldgen_polygons_xldGenPolygonsXldGenPolygonsXldgen_polygons_xld, affine_trans_contour_xldaffine_trans_contour_xldAffineTransContourXldAffineTransContourXldaffine_trans_contour_xld

Possible Successors

get_polygon_xldget_polygon_xldGetPolygonXldGetPolygonXldget_polygon_xld, get_lines_xldget_lines_xldGetLinesXldGetLinesXldget_lines_xld

See also

lines_gausslines_gaussLinesGaussLinesGausslines_gauss, lines_facetlines_facetLinesFacetLinesFacetlines_facet, get_channel_infoget_channel_infoGetChannelInfoGetChannelInfoget_channel_info, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixedges_sub_pix

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

ClassesClasses | | Operators