Counting 2,987 Big Data & Machine Learning Frameworks, Toolsets, and Examples...
Suggestion? Feedback? Tweet @stkim1

Guided Attention for FCN


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



  • We take the fully trained FCN8 network and add a average pooling and fully connected layers after its convolutional layers. We freeze the convolutional layers and train the fully connected networks to classify for the objects. We do this in order to get GradCAMs for a particular class to be later used during GAIN


  • Next we train the network as per the GAIN update rule. However in this implementation I have also considered the segmentation loss along with the GAIN updates/loss. This is because, I found using only the GAIN updates though did lead to convergence of losses, but also resulted in quite a significant dip in segmentation accuracies. In this step, the fully connected ayers are freezed and are not updated.

Loss Curves

For classification training


Segmentation Loss during GAIN updates


Qualitative Results

| Original Image | PreTrained GCAMs | Post GAIN GCAMs |





Quantitative Results

For FCN8s

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

How to use

pip install chainer
pip install chainercv
pip install cupy
pip install fcn


For training the classifier, download. the pretrained FCN8s chainer model --modelfile <path to the downloaded pre trained model>

For GAIN updates, --mmodelfile <path to the trained model with trained classifier>

The accuracy of original implementation is computed with ( <path to the trained fcn8 model>) which has been borrowed from wkentaro's implementation

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.

To Do

[x] Finetune hyperparameters

[x] Push Visualization Code


The original FCN module and the fcn package is courtesy of wkentaro


If you find this code useful in your research, please consider citing:

Author = {Alok kumar Bishoyi},
Title = {Guided Attention Inference Network},
Year = {2018},
Publisher = {GitHub},
journal = {Github repository},
howpublished = {\url{}},