deeptable-checkpoints-qwen25-7b

DeepTable — Qwen2.5-7B-Instruct checkpoints

Trained adapters for "DeepTable: Structural Attention Biases and Tree Path Encoding for Hierarchical Table Understanding." This repo holds the Qwen2.5-7B-Instruct checkpoints behind Table 2 of the paper — the TableLoRA baseline, SAB-only, TPE-only, and the combined DeepTable (SAB+TPE), across all four benchmarks and all four seeds.

Code: <!-- TODO: link to the deeptable_code_submission repo on first push -->

Other backbones: DeepSeek-LLM-7B-Chat · Llama-3-8B-Instruct

What's here

This is the one backbone where the TableLoRA baseline checkpoints ARE included. Qwen2.5-7B was not evaluated in the original TableLoRA paper, so unlike DeepSeek-LLM-7B-Chat and Llama-3-8B-Instruct (whose Table 2 baseline numbers are cited from He et al., 2025), the Qwen2.5 baseline was reproduced locally and is the source of Table 2's number. Verified by rescoring every predict/generated_predictions.jsonl against the paper's cited values — all four benchmarks match to two decimal places:

64 checkpoints total (4 benchmarks × 4 variants × 4 seeds).

File layout

Each {dataset}_{variant}_seed{n}/ directory is one trained run:

hitab_full_seed0/
├── adapter_config.json         ─┐ TableLoRA's [TAB]/[ROW]/[CELL] prompt
├── adapter_model.safetensors   ─┘ encoder (PEFT P_TUNING adapter, "default")
├── default_1/
│   ├── adapter_config.json     ─┐ the actual 2D-LoRA weights (rank 8,
│   └── adapter_model.safetensors┘ k_proj+v_proj) — PEFT adapter "default_1"
├── sab_module.safetensors        Structural Attention Bias (α_row/α_col)
│                                 — present for "sabonly" and "full" only
├── tpe_modules.safetensors        Tree Path Encoding embedding tables
├── tpe_path_vocab.json            — path-node vocabulary used at train time
├── tpe_metadata.json               — present for "tpeonly" and "full" only
├── tokenizer.json / tokenizer_config.json / special_tokens_map.json
├── train_results.json / all_results.json / trainer_state.json
└── predict/
    └── generated_predictions.jsonl   — the model's own test-set predictions,
                                         so you can verify a checkpoint's score
                                         without re-running inference

Two stacked PEFT adapters, not one. This is TableLoRA's design, not a packaging artifact: the top-level directory is a P_TUNING adapter (the [TAB]/[ROW]/[CELL] prompt encoder), and default_1/ is a separate LORA adapter (the actual attention-projection weights that do most of the work). Both are required — loading only one silently drops half the trained model. tablelora-variant checkpoints have the same two-adapter structure (emb_lora: true was on for every run, including the baseline) but no sab_module.safetensors / tpe_modules.safetensors. Plain peft.PeftModel.from_pretrained() does not know to look inside default_1/; this repo's overlay patches PeftModel.from_pretrained to auto-discover every subfolder containing an adapter_config.json (except checkpoint-*, predict, runs), which is why loading must go through that patched code path — see below.

How to load

Use the DeepTable code repo (setup.sh + this checkpoint as adapter_name_or_path), the same way README step 5 (Predict) does:

export TABLE_LORA_ENABLED=1   # installs the patched PeftModel.from_pretrained
                               # that auto-discovers default_1/

python -m tpe_impl.bin.run_tpe_training configs/hitab_tpe.yaml \
    # with do_train: false, do_predict: true, template: qwen,
    # adapter_name_or_path: <path to this checkpoint dir>

tablelora and sabonly checkpoints (no tpe_modules.safetensors) can launch directly with llamafactory-cli train <yaml> instead — only tpeonly and full need the run_tpe_training.py wrapper, since that is what reloads tpe_modules.safetensors via load_tpe_state().

Reproducing these scores

python evaluation/eval_accuracy.py    <checkpoint>/predict   # HiTab
python evaluation/eval_wikitq.py      <checkpoint>/predict   # WikiTQ
python evaluation/eval_fetaqa_bleu.py <checkpoint>/predict   # FeTaQA
python evaluation/eval_tabfact.py     <checkpoint>/predict   # TabFact

Note: evaluation/eval_wikitq.py's summary line prints a "(multi-value subset: N/M = X%)" figure alongside the real accuracy — use the "Accuracy:" line, not that parenthetical, when comparing against Table 2.

Training configuration

LoRA rank 8 on k_proj,v_proj; base LR 5e-6, cosine, 3 epochs; SAB/TPE add-on LR multiplier λ=1000 (SAB_LR_MULTIPLIER env var / tpe_lr_multiplier YAML key). Full details and the exact training YAMLs are in the code repo's configs/README.md and Appendix G of the paper.

License

MIT, matching the code repo. See the code repo's LICENSE / NOTICE — the base model (Qwen/Qwen2.5-7B-Instruct, Apache-2.0) and TableLoRA's 2D-LoRA mechanism these adapters extend carry their own upstream licenses.