.. vim: set fileencoding=utf-8 :
.. Tiago de Freitas Pereira <tiago.pereira@idiap.ch>

========================================================
 From Face Recognition to Heterogeneous Face Recognition
========================================================

This section contains instructions on how to reproduce the experiments from Chapter 3 **From Face Recognition to Heterogeneous Face Recognition**.


CUHK-CUFS Experiments
=====================

The sequence of experiments in this subsection generates the necessary data to generate **THE FIRST LINE** of Table 1.

First, the experiments should be generated::

  $ bob bio htface htface_baseline htface_lightcnn cuhk-cufs -vv
  $ bob bio htface htface_baseline htface_vgg16 cuhk-cufs -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_gray cuhk-cufs -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_rgb cuhk-cufs -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_gray cuhk-cufs -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_rgb cuhk-cufs -vv
  

.. Note::
  If you are at IDIAP, it is possible to trigger these experiements by setting `--grid grid` option.  For more info check::
  
  $ bob bio htface htface_baseline --help


Once the experiments are executed, the plots and metrics can be generated with the following command::

 $ bob bio htface evaluate_and_squash \
  \
   <experiment_path>/cuhk-cufs/htface_lightcnn/ \
   <experiment_path>/cuhk-cufs/htface_vgg16/ \
   <experiment_path>/cuhk-cufs/htface_idiap_msceleb_inception_v1_centerloss_gray/ \
   <experiment_path>/cuhk-cufs/htface_idiap_msceleb_inception_v1_centerloss_rgb/ \
   <experiment_path>/cuhk-cufs/htface_idiap_msceleb_inception_v2_centerloss_gray/ \
   <experiment_path>/cuhk-cufs/htface_idiap_msceleb_inception_v2_centerloss_rgb/ \
   \
   --legends "Light CNN" --legends "VGG 16" \
   --legends "Incep.Resnet v1 gray" --legends "Incep.Resnet v1 RGB" \
   --legends "Incep.Resnet v2 gray" --legends "Incep.Resnet v2 RGB" \
   --report-name "cufs.pdf" \
   --x-min 20 \

.. Note::
  It's not necessary to run everything at once. Generate partial plots is a possibility. For more info check::
  
  $ bob bio htface evaluate_and_squash --help



CASIA Experiments
=================

The sequence of experiments in this subsection generates the necessary data to generate **THE SECOND LINE** of Table 1.

First, the experiments should be generated::

  $ bob bio htface htface_baseline htface_lightcnn casia-nir-vis-2 -vv
  $ bob bio htface htface_baseline htface_vgg16 casia-nir-vis-2 -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_gray casia-nir-vis-2 -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_rgb casia-nir-vis-2 -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_gray casia-nir-vis-2 -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_rgb casia-nir-vis-2 -vv
  

.. Note::
  If you are at IDIAP, it is possible to trigger these experiements by setting `--grid grid` option.  For more info check::
  
  $ bob bio htface htface_baseline --help


Once the experiments are executed, the plots and metrics can be generated with the following command::

 $ bob bio htface evaluate_and_squash \
  \
   <experiment_path>/casia-nir-vis-2/htface_lightcnn/ \
   <experiment_path>/casia-nir-vis-2/htface_vgg16/ \
   <experiment_path>/casia-nir-vis-2/htface_idiap_msceleb_inception_v1_centerloss_gray/ \
   <experiment_path>/casia-nir-vis-2/htface_idiap_msceleb_inception_v1_centerloss_rgb/ \
   <experiment_path>/casia-nir-vis-2/htface_idiap_msceleb_inception_v2_centerloss_gray/ \
   <experiment_path>/casia-nir-vis-2/htface_idiap_msceleb_inception_v2_centerloss_rgb/ \
   \
   --legends "Light CNN" --legends "VGG 16" \
   --legends "Incep.Resnet v1 gray" --legends "Incep.Resnet v1 RGB" \
   --legends "Incep.Resnet v2 gray" --legends "Incep.Resnet v2 RGB" \
   --report-name "casia-nir-vis-2.pdf" \
   --x-min 20 \

.. Note::
  It's not necessary to run everything at once. Generate partial plots is a possibility. For more info check::
  
  $ bob bio htface evaluate_and_squash --help



NIVL Experiments
================

The sequence of experiments in this subsection generates the necessary data to generate **THE THIRD LINE** of Table 1.

First, the experiments should be generated::

  $ bob bio htface htface_baseline htface_lightcnn nivl -vv
  $ bob bio htface htface_baseline htface_vgg16 nivl -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_gray nivl -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_rgb nivl -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_gray nivl -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_rgb nivl -vv

.. Note::
  If you are at IDIAP, it is possible to trigger these experiements by setting `--grid grid` option.  For more info check::
  
  $ bob bio htface htface_baseline --help


Once the experiments are executed, the plots and metrics can be generated with the following command::

 $ bob bio htface evaluate_and_squash \
  \
   <experiment_path>/nivl/htface_lightcnn/ \
   <experiment_path>/nivl/htface_vgg16/ \
   <experiment_path>/nivl/htface_idiap_msceleb_inception_v1_centerloss_gray/ \
   <experiment_path>/nivl/htface_idiap_msceleb_inception_v1_centerloss_rgb/ \
   <experiment_path>/nivl/htface_idiap_msceleb_inception_v2_centerloss_gray/ \
   <experiment_path>/nivl/htface_idiap_msceleb_inception_v2_centerloss_rgb/ \
   \
   --legends "Light CNN" --legends "VGG 16" \
   --legends "Incep.Resnet v1 gray" --legends "Incep.Resnet v1 RGB" \
   --legends "Incep.Resnet v2 gray" --legends "Incep.Resnet v2 RGB" \
   --report-name "casia-nir-vis-2.pdf" \
   --x-min 20 \

.. Note::
  It's not necessary to run everything at once. Generate partial plots is a possibility. For more info check::
  
  $ bob bio htface evaluate_and_squash --help



Thermal Experiments
===================

The sequence of experiments in this subsection generates the necessary data to generate **THE FORTH LINE** of Table 1.

First, the experiments should be generated::

  $ bob bio htface htface_baseline htface_lightcnn thermal -vv
  $ bob bio htface htface_baseline htface_vgg16 thermal -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_gray thermal -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v1_centerloss_rgb thermal -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_gray thermal -vv
  $ bob bio htface htface_baseline htface_idiap_msceleb_inception_v2_centerloss_rgb thermal -vv
  

.. Note::
  If you are at IDIAP, it is possible to trigger these experiements by setting `--grid grid` option.  For more info check::
  
  $ bob bio htface htface_baseline --help


Once the experiments are executed, the plots and metrics can be generated with the following command::

 $ bob bio htface evaluate_and_squash \
  \
   <experiment_path>/thermal/htface_lightcnn/ \
   <experiment_path>/thermal/htface_vgg16/ \
   <experiment_path>/thermal/htface_idiap_msceleb_inception_v1_centerloss_gray/ \
   <experiment_path>/thermal/htface_idiap_msceleb_inception_v1_centerloss_rgb/ \
   <experiment_path>/thermal/htface_idiap_msceleb_inception_v2_centerloss_gray/ \
   <experiment_path>/thermal/htface_idiap_msceleb_inception_v2_centerloss_rgb/ \
   \
   --legends "Light CNN" --legends "VGG 16" \
   --legends "Incep.Resnet v1 gray" --legends "Incep.Resnet v1 RGB" \
   --legends "Incep.Resnet v2 gray" --legends "Incep.Resnet v2 RGB" \
   --report-name "thermal.pdf" \
   --x-min 20 \

.. Note::
  It's not necessary to run everything at once. Generate partial plots is a possibility. For more info check::
  
  $ bob bio htface evaluate_and_squash --help