====== Installing CLIMAF with CDAT ======

The [[https://climaf.readthedocs.io/|CLIMAF]] installation is a special case, because we may want to use it with the Python installed for CDAT, but it is not installed using conda and should theoretically work with any available Python, as long as the directory where it is installed is correctly defined in the ''PYTHONPATH'' variable

We follow the steps for the [[https://climaf.readthedocs.io/en/latest/installing.html#installing-climaf-if-you-are-not-at-cnrm-on-ciclad-or-climserv|installation of a non-standard server]]

  * Go to the appropriate installation directory (we choose the directory where we have also installed miniconda3):
    * LSCE: ''cd /home/share/unix_files/cdat''
    * ciclad: ''/data/jypmce/cdat/''
  * ''git clone https://github.com/senesis/climaf climaf''
  * Add CLIMAF to the PYTHONPATH environment variable
    * LSCE & tcsh: ''setenv PYTHONPATH ${PYTHONPATH}:/home/share/unix_files/cdat/climaf''
    * LSCE & bash: ''export PYTHONPATH=${PYTHONPATH}:/home/share/unix_files/cdat/climaf''
    * ciclad: same as above, using ''/data/jypmce/cdat/climaf''
  * Test the installation
    * make sure the [[https://climaf.readthedocs.io/en/latest/requirements.html#requirements|Requirements]] are available:
      * LSCE: ''module load netcdf/4 nco cdo ncl ncview''
      * ciclad: ''module load netcdf4 nco cdo ncl/6.3.0''
      * optional: start an X server
      * <code>cd climaf/testing
./test_install.sh</code>
  * Once the tests are OK, add the required //module load// and environment variables definitions to the ''.basrc'' and ''.cshrc'' files
    * <wrap hi>Maybe these lines should go to the ''.profile'' and ''.login'' files...(check [[https://www.gnu.org/software/bash/manual/html_node/Bash-Startup-Files.html|Bash Startup Files]])</wrap>
    * <wrap hi>Loading some modules may have some side-effects on CDAT</wrap>. If that's the case, use ''module purge'' before initializing CDAT
    * LSCE: add to your ''~/.cshrc'' file (check //ciclad// below if you are a //bash// user)
      * <code># Prerequisites for using CLIMAF
module load netcdf/4 nco cdo ncl ncview

# CLIMAF environment variables
setenv CLIMAF /home/share/unix_files/cdat/climaf
setenv PYTHONPATH "${PYTHONPATH}:${CLIMAF}"
#setenv PYTHONPATH $CLIMAF
setenv PATH "${PATH}:${CLIMAF}/bin"
setenv CLIMAF_CACHE "/home/scratch01/${USER}/climaf_cache"
setenv TMPDIR $CLIMAF_CACHE
setenv CLIMAF_LOG_DIR $CLIMAF_CACHE

#conda activate cdatm_py2</code>
    * ciclad: add to your ''~/.bashrc'' file
      * <code># Prerequisites for using CLIMAF when not using the 
# default 'module load climaf'
module load netcdf4 nco cdo ncl/6.3.0

# CLIMAF environment variables
export CLIMAF=/data/jypmce/cdat/climaf
#export PYTHONPATH=$PYTHONPATH:$CLIMAF
export PYTHONPATH=$CLIMAF
export PATH=$PATH:$CLIMAF/bin
export CLIMAF_CACHE=/data/jypmce/climaf_cache
export TMPDIR=$CLIMAF_CACHE
export CLIMAF_LOG_DIR=$CLIMAF_CACHE

#conda activate cdatm_py2
</code>
  * Open a new shell and <wrap em>run the tests again</wrap>. If there is an error that was not there, check what you have added to the shell init files

We are now ready to [[other:uvcdat:cdat_conda:climaf_test|start using CLIMAF on ciclad]]!


/* standard page footer */

\\ \\ \\ 
----
[ [[pmip3:|PMIP3 Wiki Home]] ] -
[ [[pmip3:wiki_help|Help!]] ] -
[ [[wiki:syntax|Wiki syntax]] ]