---- common to all matlab sessions ----

0) login as guest

1) open web browser, and download setup_gcmfaces_and_mitprof.csh
   from http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/

note :
   for step 1, please be sure to use the download button
   of the browser rather than e.g. wget that can conflict 
   with the behavior of the CVS web interface

2) open terminal window, and proceed to download codes:
   csh
   mkdir iap-idma
   mv Downloads/setup_gcmfaces_and_mitprof.csh iap-idma/
   cd iap-idma
   source ./setup_gcmfaces_and_mitprof.csh

notes : 
   disk space requirement ~ 800M (plus class specific items)
   matlab requirement > 2011 (for native netcdf implementation)

---- for class #1 ----

1,2) see 'common to all classes' above

3) download idma_float_plot.m from http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/comm/course-idma2015/computing/

4) in terminal window 
   mv ~/Downloads/idma_float_plot.m ~/iap-idma/.

5) download Argo etc
   cd ~/iap-idma
   mkdir release1
   wget --recursive ftp://mit.ecco-group.org/gforget/MITprof
   mv mit.ecco-group.org/gforget/MITprof release1/.

6) start matlab and run idma_float_plot.m
   matlab
   [p]=idma_float_plot('2900828');

notes :
   disk space requirement ~ 6.4G (plus 0.8G from steps 1,2)
   start matlab at command line : matlab -nodesktop

---- for class #2 ----

1,2) see 'common to all classes' above

3) start matlab and run gcmfaces_demo
   cd ~/iap-idma
   matlab
   addpath gcmfaces
   gcmfaces_demo
   exit
   
4) download ECCO climatology
   cd ~/iap-idma
   mkdir release1

   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/THETA
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/SALT
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/UVELMASS
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/VVELMASS
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/'ADVx_*'
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/'ADVy_*'
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/'DFxE_*'
   wget --recursive ftp://mit.ecco-group.org/gforget/nctiles_climatology/'DFyE_*'
   mv mit.ecco-group.org/gforget/nctiles_climatology release1/.

5) start matlab and run example_transports (or re-run gcmfaces_demo).
   cd ~/iap-idma
   matlab
   addpath gcmfaces
   gcmfaces_global
   diags=example_transports('v4');
   example_transports_disp(diags);

---- for class #4 ----

1) open web browser, and download setup_these_exps.csh
   from http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/verification/

note :
   for step 1, please be sure to use the download button
   of the browser rather than e.g. wget that can conflict
   with the behavior of the CVS web interface

2) open terminal window, install MITgcm:

   mkdir iap-idma
   cd iap-idma
   csh
   setenv CVSROOT ':pserver:cvsanon@mitgcm.org:/u/gcmpack'
   cvs login
        ( enter the CVS password: "cvsanon" )
   cvs co -P MITgcm_verif_basic

3) install the ECCO v4 setups

   cd ~/iap-idma/MITgcm/verification
   mv ~/Downloads/setup_these_exps.csh .
   source ./setup_these_exps.csh
   mv global_oce_tmp_download/global_oce_* .
   rm -rf global_oce_tmp_download

4) run the ECCO v4 mini benchmark

   ./testreport -t global_oce_cs32

note :
   building the MITgcm (whether using genmake2 or via testreport) requires that your machine
   has : make or (preferably) GNU make, FORTRAN compiler, C compiler, [ba]sh and [t]csh shells

5) quick output plot

   cd ~/iap-idma
   matlab -nodesktop
   addpath gcmfaces
   gcmfaces_global

   cd ~/iap-idma/MITgcm/verification/global_oce_cs32/run
   grid_load('./',6,'compact');
   THETA=rdmds2gcmfaces('T.0000000008');
   figureL; qwckplot(THETA(:,:,1)); colorbar;

note :
   the matlab software needed for item #5 is assumed to have been 
   installed according to 'common to all matlab sessions'

---- for class #5 ----

1,2) same as class #4 except with
   cvs co -P MITgcm
     instead of
   cvs co -P MITgcm_verif_basic

3) run MITgcm benchmarks

   ./testreport -t 'adjustment.128x64x1 advect_cs advect_xy'
   ./testreport -t 'adjustment.cs-32x32x1 tutorial_held_suarez_cs tutorial_plume_on_slope'

note : 
   building the MITgcm (whether using genmake2 or via testreport) requires that your machine 
   has : make or (preferably) GNU make, FORTRAN compiler, C compiler, [ba]sh and [t]csh shells

4) quick output plot for adjustment.128x64x1

   cd ~/iap-idma
   matlab -nodesktop
   addpath gcmfaces
   gcmfaces_global

   cd ~/iap-idma/MITgcm/verification/adjustment.128x64x1/run
   mitgcm_plot_adju_128;

   note : to download mitgcm_plot_adju_128.m etc. go to
   http://mitgcm.org/viewvc/MITgcm/MITgcm_contrib/gael/comm/course-idma2015/computing/

5) repeat step #4 for different experiments:

   adjustment.128x64x1		mitgcm_plot_adju_128.m
   advect_cs			mitgcm_plot_adv_cs.m
   advect_xy			mitgcm_plot_adv_xy.m
*  adjustment.cs-32x32x1	mitgcm_plot_adju_cs32.m
*  tutorial_held_suarez_cs	mitgcm_plot_held_suarez.m
*  tutorial_plume_on_slope	mitgcm_plot_plume.m

note :
   * in the cases of adjustment.cs-32x32x1, tutorial_held_suarez_cs,
   and tutorial_plume_on_slope the matlab programs expect that
   the experiment duration was increased (see iap-idma-exercises)