C $Header: /home/ubuntu/mnt/e9_copy/MITgcm_contrib/verification_other/atm_gray/README,v 1.4 2015/12/13 23:30:07 jmc Exp $
C $Name: checkpoint66e $

MITgcm_contrib/verification_other/atm_gray/

Provide source code and input files for 3 simple sep-up,
 using gray atmospheric physics (O'Gorman and Schneider, JCl, 2008)
plugged in MITgcm dynamical core (see package "atm_phys").

Notes: Initially (before addition of pkg/atm_phys on 2013/05/08) was using
 modified (and original) "mypackage" src code and atmospheric gray physics
 code in dir atm_gray/code_gray ; this has now been replaced by pkg/atm_phys.

1) standard cubed-sphere set-up (6 faces 32x32, 26 levels, non uniform deltaP)
   atm_gray/code/   : specific code
 primary set-up:
      uses 10m mixed layer depth with evolving SST (including a Q-flux)
      + damping of stratospheric winds ; starts @ t= 1.yr from pickup files.
   atm_gray/input/  : input files (+ uses script "prepare_run" in input)
   atm_gray/results/output.txt : standard output of a short reference run
 secondary set-up (using same executable):
      uses fixed SST (APE) and improved radiation code from Ruth Geen.
   atm_gray/inputu.ape/  : specific input files (remaining files from dir input)
   atm_gray/results/output.ape.txt : secondary output of a short reference run

2) simplified cubed-sphere set-up (6 faces 32x32, 25 levels, deltaP = 40.mb)
   with fixed (prescribed) SST.
   atm_gray/code_cs/ : specific code
   atm_gray/inp_cs/  : input files (+ uses script "prepare_run" in inp_cs)
   atm_gray/results/output.cs.txt : standard output of a short reference run

3) lat-lon grid set-up (128x64 horiz grid, 25 levels
                     <-> 2.8 x 2.8 degree, deltaP = 40.mb)
   atm_gray/code_ll/ : specific code
   atm_gray/inp_ll/  : input files
   atm_gray/results/output.ll.txt : standard output of a short reference run

--------------
Instructions:
--------------
Download MITgcm (including verification experiments) from MITgcm repository
 <my_dir_space> cvs co -P -d MITgcm_current MITgcm
and download "atm_gray" set-up from MITgcm_contrib repository,
   a) either directly in dir verification
     <my_dir_space> cd MITgcm_current/verification
     <verification> cvs co -P -d atm_gray MITgcm_contrib/verification_other/atm_gray
or b) in a similar level in the directory tree, e.g., in verification_other in MITgcm_current:
     <my_dir_space> cd MITgcm_current
     <MITgcm_current> mkdir verification_other ; cd verification_other
     <verification_other> cvs co -P -d atm_gray MITgcm_contrib/verification_other/atm_gray

to built and run the 1rst (standard) CS-32 set-up:
> cd atm_gray/build
> (if done after a previous built, do "make Clean" first)
> ../../../tools/genmake2 -mods ../code -of ../../../tools/build_options/[Selected-Option-File]
> make depend
> make
> cd ../run
> (if done after a previous run, clean-up all files: /bin/rm -f * )
> ln -s ../input/* .
> ../input/prepare_run
> ln -s ../build/mitgcmuv .
> mitgcmuv >& output.txt
and output.txt can be compared with atm_gray/results/output.txt

to built and run the 2nd (simplified) CS-32 set-up:
> cd atm_gray/build
> (if done after a previous built, do "make Clean" first)
> ../../../tools/genmake2 -mods ../code_cs -of ../../../tools/build_options/[Selected-Option-File]
> make depend
> make
> cd ../run
> (if done after a previous run, clean-up all files: /bin/rm -f * )
> ln -s ../inp_cs/* .
> ../inp_cs/prepare_run
> ln -s ../build/mitgcmuv .
> mitgcmuv >& output.txt
and output.txt can be compared with atm_gray/results/output.cs.txt

to built and run the 3rd, Lat-Lon set-up:
> cd atm_gray/build
> (if done after a previous built, do "make Clean" first)
> ../../../tools/genmake2 -mods ../code_ll -of ../../../tools/build_options/[Selected-Option-File]
> make depend
> make
> cd ../run
> (if done after a previous run, clean-up all files: /bin/rm -f * )
> ln -s ../inp_ll/* .
> ln -s ../build/mitgcmuv .
> mitgcmuv >& output.txt
and output.txt can be compared with atm_gray/results/output.ll.txt

--------------