# 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.

Inputs

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.

Outputs

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.