ibm-research/VAREX

Dataset

7

stars

8

commits

1

linked in READMEs

Mar 18, 2026

updated

benchmark
document-ai
document-extraction
form-understanding
json-schema
multimodal
structured-extraction
Browse cluster: Multimodal Benchmarks & Video Understanding

README

VAREX: A Benchmark for Multi-Modal Structured Extraction from Documents

VAREX (VARied-schema EXtraction) is a benchmark for evaluating multimodal foundation models on structured data extraction from government forms. It comprises 1,777 documents with 1,771 unique schemas across three structural categories, each provided in four input modalities. Ground truth is deterministic — generated via a Reverse Annotation pipeline that programmatically fills PDF templates with synthetic values, validated through three-phase quality assurance achieving ~98.5% field-level accuracy.

Paper: arXiv:2603.15118

Evaluation code & scoring: github.com/udibarzi/varex-bench

Quick Start

from datasets import load_dataset
import json

ds = load_dataset("ibm-research/VAREX", split="benchmark")

doc = ds[0]
print(doc["doc_id"])        # e.g., "1044"
print(doc["split"])         # "Flat", "Nested", or "Table"

schema = json.loads(doc["schema"])
gt = json.loads(doc["ground_truth"])
image = doc["image"]        # PIL Image, 200 DPI
text = doc["text_layout"]   # Spatial text with layout

Columns

ColumnTypeDescription
doc_idstringUnique document identifier
splitstringStructural category: Flat, Nested, or Table
imageImageDocument page rendered at 200 DPI (primary evaluation modality)
image_50dpiImageDocument page rendered at 50 DPI (resolution robustness evaluation)
schemastringJSON Schema defining the extraction target
ground_truthstringJSON ground truth values
text_flowstringPlain text in reading order
text_layoutstringSpatial text with whitespace-preserved layout

Input Modalities

ModalityPaper codeColumn(s) to use
Plain TextPtext_flow
Spatial TextStext_layout
ImageVimage (or image_50dpi for robustness)
Spatial Text + ImageS+Vtext_layout + image

Document Splits

SplitDocumentsDescription
Flat299Simple key-value schemas, no nesting
Nested1,146Schemas with nested objects
Table332Schemas with arrays of objects

PDF Files

Original filled PDFs are available in the pdfs/ directory of this repository. Each filename corresponds to the doc_id column (e.g., doc_id "1044"pdfs/1044.pdf). These allow researchers to apply their own text extraction or parsing pipelines.

Scoring

Evaluation code, scoring scripts, and field exclusion lists are maintained at: github.com/udibarzi/varex-bench

The benchmark uses Exact Match (EM) as the primary metric with order-invariant array matching via the Hungarian algorithm. 610 field-level exclusions are applied at scoring time for fields with known ground truth issues.

Citation

@inproceedings{varex2026,
  title   = {VAREX: A Benchmark for Multi-Modal Structured Extraction from Documents},
  author  = {Barzelay, Udi and Azulai, Ophir and Shapira, Inbar and Friedman, Idan and Abo Dahood, Foad and Lee, Madison and Daniels, Abraham},
  year    = {2026}
}

License

Community Data License Agreement – Permissive, Version 2.0

Contributors

Udibarzi

8 commits

ibm-research/VAREX

Dataset

7

stars

8

commits

1

linked in READMEs

Mar 18, 2026

updated

benchmark
document-ai
document-extraction
form-understanding
json-schema
multimodal
structured-extraction
Browse cluster: Multimodal Benchmarks & Video Understanding

README

VAREX: A Benchmark for Multi-Modal Structured Extraction from Documents

VAREX (VARied-schema EXtraction) is a benchmark for evaluating multimodal foundation models on structured data extraction from government forms. It comprises 1,777 documents with 1,771 unique schemas across three structural categories, each provided in four input modalities. Ground truth is deterministic — generated via a Reverse Annotation pipeline that programmatically fills PDF templates with synthetic values, validated through three-phase quality assurance achieving ~98.5% field-level accuracy.

Paper: arXiv:2603.15118

Evaluation code & scoring: github.com/udibarzi/varex-bench

Quick Start

from datasets import load_dataset
import json

ds = load_dataset("ibm-research/VAREX", split="benchmark")

doc = ds[0]
print(doc["doc_id"])        # e.g., "1044"
print(doc["split"])         # "Flat", "Nested", or "Table"

schema = json.loads(doc["schema"])
gt = json.loads(doc["ground_truth"])
image = doc["image"]        # PIL Image, 200 DPI
text = doc["text_layout"]   # Spatial text with layout

Columns

ColumnTypeDescription
doc_idstringUnique document identifier
splitstringStructural category: Flat, Nested, or Table
imageImageDocument page rendered at 200 DPI (primary evaluation modality)
image_50dpiImageDocument page rendered at 50 DPI (resolution robustness evaluation)
schemastringJSON Schema defining the extraction target
ground_truthstringJSON ground truth values
text_flowstringPlain text in reading order
text_layoutstringSpatial text with whitespace-preserved layout

Input Modalities

ModalityPaper codeColumn(s) to use
Plain TextPtext_flow
Spatial TextStext_layout
ImageVimage (or image_50dpi for robustness)
Spatial Text + ImageS+Vtext_layout + image

Document Splits

SplitDocumentsDescription
Flat299Simple key-value schemas, no nesting
Nested1,146Schemas with nested objects
Table332Schemas with arrays of objects

PDF Files

Original filled PDFs are available in the pdfs/ directory of this repository. Each filename corresponds to the doc_id column (e.g., doc_id "1044"pdfs/1044.pdf). These allow researchers to apply their own text extraction or parsing pipelines.

Scoring

Evaluation code, scoring scripts, and field exclusion lists are maintained at: github.com/udibarzi/varex-bench

The benchmark uses Exact Match (EM) as the primary metric with order-invariant array matching via the Hungarian algorithm. 610 field-level exclusions are applied at scoring time for fields with known ground truth issues.

Citation

@inproceedings{varex2026,
  title   = {VAREX: A Benchmark for Multi-Modal Structured Extraction from Documents},
  author  = {Barzelay, Udi and Azulai, Ophir and Shapira, Inbar and Friedman, Idan and Abo Dahood, Foad and Lee, Madison and Daniels, Abraham},
  year    = {2026}
}

License

Community Data License Agreement – Permissive, Version 2.0

Contributors

Udibarzi

8 commits