Five Recommended Port-Validation Cases ====================================== The following directions assume that the user is familiar with the CESM User's Guide protocols and terminology. For information on how to create, configure, build, and run the following cases, please refer to the CESM User's Guide. ================================================================================ CASE1: Baseline Case (every-timestep, early SSH fields). Compare your CASE1 solutions with those generated on a trusted machine, such as bluefire. ================================================================================ 1) Create a T62_gx1v6, C-compset case on your target machine, using the cesm1.1 release code: a) cd $CCSMROOT/scripts b) ./create_newcase -compset C -res T62_g16 -mach $mach \ -case $CASEROOT/$CASE1 c) cd $CASEROOT/$CASE1 d) ./cesm_setup 2) Enable double-precision time-averaged history-file output files ("tavg history files"). To do this, edit line 133 in the $CASEROOT/$CASE1/Buildconf/pop2.buildexe.csh file. Replace set pop2defs = "`cat $OBJROOT/ocn/obj/POP2_cppdefs`" with set pop2defs = "`cat $OBJROOT/ocn/obj/POP2_cppdefs` -DTAVG_R8" ^^^^^^^^^^ Note that you are just adding " -DTAVG_R8" between the single quote and the double quote, the '^' characters are used to highlight the change. 3) Modify the tavg_contents file and the base.tavg.csh file to output the SSH variable every timestep: a) cp $CCSMROOT/models/ocn/pop2/input_templates/gx1v6_tavg_contents \ $CASEROOT/$CASE1/SourceMods/src.pop2/ b) Move the variable SSH from stream 1 to stream 2 by editing line 26 of the file $CASEROOT/$CASE1/SourceMods/src.pop2/gx1v6_tavg_contents, replacing 1 SSH with 2 SSH ^^^ c) cp $CCSMROOT/models/ocn/pop2/input_templates/ocn.base.tavg.csh \ $CASEROOT/$CASE1/SourceMods/src.pop2/ d) Set the output frequency of stream 2 to every timestep rather than daily by editing lines 6, 8, 9, and 10. Replace tavg_freq_opt = 'nmonth' 'nday' 'once' tavg_freq = 1 1 1 tavg_stream_filestrings = 'nmonth1' 'nday1' 'once' tavg_file_freq_opt = 'nmonth' 'nmonth' 'once' tavg_file_freq = 1 1 1 with tavg_freq_opt = 'nmonth' 'nstep' 'once' ^^^^^^^ tavg_freq = 1 1 1 tavg_stream_filestrings = 'nmonth1' 'nstep1' 'once' ^^^^^^^^ tavg_file_freq_opt = 'nmonth' 'nday' 'once' ^^^^^^ tavg_file_freq = 1 4 1 ^^^ As with step 2, the '^' characters are meant to highlight where you need to edit the specified files, they do not need to be included in the file itself. 4) Build and run $CASE1: a) cd $CASEROOT/$CASE1 b) ./$CASE1.build c) ./$CASE1.submit When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $DOUT_S_ROOT/ocn/hist/$CASE1.pop.h.nstep1.0001-01-02-03600.nc 5) Evaluate as noted in the case title, using the ncl SSH RMS difference script. ================================================================================ CASE2: Sensitivity Test. Compare your CASE2 solutions with those generated on a trusted machine and also against your own CASE1 solutions. ================================================================================ 1) Create a clone of the first case, using the create_clone command in the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE2 2) Setup $CASEROOT/$CASE2 with a different pe layout for the ocean model only: edit $CASEROOT/$CASE2/env_mach_pes.xml file and change the NTASKS_OCN value from its original to some other supported value (such as 16, 40, 48). In the NCAR example, we changed NTASKS_OCN from 120 to 48. a) cd $CASEROOT/$CASE2 b) ./xmlquery NTASKS_OCN [Output should be something like "env_mach_pes.xml: NTASKS_OCN = 120"] c) ./xmlchange -file env_mach_pes.xml -id NTASKS_OCN -val $NEW_VAL [For example, using $NEW_VAL = 48] d) ./cesm_setup 3) Build and run $CASE2: a) cd $CASEROOT/$CASE2 b) ./$CASE2.build c) ./$CASE2.submit When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $DOUT_S_ROOT/ocn/hist/$CASE2.pop.h.nstep1.0001-01-02-03600.nc 4) Evaluate as noted in the case title, using the ncl SSH RMS difference script. ================================================================================ CASE3: Convergence-Criterion Test. Compare your CASE3 solutions with those generated on a trusted machine and also against your own CASE1 solutions. ================================================================================ 1) Create a clone of the first case, using the create_clone command in the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE3 2) Setup $CASEROOT/$CASE3 exactly like $CASE1: a) cd $CASEROOT/$CASE3 b) ./cesm_setup 3) Modify the pop2 namelist to decrease the barotropic solver convergence criterion by one order of magnitude: a) Add the following to $CASEROOT/$CASE3/user_nl_pop2 convergenceCriterion = 1.0e-14 b) cd $CASEROOT/$CASE3 c) ./preview_namelists -verbose 4) Build and run $CASE3: a) cd $CASEROOT/$CASE3 b) ./$CASE3.build c) ./$CASE3.submit When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $DOUT_S_ROOT/ocn/hist/$CASE3.pop.h.nstep1.0001-01-02-03600.nc 5) Evaluate as noted in the case title, using the ncl SSH RMS difference script. ================================================================================ CASE4: Fixed-Iteration Test. Compare your CASE4 solutions with those generated on a trusted machine. ================================================================================ 1) Create a clone of the first case, using the create_clone command in the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE4 2) Setup $CASEROOT/$CASE4 exactly like $CASE1: a) cd $CASEROOT/$CASE4 b) ./cesm_setup 3) Modify the pop2 namelist to set the barotropic solver convergence criterion to zero and iterate 500 times per timestep: a) Add the following to $CASEROOT/$CASE4/user_nl_pop2 convergenceCriterion = 0 maxIterations = 500 b) cd $CASEROOT/$CASE4 c) ./preview_namelists -verbose 4) Build and run $CASE4: a) cd $CASEROOT/$CASE4 b) ./$CASE4.build c) ./$CASE4.submit When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $DOUT_S_ROOT/ocn/hist/$CASE4.pop.h.nstep1.0001-01-02-03600.nc 5) Evaluate as noted in the case title, using the ncl SSH RMS difference script. ================================================================================ CASE5: Fixed-Iteration/Sensitivity Test. Compare your CASE5 solutions with those generated on a trusted machine and also with your own CASE4 solutions. ================================================================================ 1) Create a clone of the SECOND case, using the create_clone command in the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE2 -case $CASEROOT/$CASE5 2) Setup $CASEROOT/$CASE5 exactly like $CASE2: a) cd $CASEROOT/$CASE5 b) ./cesm_setup 3) Modify the pop2 namelist to set the barotropic solver convergence criterion to zero and iterate 500 times per timestep: a) Add the following to $CASEROOT/$CASE5/user_nl_pop2 convergenceCriterion = 0 maxIterations = 500 b) cd $CASEROOT/$CASE5 c) ./preview_namelists -verbose 4) Build and run $CASE5: a) cd $CASEROOT/$CASE5 b) ./$CASE5.build c) ./$CASE5.submit When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $DOUT_S_ROOT/ocn/hist/$CASE5.pop.h.nstep1.0001-01-02-03600.nc 5) Evaluate as noted in the case title, using the ncl SSH RMS difference script. ================================================================================ Evaluation Notes: ================= Compare your solutions to the NCAR bluefire solutions provided on the diagnostics webpage. * Edit the ncl RMS to supply the case-specific information. * ncl ncl_rmsdiff.ncl * Compare your plots against those generated with data from bluefire and jaguar runs, which are available from the website hosting this page.