segment_contour_attrib_xld🔗
Short description🔗
segment_contour_attrib_xld — Segment XLD contour parts whose local attributes fulfill given
conditions.
Signature🔗
segment_contour_attrib_xld( xld_cont Contour, out xld_cont ContourPart, string Attribute, string Operation, real Min, real Max )
Description🔗
segment_contour_attrib_xld segments the contour in
Contour into contour parts ContourPart. The segmentation
of the contour depends on the values of its attributes Attribute
(see the possible values for Attribute below).
The operator checks which attribute values lie within the given limits
(Min, Max) and returns the corresponding contour
segments with its attributes in ContourPart.
If Operation is set to 'and', each of the given attributes
must lie within the limits.
If Operation is set to 'or', at least one of
the attributes has to be within the limits. The attributes are processed
in the same order as they are given in Attribute.
If only one attribute is used, the value of Operation is
ignored.
The parameters Min and Max can be set to
'min' or 'max' in order to leave bottom and top limit,
respectively, open.
Note that not all attributes are defined in all contours per default.
Which attributes
are defined for a contour depends on how the contour was
instantiated, and whether some operations have been previously performed on
it. For example, the attributes 'width_right' and
'width_left' are only
defined, if the contour was created with the operator lines_gauss.
Likewise, the attribute 'distance' is only present if the distances
to some other contour was previously calculated with
distance_contours_xld or apply_distance_transform_xld.
Condition: \(Min_{i} \leq Attribute_{i}(Object) \leq Max_{i}\)
Possible values for Attribute:
-
‘edge_direction’: Edge direction
-
‘angle’: Angle of the direction perpendicular to the contour
-
‘response’: Magnitude of the second derivative
-
‘width_right’: Line width to the right of the line
-
‘width_left’: Line width to the left of the line
-
‘contrast’: Contrast of the line point
-
‘asymmetry’: Asymmetry of the line point
-
‘distance’: Minimum pointwise distance to a reference contour
To find out which operators add the attributes above to contours and further
details about those attributes, see get_contour_attrib_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🔗
Contour (input_object) xld_cont(-array) → object
Contour to be segmented.
ContourPart (output_object) xld_cont-array → object
Segmented contour parts.
Attribute (input_control) string(-array) → (string)
Contour attributes to be checked.
Default: 'distance'
List of values: 'angle', 'asymmetry', 'contrast', 'distance', 'edge_direction', 'response', 'width_left', 'width_right'
Operation (input_control) string → (string)
Linkage type of the individual attributes.
Default: 'and'
List of values: 'and', 'or'
Min (input_control) real(-array) → (real / integer / string)
Lower limits of the attribute values.
Default: 150.0
Minimum increment: 0.001
Recommended increment: 1.0
Max (input_control) real(-array) → (real / integer / string)
Upper limits of the attribute values.
Default: 99999.0
Minimum increment: 0.001
Recommended increment: 1.0
Restriction: Max >= Min
Example🔗
(HDevelop)
read_image (Image, 'fabrik')
edges_sub_pix (Image, Edges, 'canny', 1, 20, 40)
* select 'vertical' edges:
segment_contour_attrib_xld (Edges, ContourPart, 'edge_direction', \
'and', rad(90-20), rad(90+20))
Result🔗
The operator segment_contour_attrib_xld returns the value 2 (H_MSG_TRUE)
if the input is not empty. The behavior in case of empty input
(no input objects available) is set via the operator
set_system('no_object_result',<Result>).
If necessary, an exception is raised.
Combinations with other operators🔗
Combinations
Possible predecessors
lines_gauss, edges_sub_pix, apply_distance_transform_xld, distance_contours_xld
Possible successors
fit_line_contour_xld, fit_ellipse_contour_xld, fit_circle_contour_xld, fit_rectangle2_contour_xld
See also
split_contours_xld, get_contour_global_attrib_xld, query_contour_attribs_xld, get_contour_attrib_xld
Module🔗
Foundation