Vertical

The 'Maximum Distance' property limits how far apart elements can be (measured from the bottom edge of one to the top edge of the next) and still be considered part of the same vertical array.

• Enter a numeric value (e.g., 1.0) to specify the maximum allowed distance in inches.
• Set to 0 to disable this constraint (no maximum).

This property is useful for preventing unrelated values from being grouped together, especially in documents with wide spacing or multiple columns.

The 'Maximum Line Spacing' property limits the vertical distance between elements as a percentage of the smaller font size of the two elements.

• Enter a numeric value (e.g., 1.5) to specify the maximum allowed spacing as a multiple of font size (e.g., 1.5 = 150%).
• Set to 0 to disable this constraint.

This property is especially useful for documents with variable font sizes or when extracting from scanned images, where absolute distances may not accurately reflect visual spacing.

> Tip: Use this property to prevent grouping elements that are separated by unusually large gaps, such as section breaks or unrelated content.

A combination of the following flags:

The HorizontalDataAlignment enumeration controls how elements must be horizontally aligned to be considered part of the same vertical array when using the Vertical layout provider.

This setting is critical for accurately extracting columns from tables, lists, or other vertically arranged data, especially in documents where alignment may not be perfect due to scanning, formatting, or layout inconsistencies.

How It Works

• The selected value(s) determine which part of each element (left, center, or right) is compared for alignment.
• The 'Alignment Tolerance' property specifies how much horizontal misalignment is allowed.
• Multiple alignment modes can be combined using flags, allowing for flexible matching.

Configuration Guidance

• Use 'Any' for loosely aligned data, such as lists or columns with variable widths.
• Use 'Left', 'Center', or 'Right' for structured tables or forms where fields are expected to align on a specific edge or centerline.
• Adjust 'Alignment Tolerance' to accommodate minor misalignments.

Example

If extracting a table where all cells are left-aligned, set the alignment to Left. If cells may be center- or right-aligned, combine flags as needed (e.g., Left | Center).

The 'Alignment Tolerance' property specifies how much horizontal misalignment is permitted between elements for them to be considered aligned according to the selected 'Alignment' mode.

• Enter a numeric value (e.g., 0.05) to specify the allowed tolerance in inches.
• Increase the value to allow for greater misalignment, which can be helpful for scanned or poorly formatted documents.

Example

If elements are intended to be left-aligned but may be off by up to 0.1 inches, set 'Alignment Tolerance' to 0.1.

The 'Enforce Line Boundaries' property, when set to true, ensures that elements separated by a horizontal dividing line in the document layout are not grouped into the same vertical array.

This is useful for documents with table borders or form lines, where values on opposite sides of a line should not be considered part of the same array.

> Note: If disabled, elements may be grouped even if a horizontal line is present between them.

The 'Maximum Size Variation' property controls how much the font size can differ between adjacent array elements for them to be grouped together by the Layout Provider.

• The value is expressed as a percentage (e.g., 0.2 for 20%) and is calculated as the difference between the two font sizes, divided by the smaller of the two.
• A value of 1.0 (the default) disables this constraint, allowing any amount of font size variation.
• Lower values enforce stricter matching, which is useful for documents where array elements are expected to have consistent formatting.
• Increase the value to allow for more variation, which can be helpful for documents with mixed font sizes or inconsistent OCR results.

Example

• If set to 0.2, two elements with font sizes of 10pt and 12pt (a 20% difference) will be grouped, but 10pt and 15pt (a 50% difference) will not.

Usage Notes

• Use a lower value to prevent unrelated elements with different font sizes from being grouped together.
• Use the default value (1.0) to ignore font size differences and group all elements regardless of formatting.