Upload 5 files
Browse files- README.md +37 -0
- config.json +16 -0
- model.safetensors +3 -0
- reading.md +54 -0
- training_args.json +9 -0
README.md
ADDED
|
@@ -0,0 +1,37 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
---
|
| 2 |
+
license: cc-by-4.0
|
| 3 |
+
tags:
|
| 4 |
+
- research-notes
|
| 5 |
+
- document-ai
|
| 6 |
+
---
|
| 7 |
+
|
| 8 |
+
# Notes on Document AI
|
| 9 |
+
|
| 10 |
+
## Repository summary
|
| 11 |
+
|
| 12 |
+
A structured set of research notes on **Document AI**, with concrete evaluation references and open questions. Plans and hypotheses are kept separate from completed results.
|
| 13 |
+
|
| 14 |
+
## What is covered
|
| 15 |
+
|
| 16 |
+
- the scope of the research question and likely confounders
|
| 17 |
+
- a proposed comparison with matched baselines
|
| 18 |
+
- concrete evaluation context such as FUNSD, SROIE, and CORD
|
| 19 |
+
- reproducibility checks, failure modes, and open questions
|
| 20 |
+
- topic-relevant references
|
| 21 |
+
|
| 22 |
+
## How to read this repository
|
| 23 |
+
|
| 24 |
+
Start with `reading.md` for the full note. Sections labeled as plans or hypotheses should not be interpreted as experimental results. If results are added later, they should include dataset versions, commands, seeds, hardware, and raw logs.
|
| 25 |
+
|
| 26 |
+
## Scope and limitations
|
| 27 |
+
|
| 28 |
+
The note is intentionally exploratory. It does not claim benchmark improvements, completed ablations, released code, or a trained checkpoint. References and proposed datasets provide a starting point for verification rather than evidence that the study has already been run.
|
| 29 |
+
|
| 30 |
+
## Files
|
| 31 |
+
|
| 32 |
+
- `reading.md` — primary artifact
|
| 33 |
+
- `README.md` — this documentation
|
| 34 |
+
|
| 35 |
+
## License
|
| 36 |
+
|
| 37 |
+
Released under **cc-by-4.0**. Review the source-data terms separately when this repository is used with external datasets.
|
config.json
ADDED
|
@@ -0,0 +1,16 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"architectures": [
|
| 3 |
+
"CustomResearchModel"
|
| 4 |
+
],
|
| 5 |
+
"architecture": "transformer",
|
| 6 |
+
"model_type": "transformer",
|
| 7 |
+
"hidden_size": 256,
|
| 8 |
+
"num_hidden_layers": 6,
|
| 9 |
+
"num_attention_heads": 2,
|
| 10 |
+
"intermediate_size": 1024,
|
| 11 |
+
"hidden_act": "gelu",
|
| 12 |
+
"max_position_embeddings": 256,
|
| 13 |
+
"layer_norm_eps": 1e-12,
|
| 14 |
+
"checkpoint_status": "initialization-only",
|
| 15 |
+
"notes": "Untrained checkpoint for smoke tests; no benchmark claim."
|
| 16 |
+
}
|
model.safetensors
ADDED
|
@@ -0,0 +1,3 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
version https://git-lfs.github.com/spec/v1
|
| 2 |
+
oid sha256:fce82238203c1dd954c3c2566b9161bbb3d124921e7de7ad51bec678307ab7c2
|
| 3 |
+
size 132832
|
reading.md
ADDED
|
@@ -0,0 +1,54 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
# Document Ai: Research Notes
|
| 2 |
+
|
| 3 |
+
## Status
|
| 4 |
+
|
| 5 |
+
Working note / experiment plan. No completed benchmark results are claimed here.
|
| 6 |
+
|
| 7 |
+
## 1. Scope and motivation
|
| 8 |
+
|
| 9 |
+
These notes organize a possible evaluation of layout-aware representations for documents and irregular visual text. The central question is whether the proposed change improves the target behavior under a matched training and evaluation budget. The note deliberately separates hypotheses from observations so that future results can be added without rewriting the rationale.
|
| 10 |
+
|
| 11 |
+
## 2. Context
|
| 12 |
+
|
| 13 |
+
Research on document ai often mixes improvements from architecture, data scale, preprocessing, and compute. A useful comparison therefore needs controlled baselines and explicit reporting of resource use. For this topic, the main confound is that results can be dominated by OCR quality, language coverage, and annotation conventions.
|
| 14 |
+
|
| 15 |
+
## 3. Working hypothesis
|
| 16 |
+
|
| 17 |
+
A focused change to the representation or interaction mechanism may improve entity-level F1 without increasing deployment cost disproportionately. The hypothesis should be rejected if gains disappear after matching parameter count, data exposure, or tuning budget.
|
| 18 |
+
|
| 19 |
+
## 4. Proposed approach
|
| 20 |
+
|
| 21 |
+
The first implementation should keep modality-specific preprocessing simple, project inputs into a shared representation space, and isolate the new component behind a small interface. Baselines should include a comparable model without the component and a stronger off-the-shelf reference. Any optimization should be applied to all systems, not only the proposed one.
|
| 22 |
+
|
| 23 |
+
## 5. Evaluation plan
|
| 24 |
+
|
| 25 |
+
| Dataset | Role | Primary measure |
|
| 26 |
+
|---|---|---|
|
| 27 |
+
| FUNSD | primary evaluation | entity-level F1 |
|
| 28 |
+
| SROIE | transfer / robustness | character error rate |
|
| 29 |
+
| CORD | transfer / robustness | exact match |
|
| 30 |
+
|
| 31 |
+
Planned comparisons include a matched-capacity baseline, an ablation that removes the proposed component, and an out-of-domain transfer check. Default training values for the first controlled run are learning rate `0.0002`, batch size `48`, and `5` independent seeds. These are planning values, not claims about a finished experiment.
|
| 32 |
+
|
| 33 |
+
## 6. Reproducibility checklist
|
| 34 |
+
|
| 35 |
+
- Separate model selection from final evaluation.
|
| 36 |
+
- Run at least one out-of-domain test.
|
| 37 |
+
- Track failed runs as well as successful runs.
|
| 38 |
+
- Document every exclusion rule.
|
| 39 |
+
|
| 40 |
+
## 7. Failure modes and responsible use
|
| 41 |
+
|
| 42 |
+
The analysis should report subgroup and category-level failures instead of relying only on a single aggregate score. Particular attention is needed because results can be dominated by OCR quality, language coverage, and annotation conventions. No production use is recommended without task-specific validation, data review, and an assessment of privacy and bias.
|
| 43 |
+
|
| 44 |
+
## 8. Open questions
|
| 45 |
+
|
| 46 |
+
- Which gain survives when the compute budget is matched?
|
| 47 |
+
- Does the proposed component improve calibration as well as the primary metric?
|
| 48 |
+
- How sensitive is the conclusion to preprocessing and random seed?
|
| 49 |
+
|
| 50 |
+
## References
|
| 51 |
+
|
| 52 |
+
[1] Xu et al., LayoutLM, 2020.
|
| 53 |
+
[2] Kim et al., Donut, 2022.
|
| 54 |
+
[3] Jaume et al., FUNSD, 2019.
|
training_args.json
ADDED
|
@@ -0,0 +1,9 @@
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 1 |
+
{
|
| 2 |
+
"optimizer": "adamw",
|
| 3 |
+
"scheduler": "cosine",
|
| 4 |
+
"learning_rate": 0.0001,
|
| 5 |
+
"batch_size": 24,
|
| 6 |
+
"epochs": 30,
|
| 7 |
+
"seed": 3407,
|
| 8 |
+
"status": "default recipe; not a completed run"
|
| 9 |
+
}
|