PairEdges

Sorts arrays of edges into arrays of edge pairs. PairEdges scans an Edge data structure for edge pairs that fall within the specified tolerance. Edges belonging to a pair are ordered consecutively, such that the first edge of a pair is on an even index number and the second edge of a pair is on an odd index number.

Parameter Description

Edges

A reference to a spreadsheet cell containing an Edge data structure, which must consist of multiple straight-line edges.

Number of Pairs

Specifies the maximum number of pairs to be reported. (0 to 80; default = 1)

Edge: First

Specifies the polarity of the first edge in a pair. PairEdges only reports edge pairs whose first edge has the specified polarity.

0 = black-to-white

1 = white-to-black (default)

2 = either

Edge: Second

Specifies the polarity of the second edge in a pair. PairEdges only reports edge pairs whose second edge has the specified polarity.

0 = black-to-white (default)

1 = white-to-black

2 = either

Edge Dist: Min

Specifies the minimum arc distance (0 to 1920; default = 0) between edges in a pair. PairEdges only reports edge pairs that are more than Edge Dist: Min distance apart.

Edge Dist: Max

Specifies the maximum arc distance (0 to 1920; default = 50) between edges in a pair. PairEdges only reports edge pairs that are less than Edge Dist: Max distance apart.

Intermediate Edges

Specifies the expected number and polarity of edges that fall between the end points of an edge pair. PairEdges only reports edge pairs with an expected number of intermediate edges.

Min B2W

Specifies the minimum number of black-to-white edges expected between the end points of an edge pair. (0 to 320; default = 0)

Max B2W

Specifies the maximum number of black-to-white edges expected between the end points of an edge pair. (0 to 320; default = 0)

Min W2B

Specifies the minimum number of white-to-black edges expected between the end points of an edge pair. (0 to 320; default = 0)

Max W2B

Specifies the maximum number of white-to-black edges expected between the end points of an edge pair. (0 to 320; default = 0)

Show

Specifies the display mode for PairEdges graphical overlays on top of the image.

0 = hide all (default)

All graphics are hidden, except when the cell containing the PairEdges function is the active cell in the spreadsheet.

1 = result graphics only

The line edges are displayed at all times.

Returns

An Edge data structure containing paired edges, or #ERR if any of the input parameters are invalid.

Results

When PairEdges is initially inserted into a cell, a result table is created in the spreadsheet.

The following Edges Vision Data Access functions are automatically inserted into the spreadsheet to create the result table:

Label Function Description

NumPairs

GetNFound(Edges)

The number of edge pairs found.

MinDist

PairMinDistance(Edges)

The minimum distance between paired edges.

MaxDist

PairMaxDistance(Edges)

The maximum distance between paired edges.

MeanDist

PairMeanDistance(Edges)

The mean distance between paired edges.

SDevDist

PairSDevDistance(Edges)

The standard deviation of the distance between paired edges.

Additional data elements can be accessed using Edges Vision Data Access functions.