get_contour_global_attrib_xldT_get_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld (Operator)

Name

get_contour_global_attrib_xldT_get_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXld — Return global attributes values of an XLD contour.

Signature

Description

get_contour_global_attrib_xldget_contour_global_attrib_xldGetContourGlobalAttribXldGetContourGlobalAttribXldGetContourGlobalAttribXld returns the values of the global attribute NameNameNameNamename of the XLD contour ContourContourContourContourcontour in AttribAttribAttribAttribattrib. Global attributes are additional values defined for each contour. query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld can be used to query which global attributes are set for a particular contour.

The following list contains information about the different global contour attributes and the operators that add them to XLD contours:

'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark"

The type of transition for each output XLD contour is stored in the attribute 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark". It is set to 1.0, if the connecting line forms a bright-dark transition (left to right, viewed from start point to end point), otherwise it is set to 0.0.

The attribute 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark" is added by the following operator:

connect_grid_pointsconnect_grid_pointsConnectGridPointsConnectGridPointsConnectGridPoints

Exemplary XLD contours (red and green) along the edges of a rectification grid (direction from start to end point indicated by arrow head). The transition type, stored in the attribute 'bright_dark'"bright_dark""bright_dark""bright_dark""bright_dark", is 1.0 for red contours and 0.0 for green contours.

'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx"

The best way to approximate a contour is stated by the attribute 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx": for 'cont_approx'=-1, the contour is best approximated by a line segment, for 'cont_approx'=0, by an elliptic arc, and for 'cont_approx'=1, by a circular arc.

The attribute 'cont_approx'"cont_approx""cont_approx""cont_approx""cont_approx" is added by the following operator:

segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldSegmentContoursXld

'is_hole'"is_hole""is_hole""is_hole""is_hole"

For boundaries that enclose holes, the global contour attribute 'is_hole'"is_hole""is_hole""is_hole""is_hole" is set to 1, otherwise, it is set to 0.

The attribute 'is_hole'"is_hole""is_hole""is_hole""is_hole" is added by the following operators:

symm_difference_closed_contours_xldsymm_difference_closed_contours_xldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXldSymmDifferenceClosedContoursXld, difference_closed_contours_xlddifference_closed_contours_xldDifferenceClosedContoursXldDifferenceClosedContoursXldDifferenceClosedContoursXld, intersection_closed_contours_xldintersection_closed_contours_xldIntersectionClosedContoursXldIntersectionClosedContoursXldIntersectionClosedContoursXld, union2_closed_contours_xldunion2_closed_contours_xldUnion2ClosedContoursXldUnion2ClosedContoursXldUnion2ClosedContoursXld

Applying different set operations to XLD contours or contour sets adds the global attribute 'is_hole'"is_hole""is_hole""is_hole""is_hole" to the resulting contour(s). In the example above, for two sets (red and green) of closed contours different set operations are performed. If a resulting boundary encloses a hole (blue contours), 'is_hole'"is_hole""is_hole""is_hole""is_hole" is set to 1.0, otherwise the value of 'is_hole'"is_hole""is_hole""is_hole""is_hole" is 0.0 (orange contours).

'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist"

'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist" [px] gives the standard deviation of the (Euclidean) distances between the contour points and the regression line (see image below).

The attribute 'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist" is added by the following operator:

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist"

'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist" [px] gives the minimal distance of the regression line from the origin of the image coordinate system (see image below).

The attribute 'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist" is added by the following operator:

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist"

The attribute 'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist" [px] contains the mean of the Euclidian distances between each contour point and the regression line (see image below).

The attribute 'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist" is added by the following operator:

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col"

'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col" [px] is the column coordinate of the unit normal vector of the regression line with the normal vector pointing from the origin to the line (see image below).

The attribute 'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col" is added by the following operator:

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row"

'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row" [px] is the row coordinate of the unit normal vector of the regression line with the normal vector pointing from the origin to the line (see image below).

The attribute 'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row" is added by the following operator:

regress_contours_xldregress_contours_xldRegressContoursXldRegressContoursXldRegressContoursXld

Sketch of the attributes 'regr_dist'"regr_dist""regr_dist""regr_dist""regr_dist", 'regr_norm_col'"regr_norm_col""regr_norm_col""regr_norm_col""regr_norm_col", 'regr_norm_row'"regr_norm_row""regr_norm_row""regr_norm_row""regr_norm_row" for the regression of an XLD contour (red). 'regr_mean_dist'"regr_mean_dist""regr_mean_dist""regr_mean_dist""regr_mean_dist" and 'regr_dev_dist'"regr_dev_dist""regr_dev_dist""regr_dev_dist""regr_dev_dist" are computed from the distances (black arrows) between the contour points and the regression line (solid black line).

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

Possible Predecessors

lines_gausslines_gaussLinesGaussLinesGaussLinesGauss, lines_facetlines_facetLinesFacetLinesFacetLinesFacet, edges_sub_pixedges_sub_pixEdgesSubPixEdgesSubPixEdgesSubPix, segment_contours_xldsegment_contours_xldSegmentContoursXldSegmentContoursXldSegmentContoursXld

Possible Successors

fit_circle_contour_xldfit_circle_contour_xldFitCircleContourXldFitCircleContourXldFitCircleContourXld, fit_ellipse_contour_xldfit_ellipse_contour_xldFitEllipseContourXldFitEllipseContourXldFitEllipseContourXld, fit_line_contour_xldfit_line_contour_xldFitLineContourXldFitLineContourXldFitLineContourXld, fit_rectangle2_contour_xldfit_rectangle2_contour_xldFitRectangle2ContourXldFitRectangle2ContourXldFitRectangle2ContourXld

See also

query_contour_global_attribs_xldquery_contour_global_attribs_xldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXldQueryContourGlobalAttribsXld, get_contour_attrib_xldget_contour_attrib_xldGetContourAttribXldGetContourAttribXldGetContourAttribXld, query_contour_attribs_xldquery_contour_attribs_xldQueryContourAttribsXldQueryContourAttribsXldQueryContourAttribsXld

Module

Foundation