Matches all lines to the left or right of the anchor line.

A "row" is lines of text distributed along a horizontal line. By default, each matching line in the "row" must have a top boundary that's within 0.08 inches below or above the anchor's top boundary (total range is 0.16" inches). For example, the following image shows a red line that defines the alignment for the row of text that begins with "Python":

Click to enlarge

Parameters
Examples
Notes

Parameters

keyvaluedescription
id (required)row
includeAnchorboolean. default: falseIncludes the anchor line in the method output
positionright, left. default: rightMatches to the left or right
tiebreakerFor information about this global parameter, see Method.For information about this global parameter, see Method.
tolerancenumber in inches. default: 0.08Configure this for unusual font sizes. By default, each matching line in the "row" must have a top boundary that's within 0.08 inches below or above the anchor's top boundary (total range is 0.16" inches). The default tolerance of 0.08 works well for font sizes around 12 pts (~0.17 inches). Configure this default when the font size of the row is unusual. For example, if your font size is a tiny 1.44 pt (0.02 inches), set this parameter to 0.01.

Examples

The following example shows extracting data from two consecutive tables using the Row method:

  1. The first field has an anchor with two matches to avoid duplicate text in the second table. First the anchor matches the text most popular on github, then it anchors on the text first in a row. The method then extracts the top-ranked GitHub language name to the left of the anchor match.
  2. The second field also has an anchor with two matches. It anchors on the row containing Python, then extracts the second percentage in the row to the right of the anchor.

Config

{
  "fields": [
    {
      "id": "number_1_language_on_github",
      "anchor": {
        "match": [
          {
            "text": "most popular on github",
            "type": "includes"
          },
          {
            "text": "first",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "position": "left",
      }
    },
    {
      "id": "python_change_in_TIBOE_rating",
      "type": "percentage",
      "anchor": {
        "match": [
          {
            "text": "popular in search engines",
            "type": "includes"
          },
          {
            "text": "Python",
            "type": "startsWith"
          }
        ]
      },
      "method": {
        "id": "row",
        "tiebreaker": 1
      }
    }
  ]
}

Example document

The following image shows the data extracted by this config for the following example document:

Click to enlarge

Example documentDownload link

Output

{
  "number_1_language_on_github": {
    "value": "Javascript",
    "type": "string"
  },
  "python_change_in_TIBOE_rating": {
    "source": "2.75%",
    "value": 2.75,
    "type": "percentage"
  }
}

Notes