Run Specifications

General Information

   Purpose of Run: member of 20th century ensemble from 1850 control
                   (from spinup transient period of high AMOC) 
                   (extra output fields from all components - MOAR)

   Scientific Lead: Jim Hurrell

   Software Engineering Lead: Mariana Vertenstein

   Assigned to: Andy Mai
   Date: 2010-03-15

   Run Length:  156 years
Case Creation Information (all fields are required)

   CCSM tag:   ccsm4_0_beta53

   Case Name:  b40.20th.track1.1deg.011

   Machine:    bluefire

   Compset:    B_1850-2000_CN
   Resolution: 0.9x1.25_gx1v6

Pre-Configuration Information

   Runtype: hybrid
   RUN_STARTDATE = 1850-01-01
   RUN_REFCASE   = b40.1850.track1.1deg.006
   RUN_REFDATE   = 0911-01-01

   env_mach_pes.xml mods
   component       comp_pes    root_pe   tasks  x threads (stride)
   ---------        ------     -------   ------   ------   ------
   cpl = cpl        320         0        320    x 1       (1     )
   glc = sglc       1           0        1      x 1       (1     )
   lnd = clm        128         320      128    x 1       (1     )
   ice = cice       320         0        320    x 1       (1     )
   atm = cam        448         0        448    x 1       (1     )
   ocn = pop2       64          448      64     x 1       (1     )

Post-Configuration Information


   * Dave Lawrence / Brian Kauffman (cpl): 
       Turn on 3 hour auxiiary history files fields needed to as input to datm to drive clm.

       In addition to a one-line mod to the coupler main program (ccsm_driver.F90, see below).
       we need to change the value of one nml variable in cpl.buildnml.csh 
       This variable turns on 3 hour auxiiary history files...

       histaux_a2x3hr  = .true.

   * CAM (eaton) 
     - Data for offline radiation calculations and for budget analysis
       **for entire run** 
       The following needs to be added to cam.buildnml.csh

         rad_data_output=.true. rad_data_histfile_num=1

     - Higher frequency data
      **Only from 1950 to end of run.**
       This includes:
       - CMIP5 fields
       - TEM diagnostics requested by Yaga
       - 6-hrly instantaneous data requested by Mike Wehner

       The following variables need to be added to the existing cam_inparm
       namelist group in cam.buildnml.csh:

          'U','UV2d','UW2d','U2d','V','VTH2d', 'V2d','W2d','Z3'

     - Detailed budget diagnostic data requested by AMP
       **Only from 1979 to end of run.**

       The following variables need to be added to the existing cam_inparm
       namelist group in cam.buildnml.csh:

        fincl6='CME', 'CMEICE', 'CMELIQ', 'CMFDICE', 'CMFDLIQ',
          'PTEQ', 'PTTEND',  'QRL', 'QRS', 'REPARTICE', 'REPARTLIQ',
          'VDCLDLIQ', 'ZMDICE', 'ZMDLF', 'ZMDLIQ', 'ZMDQ', 'ZMDT',
          'CLDICE:I', 'CLDLIQ:I','Q:I', 'T:I', 'CLDICEAP:I', 'CLDLIQAP:I','QAP:I', 'TAP:I'

     The total size of CAM's output history data for this run is about 10-TB.

   * Gary (clm)

     lnd daily fields    : SOILWATER_10CM[1] QRUNOFF[2] SNOWDP FSNO TSOI_10CM

     [1] - CLM says they can reduce SOILICE and SOILLIQ to the needed top
           0.1m integral, to avoid saving the full depth of these two.
     [2] - CLM says that they can save QRUNOFF (total runoff) instead of the three
           terms (QDRAI + QRGWL + QOVER) that are summed to create total runoff

   * Gary (cice)   

     ice daily fields[3] : aice hi uvel vvel

     [3] - If and only if the sea ice model can dump out daily data - as I
           understand it, it now can.

     More details are at



     * pop2 (questions? contact njn01)
        Set the ocean environment variables OCN_TAVG_TRACER_BUDGET 
        and OCN_TAVG_HIFREQ to TRUE to activate tracer budget terms
        and high-frequency ocean output. These variables are located
        at the end of the env_run.xml file:

             "OCN_TAVG_TRACER_BUDGET"   value="TRUE"  
             "OCN_TAVG_HIFREQ"          value="TRUE"  

SourceMods Information

  * Dave Lawrence / Brian Kauffman (cpl): 
    Turn on 3 hour auxiliary history files fields needed to as input to datm to drive clm.

    In addition to changing the value of a nml variable (see above),
    we need a one-line source mod to the coupler main program (ccsm_driver.F90).
    This change changes the list of fields that go into the history file.

    Unfortunately, the list of fields for 3 hour history output is
    hardcoded to be atm states sent to the coupler, but no fluxes
    (because code was designed to address some other use-case).

    To get the desired fields, states AND fluxes, at the 3hr time interval 
    one character string must be altered in ccsm_driver.F90

character(CL) :: hist_a2x3hr_flds  = 'Sa_z:Sa_u:Sa_v:Sa_tbot:Sa_ptem:Sa_shum:Sa_dens:Sa_pbot:Sa_pslv:Faxa_lwdn'


character(CL) :: hist_a2x3hr_flds  = 'Sa_z:Sa_u:Sa_v:Sa_tbot:Sa_ptem:Sa_shum:Sa_dens:Sa_pbot:Sa_pslv:Faxa_lwdn:&

  * Keith Lindsay / Nancy Norton (ocn): 
    A patched version of mix_submeso.F90 to pass 5d DEBUG smoke test is required:

  * Dave Bailey (ice): 
    A patched version of ice_history.F90 to read the expanded list of output variables is required:

    Also need to add "-DAEROFRC -DCCSM3FRC -DPONDFRC" to cicedefs in Buildconf/cice.buildexe.csh

Performance/Cost Estimates

  * [put estimated cost/performance info here]
Special Instructions

  * Run in CAVES:

  xmlchange -file env_build.xml -id EXEROOT -val '/gpfs/proj2/dasg017/$CASE'

  * Have the short-term archiver link output to CAVES:

  xmlchange -file env_run.xml -id DOUT_S_ROOT -val '/gpfs/proj2/dasg017/archive/$CASE'

  * Both the cpl and ice daily output is one day per file. To have these packaged
    up into monthly files, add calls to the following two scripts:


    to the long-term archiver.

  * To save the final history files in a directory parallel to the archive directory,
    add a call to the following script near the end of the long-term archiver:


Pre-Run Instructions

  * Run create_production_test
  * Run debug smoke test

  * Add NCAR Software Levels info to checklist 

Run Instructions

  Run Length: 156 years

  Account key:  93300471

  Priority/Targeted queue:  regular


Diagnostics Plan

  * [put diagnostics plan here]

Additional Information

  * [put any additional information here]

Return to Top

Run Checklist

Complete the following checklist prior to beginning the production run:

1.  Update status file: /web/web-data/cseg/ccsm4_0_runs/b40.20th.track1.1deg.011/status.html  [assigned, pending, running]

2.  Document NCAR software levels at beginning of run (use the spinfo command on bluefire)
NCAR SOFTWARE LEVELS: Wed May 19 16:22:54 MDT 2010.
AIX:                  bos.mp    
CSM:                  csm.core  
LoadLeveler:          LoadL.full
GPFS:                 gpfs.base 
VSD:                  rsct.vsd.vsdd
POE:                  ppe.poe   
PESSL:                pessl.rte.smp
ESSL:                 essl.rte.smp
FORTRAN:              xlfrte    
PERL:                 perl.rte  
C:                    xlC.rte   

3.  Complete the following table, as necessary, showing
    the component liaison's name and the date the setup
    was approved.

   Component         Liaison/                     Date Approved

      atm            hannay                   2010-05-20 03:28:00

      cpl            [kauff,mvertens,tcraig,other]    ----

      ice            dbailey                  2010-05-19 09:17:30

      lnd            slevis                   2010-05-19 11:37:26

      ocn            njn01                    2010-05-19 21:55:32

      env_ file      [mvertens,other]                 ----

      data           strand                   2010-05-20 15:15:57

4.  Create_production_test completed   mai    2010-05-19 10:49:13

5.  Debug smoke test completed         mai    2010-05-19 17:05:59

6.  Performance review completed [who,when]

Return to Top



Return to Top