Open-weight model · Table question answering
tapex-base-finetuned-wikisql
by Microsoft microsoft/tapex-base-finetuned-wikisql
TAPEX was proposed in TAPEX: Table Pre-training via Learning a Neural SQL Executor by Qian Liu, Bei Chen, Jiaqi Guo, Morteza Ziyadi, Zeqi Lin, Weizhu Chen, Jian-Guang Lou. The original repo can be found here.
Model Card
By Microsoft, published under mit, revision 1e7e530d8732.
TAPEX was proposed in TAPEX: Table Pre-training via Learning a Neural SQL Executor by Qian Liu, Bei Chen, Jiaqi Guo, Morteza Ziyadi, Zeqi Lin, Weizhu Chen, Jian-Guang Lou. The original repo can be found here. TAPEX (Table Pre-training via Execution) is a conceptually simple and empirically powerful pre-training approach to empower existing models with table reasoning skills. TAPEX realizes table pre-training by learning a neural SQL executor over a synthetic corpus, which is obtained by automatically synthesizing executable SQL queries. TAPEX is based on the BART architecture, the transformer encoder-encoder (seq2seq) model with a bidirectional (BERT-like) encoder and an autoregressive…
Read Microsoft's full model card
TAPEX (base-sized model)
TAPEX was proposed in TAPEX: Table Pre-training via Learning a Neural SQL Executor by Qian Liu, Bei Chen, Jiaqi Guo, Morteza Ziyadi, Zeqi Lin, Weizhu Chen, Jian-Guang Lou. The original repo can be found here.
Model description
TAPEX (Table Pre-training via Execution) is a conceptually simple and empirically powerful pre-training approach to empower existing models with table reasoning skills. TAPEX realizes table pre-training by learning a neural SQL executor over a synthetic corpus, which is obtained by automatically synthesizing executable SQL queries.
TAPEX is based on the BART architecture, the transformer encoder-encoder (seq2seq) model with a bidirectional (BERT-like) encoder and an autoregressive (GPT-like) decoder.
This model is the tapex-base model fine-tuned on the WikiSQL dataset.
Intended Uses
You can use the model for table question answering on relatively simple questions. Some solveable questions are shown below (corresponding tables now shown):
| Question | Answer |
|---|---|
| tell me what the notes are for south australia | no slogan on current series |
| what position does the player who played for butler cc (ks) play? | guard-forward |
| how many schools did player number 3 play at? | 1.0 |
| how many winning drivers in the kraco twin 125 (r2) race were there? | 1.0 |
| for the episode(s) aired in the u.s. on 4 april 2008, what were the names? | "bust a move" part one, "bust a move" part two |
How to Use
Here is how to use this model in transformers:
from transformers import TapexTokenizer, BartForConditionalGeneration
import pandas as pd
tokenizer = TapexTokenizer.from_pretrained("microsoft/tapex-base-finetuned-wikisql")
model = BartForConditionalGeneration.from_pretrained("microsoft/tapex-base-finetuned-wikisql")
data = {
"year": [1896, 1900, 1904, 2004, 2008, 2012],
"city": ["athens", "paris", "st. louis", "athens", "beijing", "london"]
}
table = pd.DataFrame.from_dict(data)
# tapex accepts uncased input since it is pre-trained on the uncased corpus
query = "In which year did beijing host the Olympic Games?"
encoding = tokenizer(table=table, query=query, return_tensors="pt")
outputs = model.generate(**encoding)
print(tokenizer.batch_decode(outputs, skip_special_tokens=True))
# [' 2008.0']
How to Eval
Please find the eval script here.
BibTeX entry and citation info
@inproceedings{
liu2022tapex,
title={{TAPEX}: Table Pre-training via Learning a Neural {SQL} Executor},
author={Qian Liu and Bei Chen and Jiaqi Guo and Morteza Ziyadi and Zeqi Lin and Weizhu Chen and Jian-Guang Lou},
booktitle={International Conference on Learning Representations},
year={2022},
url={https://openreview.net/forum?id=O50443AsCP}
}
Configuration
- Architecture
- BartForConditionalGeneration
- Context length (tokens)
- 1,024
- Layers
- 6
- Vocabulary size
- 50,265
- Stored precision
- float32
- Model type
- bart
Identity and Version
- Repository
- microsoft/tapex-base-finetuned-wikisql
- Publisher
- Microsoft
- Task
- Table question answering
- Modality
- Other
- Library
- transformers
- Parameters
- Not stated by the source
- Languages
- en
- Revision
- 1e7e530d8732564c28b4453cd9d21dbf02a6c5dd
- First published
- 2022-03-02
- Last updated
- 2023-01-24
Files and Weights
12 files, 559.3 MB in total. The weights are 1 file totalling 558.0 MB in bin.
Every file
| File | Type | Size | SHA-256 |
|---|---|---|---|
| pytorch_model.bin | Weights | 558.0 MB | 97ec7e91b0b3 |
| config.json | Configuration | 1.7 KB | — |
| generation_config.json | Configuration | 236 B | — |
| generation_config_for_summarization.json | Configuration | 255 B | — |
| generation_config_for_summarization_cnn.json | Configuration | 280 B | — |
| generation_config_for_summarization_xsum.json | Configuration | 254 B | — |
| special_tokens_map.json | Configuration | 772 B | — |
| README.md | Documentation | 3.1 KB | — |
| .gitattributes | Repository | 1.2 KB | — |
| merges.txt | Tokenizer | 456.3 KB | — |
| tokenizer_config.json | Tokenizer | 1.2 KB | — |
| vocab.json | Tokenizer | 898.8 KB | — |
License and Download
- License
- mit
- Access
- Open weights, no gate
- Download size
- 558.0 MB
Released by Microsoft through its official repository on Hugging Face. Read the license.
Built From
- Described by arXiv:2107.07653
- Trained on (disclosed) wikisql
Memory Requirements
| Precision | Weights in memory |
|---|---|
| As published | 558.0 MB |
Weights only, from the published parameter count; the key-value cache and runtime add to this.
Questions About tapex-base-finetuned-wikisql
Can I use tapex-base-finetuned-wikisql commercially?
Yes. tapex-base-finetuned-wikisql is released under MIT License. The MIT License is a short permissive license. It permits commercial use, modification and redistribution, provided the copyright notice and permission notice are included.
What is tapex-base-finetuned-wikisql's context length?
1,024 tokens, from the maximum position embeddings in its published configuration.