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 and configure a T62_gx1v6, C-compset case on your target machine, using the cesm1.0 release code: cd $CCSMROOT/scripts ./create_newcase -compset C -res T62_gx1v6 -mach $mach -case $CASEROOT/$CASE1 cd $CASEROOT/$CASE1 ./configure -case 2) Enable double-precision time-averaged history-file output files ("tavg history files") by activating the TAVG_R8 cpp option in the $CASEROOT/$CASE1/Buildconf/pop2.buildexe.csh file: o gmake .... USER_CPPDEFS="-DTAVG_R8 -DCCSMCOUPLED ...." ^^^^^^^^^ 3) Modify the tavg_contents file: cp $CCSMROOT/models/ocn/pop2/input_templates/gx1v6_tavg_contents $CASEROOT/$CASE1/SourceMods/src.pop2/ edit line 26 of the file $CASEROOT/$CASE1/SourceMods/src.pop2/gx1v6_tavg_contents, changing the number 1 to 2 as shown here: * "2 SSH" ^ 4) Modify the following namelists in $CASEROOT/$CASE1/Buildconf/pop2.buildnml.csh, setting the variables to the values shown (underlined) below. Together with the previous modifications, these mods will generate double-precision netCDF tavg history files of SSH at every model timestep, bundled into one timeseries file: o tavg_nml: tavg_freq_opt = 'nmonth' 'nstep' 'once' ^^^^^ tavg_file_freq_opt = 'nmonth' 'nday' 'once' ^^^^ tavg_file_freq = 1 4 1 ^ tavg_stream_filestrings = 'nmonth1' 'nstep1' 'once' ^^^^^^ 5) Build the $CASEROOT/$CASE1: ./$CASEROOT/$CASE1/*.build 6) Run the case for five days (the default setting) When the case has completed successfully, the double-precision netCDF tavg history file containing the timeseries of SSH will be found in $RUNDIR/$CASE1.pop.h.nstep1.0001-01-02-03600.nc 7) 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 this first case, using the create_clone command from the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE2 2) Configure $CASEROOT/$CASE2 with a different pe layout for the ocean model only, by editing the env_mach_pes.xml file and changing the NTASKS_OCN value from its original to some other supported value, such as 16, 40, 48, 64, etc. In the NCAR example, we changed NTASKS_OCN from 120 to 48: cd $CASEROOT/$CASE2 edit line 73 of $CASEROOT/$CASE2/env_mach_pes.xml * ^^ ./configure -case 3) Build the $CASEROOT/$CASE2 ./$CASEROOT/$CASE2/*.build 4) Run the case for five days (the default setting). SSH timeseries will appear in $RUNDIR/$CASE2.pop.h.nstep1.0001-01-02-03600.nc, where $RUNDIR is the run directory for $CASE2 5) 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 new clone of the first case, using the create_clone command from the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE3 2) Configure: cd $CASEROOT/$CASE3 ./configure -case 3) Decrease the barotropic solver convergence criterion by one order of magnitude: o edit the $CASEROOT/$CASE3/Buildconf/pop2.buildnml.csh script, setting * convergenceCriterion = 1.0e-14 4) Build the $CASEROOT/$CASE3 ./$CASEROOT/$CASE3/*.build 5) Run the case for five days (the default setting). SSH timeseries will appear in $RUNDIR/$CASE3.pop.h.nstep1.0001-01-02-03600.nc, where $RUNDIR is the run directory for $CASE3 6) 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 new clone of the first case, using the create_clone command from the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE1 -case $CASEROOT/$CASE4 2) Congigure: cd $CASEROOT/$CASE4 ./configure -case 3) Set the barotropic solver convergence criterion to zero and iterate 500 times per timestep: o edit the $CASEROOT/$CASE4/Buildconf/pop2.buildnml.csh script, setting convergenceCriterion = 0 maxIterations = 500 4) Build the $CASEROOT/$CASE4 ./$CASEROOT/$CASE4/*.build 5) Run the case for five days (the default setting). SSH timeseries will appear in $RUNDIR/$CASE4.pop.h.nstep1.0001-01-02-03600.nc, where $RUNDIR is the run directory for $CASE4 6) 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 new clone of the SECOND case, using the create_clone command from the $CCSMROOT/scripts directory: cd $CCSMROOT/scripts ./create_clone -clone $CASEROOT/$CASE2 -case $CASEROOT/$CASE5 2) Congigure: cd $CASEROOT/$CASE5 ./configure -case 3) Set the barotropic solver convergence criterion to zero and iterate 500 times per timestep: o edit the $CASEROOT/$CASE5/Buildconf/pop2.buildnml.csh script, setting convergenceCriterion = 0 maxIterations = 500 4) Build the $CASEROOT/$CASE5 ./$CASEROOT/$CASE5/*.build 5) Run the case for five days (the default setting). SSH timeseries will appear in $RUNDIR/$CASE5.pop.h.nstep1.0001-01-02-03600.nc, where $RUNDIR is the run directory for $CASE5 6) 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.