lucaschroeder commited on
Commit
0f9d6ae
·
verified ·
1 Parent(s): 3d2baaf

Upload 5 files

Browse files
Files changed (5) hide show
  1. README.md +37 -0
  2. config.json +16 -0
  3. model.safetensors +3 -0
  4. reading.md +54 -0
  5. 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
+ }