SAPMLTextObservationTopology

public class SAPMLTextObservationTopology

When you receive observations in observationHandler, it can be tedious to filter out observations of interest. This class orders the array of SAPMLTextObservation into a grid topology that makes it easier for users to traverse and search observations in observationHandler. SAPMLTextObservationTopology also helps in finding observations that are nearby for a given SAPMLTextObservation.

## Example Initialization and Configuration

 recognitionView.observationHandler = { observations

    let topology = SAPMLTextObservationTopology(observations)

    // Rows, Columns, and Blocks of these observations can be accessed by relevant instance variables

    return true;
 }

## Setting Custom blockCreationDistance While Creating a Topology This parameter in init helps in getting blocks that the user desires. blockCreationDistance indicates how far two observations can be from each other and still be in same block. The default value is 0.01. The larger the value, the more observations that are far away will be considered to be in the same block.

    let topology = SAPMLTextObservationTopology(observations, blockCreationDistance: 0.1)

## Accessing Adjacent Observations previousObservationInLine, nextObservationInLine, previousObservationInColumn, and nextObservationInColumn methods of SAPMLTextObservationTopology help a user get the adjacent observation of a given SAPMLTextObservation.

For example, to get the last name observation that is known to be in the same line as the first name observation and last name is to the right of the first name. Do the following to get the last name observation from the first name observation.

    let lastNameObservation = topology.nextObservationInLine(firstNameObservation)