Operator Reference

HALCON Operator Reference / Tools / Hough
ClassesClasses | | Operators

select_matching_linesselect_matching_linesSelectMatchingLinesSelectMatchingLinesselect_matching_lines (Operator)

select_matching_linesselect_matching_linesSelectMatchingLinesSelectMatchingLinesselect_matching_lines — Select those lines from a set of lines (in HNF) which fit best into a region.

Signature

select_matching_lines(RegionIn : RegionLines : AngleIn, DistIn, LineWidth, Thresh : AngleOut, DistOut)

Herror select_matching_lines(const Hobject RegionIn, Hobject* RegionLines, double AngleIn, double DistIn, const Hlong LineWidth, const Hlong Thresh, double* AngleOut, double* DistOut)

Herror T_select_matching_lines(const Hobject RegionIn, Hobject* RegionLines, const Htuple AngleIn, const Htuple DistIn, const Htuple LineWidth, const Htuple Thresh, Htuple* AngleOut, Htuple* DistOut)

void SelectMatchingLines(const HObject& RegionIn, HObject* RegionLines, const HTuple& AngleIn, const HTuple& DistIn, const HTuple& LineWidth, const HTuple& Thresh, HTuple* AngleOut, HTuple* DistOut)

HRegion HRegion::SelectMatchingLines(const HTuple& AngleIn, const HTuple& DistIn, Hlong LineWidth, Hlong Thresh, HTuple* AngleOut, HTuple* DistOut) const

HRegion HRegion::SelectMatchingLines(double AngleIn, double DistIn, Hlong LineWidth, Hlong Thresh, double* AngleOut, double* DistOut) const

static void HOperatorSet.SelectMatchingLines(HObject regionIn, out HObject regionLines, HTuple angleIn, HTuple distIn, HTuple lineWidth, HTuple thresh, out HTuple angleOut, out HTuple distOut)

HRegion HRegion.SelectMatchingLines(HTuple angleIn, HTuple distIn, int lineWidth, int thresh, out HTuple angleOut, out HTuple distOut)

HRegion HRegion.SelectMatchingLines(double angleIn, double distIn, int lineWidth, int thresh, out double angleOut, out double distOut)

def select_matching_lines(region_in: HObject, angle_in: MaybeSequence[float], dist_in: MaybeSequence[float], line_width: int, thresh: int) -> Tuple[HObject, Sequence[float], Sequence[float]]

def select_matching_lines_s(region_in: HObject, angle_in: MaybeSequence[float], dist_in: MaybeSequence[float], line_width: int, thresh: int) -> Tuple[HObject, float, float]

Description

Lines which fit best into a region can be selected from a set of lines which are available in HNF with the help of the operator select_matching_linesselect_matching_linesSelectMatchingLinesSelectMatchingLinesselect_matching_lines; the region itself is also transmitted as a parameter (RegionInRegionInRegionInregionInregion_in). The width of the lines can be indicated by the parameter LineWidthLineWidthLineWidthlineWidthline_width. The selected lines will be returned in HNF and as regions (RegionLinesRegionLinesRegionLinesregionLinesregion_lines).

The lines are selected iteratively in a loop: At first, the line showing the greatest overlap with the input region is selected from the set of input lines. This line will then be taken over into the output set whereby all points belonging to that line will not be considered in the further steps determining overlaps. The loop will be left when the maximum overlap value of the region and the lines falls below a certain threshold value (ThreshThreshThreshthreshthresh). The selected lines will be returned as regions as well as in HNF.

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

RegionInRegionInRegionInregionInregion_in (input_object)  region → objectHRegionHObjectHObjectHobject

Region in which the lines are to be matched.

RegionLinesRegionLinesRegionLinesregionLinesregion_lines (output_object)  region(-array) → objectHRegionHObjectHObjectHobject *

Region array containing the matched lines.

AngleInAngleInAngleInangleInangle_in (input_control)  hesseline.angle.rad(-array) → HTupleMaybeSequence[float]HTupleHtuple (real) (double) (double) (double)

Angles (in radians) of the normal vectors of the input lines.

Value range: -1.5707963 ≤ AngleIn AngleIn AngleIn angleIn angle_in ≤ 3.1415927

DistInDistInDistIndistIndist_in (input_control)  hesseline.distance(-array) → HTupleMaybeSequence[float]HTupleHtuple (real) (double) (double) (double)

Distances of the input lines form the origin.

Number of elements: DistIn == AngleIn

LineWidthLineWidthLineWidthlineWidthline_width (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Widths of the lines.

Default: 7

Value range: 1 ≤ LineWidth LineWidth LineWidth lineWidth line_width

ThreshThreshThreshthreshthresh (input_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Threshold value for the number of line points in the region.

Default: 100

Value range: 1 ≤ Thresh Thresh Thresh thresh thresh

AngleOutAngleOutAngleOutangleOutangle_out (output_control)  hesseline.angle.rad(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Angles (in radians) of the normal vectors of the selected lines.

Number of elements: AngleOut <= AngleIn

Value range: -1.5707963 ≤ AngleOut AngleOut AngleOut angleOut angle_out ≤ 3.1415927

DistOutDistOutDistOutdistOutdist_out (output_control)  hesseline.distance(-array) → HTupleSequence[float]HTupleHtuple (real) (double) (double) (double)

Distances of the selected lines from the origin.

Number of elements: DistOut == AngleOut

Value range: 0 ≤ DistOut DistOut DistOut distOut dist_out

Result

The operator select_matching_linesselect_matching_linesSelectMatchingLinesSelectMatchingLinesselect_matching_lines returns the value 2 ( H_MSG_TRUE) if the input is not empty. The behavior in case of empty input (no input regions available) is set via the operator set_system('no_object_result',<Result>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>), the behavior in case of empty region is set via set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>). If necessary an exception is raised.

Possible Predecessors

hough_lineshough_linesHoughLinesHoughLineshough_lines

Module

Foundation

ClassesClasses | | Operators