> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Nearest Functions

> Nearest functions in FlexiLayout (NearestX, NearestY, Nearest by interval, page edge, or hypothesis) that select the hypothesis closest to a reference.

**Nearest** functions tell the program that, other things being equal, it must select the hypothesis that is nearest to a certain element or point on the image that is specified by the parameters of the Nearest function. In the **Search Conditions** section of the element, you can use only one Nearest function. After the function is applied, only one hypotheses from a group of several hypotheses is selected. The selection occurs when hypotheses are being generated for the element, i.e. before the code entered in the **Hypotheses Evaluation** section is executed.

Nearest functions can be used to select hypotheses for any kind of elements except Groups and Repeating Groups.

| Function                                   | Description                                                                                                                                                                                                                                                                                                                                                                                                               |
| :----------------------------------------- | :------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `Void NearestX( XCoordinate x )`           | Selects the hypothesis nearest to the vertical line which goes through the point ( x, 0 ). **Example:** The code below specifies that the sought element is horizontally nearest to the right boundary of the ElementName element. `NearestX: ElementName.Right.Start;`                                                                                                                                                   |
| `Void NearestY( YCoordinate y )`           | Selects the hypothesis nearest to the horizontal line which goes through the point ( 0, y ). **Example:** The code below specifies that the sought element is vertically nearest to the top boundary of the ElementName element. `NearestY: ElementName.Top.Start;`                                                                                                                                                       |
| `Void Nearest( XInterval x, YInterval y )` | Selects the hypothesis nearest to the rectangle Rect( x.Start, y.Start, x.End, y.End ). **Example:** The code below specifies that the sought element is closest to the center of the ElementName element. `Nearest: ElementName.XCenter, ElementName.YCenter;` The code below specifies that the sought element is closest to the center of the page. `Nearest: Page(1).RectGlobal.XCenter, Page(1).RectGlobal.YCenter;` |
| `Void Nearest( PageEdge )`                 | Selects the hypothesis on each page of the document that is nearest to one of the page edges - top, bottom, right or left. **Note:** If several hypotheses are at the same distance from the specified boundary, several hypotheses may be selected. **Example:** To specify that the current element is closest to the bottom edge of the page, write. `Nearest: PageBottom;`                                            |
| `Void Nearest( Hypothesis hyp )`           | Selects the hypothesis nearest to the fuzzy rectangle hyp.Rect. **Example:** The code below specifies that the sought element is closest to the ElementName element. `Nearest: ElementName;`                                                                                                                                                                                                                              |
| `Void Nearest( HypothesisInstances )`      | Selects the hypothesis closest to the set of hypothesis for the specified Repeating Group element.                                                                                                                                                                                                                                                                                                                        |