Quickstart to using CLM4

Before working with CLM4 read the QuickStart Guide in the CESM1.1.1 Scripts User's Guide. Once you are familiar with how to setup cases for any type of simulation with CESM you will want to direct your attention to the specifics of using CLM.

For some of the details of setting up cases for CLM4 read the README and text files available from the "models/lnd/clm/doc" directory (see the "CLM Web pages" section for a link to the list of these files). Here are the important ones that you should be familiar with.

  1. README file describing the directory structure.

  2. Quickstart.userdatasets file describing how to use your own datasets in the model (also see the Section called Creating your own single-point/regional surface datasets in Chapter 5).

  3. models/lnd/clm/doc/KnownBugs file describing known problems in CLM4 (that we expect to eventually fix).

  4. models/lnd/clm/doc/KnownLimitationss file describing known limitations in CLM4 and workarounds that we do NOT expect to fix.

The IMPORTANT_NOTES file talks about important things for users to know about using the model scientifically. It content is given in the next chapter on "What is scientifically validated and functional in CLM4 in CESM1.1.1?".

The ChangeLog/ChangeSum talk about advances in different versions of CLM. The content of these files is largely explained in the previous chapter on "What is new with CLM4 in CESM1.1.1 since previous public releases?".

Note other directories have README files that explain different components and tools used when running CLM and are useful in understanding how those parts of the model work and should be consulted when using tools in those directories. For more details on configuring and customizing a case with CLM see Chapter 1.

The Quickstart.GUIDE (which can be found in models/lnd/clm/doc) is repeated here.

          Quick-Start to Using cpl7 Scripts for clm4

Assumptions: You want to use bluefire with clm4
             to do a clm simulation with data atmosphere and the
             latest atm forcing files and settings. You also want to cycle
             the atm data between 1948 to 2004 and you want to run at
             1.9x2.5 degree resolution.


   # Create the case

   cd scripts

   ./create_newcase -case <testcase> -mach bluefire_ibm -res f19_g16 -compset I4804 
   (./create_newcase -help -- to get help on the script)

   # Setup the case

   cd <testcase>
   ./xmlchange id1=val1,id2=val2  # to make changes to any settings in the env_*.xml files
   (./cesm_setup -help -- to get help on the script, this creates the ./<testcase>.run  \ 

   # Add any namelist changes to the user_nl_* files

   $EDITOR user_nl_*

   # Compile the code


   # Submit the run


Information on Compsets:

     "I" compsets are the ones with clm and datm7 without ice and ocean.
     Most of the "I" compsets use the CLM_QIAN data with solar following
     the cosine of solar zenith angle, precipitation constant, and other
     variables linear interpolated in time (and with appropriate time-stamps on
     the date). Some of the I compsets are:

     Name		  (short-name): Description
     I_2000                 (I):             CLM to simulate year=2000
     I_2000_1PTFRC          (I1PT):          CLM to simulate year=2000 with single-point forcing
     I_2000_CN              (ICN):           CLM to simulate year=2000 with Carbon-Nitrogen BGC  \ 
   model (CN)
     I_1850                 (I1850):         CLM to simulate year=1850
     I_1850_CN              (I1850CN):       CLM to simulate year=1850 with Carbon-Nitrogen BGC  \ 
   model (CN)
     I_1850_SPINUP_3HrWx_CN (I1850SPINUPCN): CLM to simulate year=1850 with MOAR forcing to spinup  \ 
   Carbon-Nitrogen BGC model (CN)
     I_1948_2004            (I4804):         CLM running with atm data over 1948-2004
     I_1850-2000            (I8520):         CLM with transient PFT over 1850-2000
     I_1948-2004_CN         (I4804CN):       CLM with CN on running with atm data over 1948-2004 
     I_1850-2000_CN         (I20TRCN):       CLM with CN on with transient PFT over 1850-2000
     I_RCP2.6_CN            (IRCP26CN):      CLM with CN on with transient PFT over 1850-2100 for  \ 
   RCP=2.6 scenario
     I_RCP4.5_CN            (IRCP45CN):      CLM with CN on with transient PFT over 1850-2100 for  \ 
   RCP=4.5 scenario
     I_RCP6.0_CN            (IRCP60CN):      CLM with CN on with transient PFT over 1850-2100 for  \ 
   RCP=6.0 scenario
     I_RCP8.5_CN            (IRCP85CN):      CLM with CN on with transient PFT over 1850-2100 for  \ 
   RCP=8.5 scenario

Automatically resubmitting jobs:

   After doing a short simulation that you believe is correct

   ./xmlchange CONTINUE_RUN=TRUE

   # Change RESUBMIT to number greater than 0, and CONTINUE_RUN to TRUE...