Contains implementation of Guided Attention Inference Network (GAIN) presented in Tell Me Where to Look(CVPR 2018). This repository aims to apply GAIN on fcn8 architecture used for segmentation.
Chainer implementation of Tell Me Where To Look. This is an experiment to apply Guided Attention Inference Network(GAIN) as presented in the paper to Fully Convolutional Networks(FCN) used for segmentation purposes. The trained FCN8s model is fine tuned using guided attention.
GAIN is based on supervising the attention maps that is produced when we train the network for the task of interest.
Fully Convolutional Networks is a network architecture that consists of convolution layers followed by deconvolutions to give the segmentation output
| Original Image | PreTrained GCAMs | Post GAIN GCAMs |
Implementation | Accuracy | Accuracy Class | Mean IU | FWAVACC | Model File |
---|---|---|---|---|---|
Original | 91.2212 | 77.6146 | 65.5126 | 84.5445 | fcn8s_from_caffe.npz |
Experimental | 90.5962 | 80.4099 | 64.6869 | 83.9952 | To make public soon |
pip install chainer
pip install chainercv
pip install cupy
pip install fcn
For training the classifier, download. the pretrained FCN8s chainer model
python3 train_classifier.py --device 0
This will automatically download the pretrained file and train the classifier on it. You might run into an error of " xxx.txt file not found " while running this script. To solve this, at the place where your fcn
library is installed, get the missing file from the fcn repository over github, and take care to put the exisiting file by making the same directory structure as asked in the error message. For more details, refer to this issue
For GAIN updates,
python3 train_GAIN.py --modelfile <path to the trained model with trained classifier> --device 0
The accuracy of original implementation is computed with (evaluate.py <path to the trained fcn8 model>
) which has been borrowed from wkentaro's implementation
visualize.py
required arguements -
--pretrained <path to the model file with trained classifier but not trained through GAIN method>
--trained <path to the model trained with GAIN>
optional arguements -
--device=-1 <device to assign to model, default uses cpu>
--whole=False < whether to test on whole valid dataset>
--shuffle=False <shuffles fataset loader>
--no=10 <if whole is False, then no of images to visualize>
I have attempted to make GAIN as modular as possible so that it can be used on some other model as well. All you would need to do is make GAIN class( which itself inherits chainer.Chain) as parent class to your model.
Each GAIN model needs to have a few particular instance variables in order to be able to function. GAIN module has methods to instantiate every single one of them. I would advice you to lookup models/fcn8.py
as well as GAIN.py
to have an idea about them.
The original FCN module and the fcn package is courtesy of wkentaro
If you find this code useful in your research, please consider citing:
@misc{Alok2018,
Author = {Bishoyi, Alok Kumar},
Title = {Guided Attention Inference Network},
Year = {2018},
Publisher = {GitHub},
journal = {Github repository},
howpublished = {\url{https://github.com/alokwhitewolf/Guided-Attention-Inference-Network}},
}