Chapter 1. How to customize the configuration for a case with CLM

Table of Contents
Choosing a compset using CLM
Customizing the CLM setup
Customizing the CLM namelist
Customizing the DATM Namelist and Streams files
Conclusion to customizing chapter

The CESM1.1.1 User's Guide gives you the details on how to create, setup, build, and run a case. That is the document to give you the details on using the CESM scripts. The purpose of this document is to give you the details when using CESM with CLM on how to customize and use advanced features in CLM. You should be familiar with the CESM1.1.1 User's Guide and how to setup cases with CESM1.1.1 before referring to this document.

In this chapter we deal with three different ways of customizing a case: Choosing a compset, Customizing Configuration options, and customizing the CLM Namelist. There are many different compsets that use CLM and many are setup to enable special features of CLM from the start. So the first thing you want to be familiar with are the different options in the compsets. The next section shows the different options for customizing the configuration options for CLM. Here we introduce the CLM configure and build-namelist scripts and how using the options in env_build.xml and env_run.xml you can customize the configuration and the namelist.

Choosing a compset using CLM

When setting up a new case one of the first choices to make is which "component set" (or compset) to use. The compset refers to which component models are used as well as specific settings for them. We label the different types of compsets with a different letter of the alphabet from "A" (for all data model) to "X" (for all dead model). The compsets of interest when working with CLM are the "I" compsets (which contain CLM with a data atmosphere model and a stub ocean, and stub sea-ice models), "E" and "F" compsets (which contain CLM with the active atmosphere model (CAM), prescribed sea-ice model, and a data ocean model), and "B" compsets which have all active components. Below we go into details on the "I" compsets which emphasize CLM as the only active model, and just mention the two other categories.

When working with CLM you usually want to start with a relevant "I" compset before moving to the more complex cases that involve other active model components. The "I" compsets can exercise CLM in a way that is similar to the coupled modes, but with much lower computational cost and faster turnaround times.

Compsets coupled to data atmosphere and stub ocean/sea-ice ("I" compsets)

  1. I_2000(I) CLM with QIAN atm input data for 1972-2004 and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000

  2. I_1850(I1850) CLM with QIAN atm input data for 1948 to 1972 and Satellite phenology (SP), CO2 level and Aerosol deposition for 1850

  3. I_1850_CN(I1850CN) CLM with QIAN atm input data for 1948 to 1972 and CN (Carbon Nitrogen) biogeochemistry, 1850 CO2 and Aerosol deposition

  4. I_1850_SPINUP_3HrWx_CN(I1850SPINUPCN) CLM with BCN CPLHIST 3-hourly weather forcing data and half-hourly solar for 1850 spinup of CN (Carbon Nitrogen) biogeochemistry, CO2 level and Aerosol deposition for 1850

  5. I_2000_1PTFRC(I1PT) CLM with single point tower site atm input data and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000

  6. I_1850-2000(I20TR) CLM with QIAN atm input data for 1948 to 1972 and transient Satellite phenology (SP), and Aerosol deposition from 1850 to 2000 and 2000 CO2 level

  7. I_1850-2000_CN(I20TRCN) CLM with QIAN atm input data for 1948 to 1972 and transient CN, Aerosol dep from 1850 to 2000 and 2000 CO2 level

  8. I_1948-2004(I4804) CLM with QIAN atm input data for 1948 to 2004 and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000

  9. I_1948-2004_CN(I4804CN) CLM with QIAN atm data for 1948 to 2004 and CN (Carbon Nitrogen) biogeochemistry, CO2 level and Aerosol deposition for 2000

  10. I_2000_CN(ICN) CLM with QIAN atm input data for 1972-2004 and CN (Carbon Nitrogen) biogeochemistry, CO2 level and Aerosol deposition for 2000

  11. I_TEST_2003_CN(ICNTEST) Test active land model with QIAN atm input data for just 2002-2003 and CN (Carbon-Nitrogen), CO2 level and Aerosol deposition for 2000 (BECAUSE OF THE SHORT FORCING PERIOD -- DO NOT USE FOR LONG SIMULATIONS)

  12. I_2000_GLC(IG) Active glacier model and active land model with QIAN atm input data for 1972-2004 and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000

  13. I_1850_GLC(IG1850) CLM and CISM with QIAN atm input data for 1948 to 1972 and Satellite phenology (SP), 1850 CO2 and Aerosol deposition

  14. I_1850-2000_GLC(IG20TR) CLM and CISM with QIAN atm data for 1948 to 1972 and transient Satellite phenology (SP), and Aerosol deposition from 1850 to 2000 and 2000 CO2 level

  15. I_1850-2000_CN_GLC(IG20TRCN) CLM and CISM with QIAN atm input data for 1948 to 1972 and transient CN, Aerosol dep from 1850 to 2000 and 2000 CO2 level

  16. I_1948-2004_GLC(IG4804) CLM and CISM with QIAN atm input data for 1948 to 2004 and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000

  17. I_1948-2004_CN_GLC(IG4804CN) CLM and CISM with QIAN atm data for 1948 to 2004 and CN (Carbon Nitrogen) biogeochemistry, CO2 level and Aerosol deposition for 2000

  18. I_2000_CN_GLC(IGCN) CLM and CISM with QIAN input data for 1972-2004 and CN (Carbon Nitrogen) biogeochemistry, CO2 level and Aerosol deposition for 2000

  19. I_RCP2.6_CN_GLC(IGRCP26CN) CLM and glacier model, RCP2.6 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  20. I_RCP4.5_CN_GLC(IGRCP45CN) CLM and glacier model, RCP4.5 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  21. I_RCP6.0_CN_GLC(IGRCP60CN) CLM and glacier model, RCP6.0 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  22. I_RCP8.5_CN_GLC(IGRCP85CN) CLM and glacier model, RCP8.5 future scenario, with CN in CLM, QIAN atm input data for 1972-2004, 2000 CO2 level

  23. I_RCP2.6_CN(IRCP26CN) CLM, RCP2.6 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  24. I_RCP4.5_CN(IRCP45CN) CLM, RCP4.5 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  25. I_RCP6.0_CN(IRCP60CN) CLM, RCP6.0 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  26. I_RCP8.5_CN(IRCP85CN) CLM, RCP8.5 future scenario, with CN in CLM, QIAN atm input data for 1972 to 2004, 2000 CO2 level

  27. I_TEST_2003(ITEST) Test active land model with QIAN atm input data for just 2002-2003 and Satellite phenology (SP), CO2 level and Aerosol deposition for 2000 (BECAUSE OF THE SHORT FORCING PERIOD -- DO NOT USE FOR LONG SIMULATIONS)

Compsets coupled to active atmosphere with data ocean

CAM compsets are compsets that start with "E" or "F" in the name. They are described more fully in the scripts documentation or the CAM documentation. "E" compsets have a slab ocean model while "F" compsets have a data ocean model.

Fully coupled compsets with fully active ocean, sea-ice, and atmosphere

Fully coupled compsets are compsets that start with "B" in the name. They are described more fully in the scripts documentation.

Conclusion to choosing a compset

We've introduced the basic type of compsets that use CLM and given some further details for the "standalone CLM" (or "I" compsets). The config_compsets.xml lists all of the compsets and gives a full description of each of them. In the next section we look into customizing the setup time options for compsets using CLM.