Training for Diversity in Image Paragraph Captioning

This repository includes a PyTorch implementation of [Training for Diversity in Image Paragraph Captioning](). Our code is based on Ruotian Luo's implementation of Self-critical Sequence Training for Image Captioning, available here..

Requirements

• Python 2.7 (because coco-caption does not support Python 3)
• PyTorch 0.4 (with torchvision)
• cider (already included as a submodule)
• coco-caption (already included as a submodule)

If training from scratch, you also need:

• spacy (to tokenize words)
• h5py (to store features)
• scikit-image (to process images)

To clone this repository with submodules, use:

• git clone --recurse-submodules https://github.com/lukemelas/image-paragraph-captioning

Train your own network

Download and preprocess cations

• Download captions:
  • Run download.sh in data/captions
• Preprocess captions for training (part 1):
  • Download spacy English tokenizer with python -m spacy download en
  • First, convert the text into tokens: cd scripts && python prepro_text.py
  • Next, preprocess the tokens into a vocabulary (and map infrequent words to an UNK token) with the following command. Note that image/vocab information is stored in data/paratalk.json and caption data is stored in data/paratalk\_label.h5

    python scripts/prepro_labels.py --input_json data/captions/para_karpathy_format.json --output_json data/paratalk.json --output_h5 data/paratalk

• Preprocess captions into a coco-captions format for calculating CIDER/BLEU/etc:
  • Run scripts/prepro\_captions.py
  • There should be 14,575/2487/2489 images and annotations in the train/val/test splits
  • Uncomment line 44 ((Spice(), "SPICE")) in coco-caption/pycocoevalcap/eval.py to disable Spice testing
• Preprocess ngrams for self-critical training:

  python scripts/prepro_ngrams.py --input_json data/captions/para_karpathy_format.json --dict_json data/paratalk.json --output_pkl data/para_train --split train

• Extract image features using an object detector
  • We make pre-processed features widely available:
  • Download and extract parabu_fc and parabu_att from here into data/bu_data
  • Or generate the features yourself:
  • Download the Visual Genome Dataset
  • Apply the bottom-up attention object detector here made by Peter Anderson.
  • Use scripts/make_bu_data.py to convert the image features to .npz files for faster data loading

Train the network

As explained in Self-Critical Sequence Training, training occurs in two steps:

1. The model is trained with a cross-entropy loss (~30 epochs)
2. The model is trained with a self-critical loss (30+ epochs)

Training hyperparameters may be accessed with python train.py --help.

A reasonable set of hyperparameters is provided in train_xe.sh (for cross-entropy) and train_sc.sh (for self-critical).

mkdir log_xe
./train_xe.sh 

You can then copy the model:

./scripts/copy_model.sh xe sc

And train with self-critical:

mkdir log_sc
./train_xe.sh 

Pretrained Network

You can download a pretrained captioning model here.

Citation

In case you would like to cite our paper/code (no obligation at all):

@article{melaskyriazi2018paragraph, 
  title={Training for diversity in image paragraph captioning},
  author={Melas-Kyriazi, Luke and Rush, Alexander and Han, George},
  journal={EMNLP},
  year={2018}
}     

And Ruotian Luo's code, on which this repo is built:

@article{luo2018discriminability,
  title={Discriminability objective for training descriptive captions},
  author={Luo, Ruotian and Price, Brian and Cohen, Scott and Shakhnarovich, Gregory},
  journal={CVPR},
  year={2018}
}