Files
Michael Tu 82bf90f4bb Tune Kim CNN for SST-2 and Improve SST-1 Results with Dataset/Initialization Changes (#133)
* SST change min_freq and Kim CNN init distribution

* Add tuned results for SST-1 and SST-2

* Fix typo
2018-07-11 22:08:26 -04:00

131 lines
4.0 KiB
Markdown

# kim_cnn
Implementation for Convolutional Neural Networks for Sentence Classification of [Kim (2014)](https://arxiv.org/abs/1408.5882) with PyTorch and Torchtext.
## Model Type
- rand: All words are randomly initialized and then modified during training.
- static: A model with pre-trained vectors from [word2vec](https://code.google.com/archive/p/word2vec/). All words -- including the unknown ones that are initialized with zero -- are kept static and only the other parameters of the model are learned.
- non-static: Same as above but the pretrained vectors are fine-tuned for each task.
- multichannel: A model with two sets of word vectors. Each set of vectors is treated as a 'channel' and each filter is applied to both channels, but gradients are back-propagated only through one of the channels. Hence the model is able to fine-tune one set of vectors while keeping the other static. Both channels are initialized with word2vec.# text-classification-cnn
Implementation for Convolutional Neural Networks for Sentence Classification of [Kim (2014)](https://arxiv.org/abs/1408.5882) with PyTorch.
## Quick Start
To run the model on SST-1 dataset on multichannel, just run the following from the Castor working directory.
```
python -m kim_cnn --mode multichannel
```
The file will be saved in
```
kim_cnn/saves/best_model.pt
```
To test the model, you can use the following command.
```
python -m kim_cnn --trained_model kim_cnn/saves/SST-1/multichannel_best_model.pt --mode multichannel
```
## Dataset
We experiment the model on the following datasets.
- SST-1: Keep the original splits and train with phrase level dataset and test on sentence level dataset.
- SST-2: Same as SST-1 but with neutral reviews removed and binary labels.
## Settings
Adadelta is used for training.
## Training Time
For training time, when
```
torch.backends.cudnn.deterministic = True
```
is specified, the training will be ~3h because deterministic cnn algorithm is used (accuracy v.s. speed).
Other option is that
```
torch.backends.cudnn.enabled = False
```
but this will take ~6-7x training time.
## SST-1 Dataset Results
**Random**
```
python -m kim_cnn --dataset SST-1 --mode rand --lr 0.5777 --weight_decay 0.0007 --dropout 0
```
**Static**
```
python -m kim_cnn --dataset SST-1 --mode static --lr 0.3213 --weight_decay 0.0002 --dropout 0.4
```
**Non-static**
```
python -m kim_cnn --dataset SST-1 --mode non-static --lr 0.388 --weight_decay 0.0004 --dropout 0.2
```
**Multichannel**
```
python -m kim_cnn --dataset SST-1 --mode multichannel --lr 0.3782 --weight_decay 0.0002 --dropout 0.4
```
Using deterministic algorithm for cuDNN.
| Test Accuracy on SST-1 | rand | static | non-static | multichannel |
|:------------------------------:|:----------:|:------------:|:--------------:|:---------------:|
| Paper | 45.0 | 45.5 | 48.0 | 47.4 |
| PyTorch using above configs | 44.3 | 47.9 | 48.6 | 49.2 |
## SST-2 Dataset Results
**Random**
```
python -m kim_cnn --dataset SST-2 --mode rand --lr 0.564 --weight_decay 0.0007 --dropout 0.5
```
**Static**
```
python -m kim_cnn --dataset SST-2 --mode static --lr 0.5589 --weight_decay 0.0004 --dropout 0.5
```
**Non-static**
```
python -m kim_cnn --dataset SST-2 --mode non-static --lr 0.5794 --weight_decay 0.0003 --dropout 0.3
```
**Multichannel**
```
python -m kim_cnn --dataset SST-2 --mode multichannel --lr 0.7373 --weight_decay 0.0001 --dropout 0.1
```
Using deterministic algorithm for cuDNN.
| Test Accuracy on SST-2 | rand | static | non-static | multichannel |
|:------------------------------:|:----------:|:------------:|:--------------:|:---------------:|
| Paper | 82.7 | 86.8 | 87.2 | 88.1 |
| PyTorch using above configs | 83.0 | 86.4 | 87.3 | 87.4 |
## TODO
- More experiments on subjectivity
- Parameters tuning