1.1.10. Getting Help¶
In addition to this users-guide there are several other resources that are available to help you use CLM5.0. The first one is the CESM2.1 User’s-Guide, which documents the entire process of creating cases with CESM2.1. And next is the CIME User’s Guide which goes over the scripts and infrastructure used for running CLM5.0 in CESM2.1. The CESM bulletin board which is a web-site for exchanging information between users of CESM. There are also CLM web-pages specific for CLM, and finally there is an email address to report bugs that you find in CESM2.1.
1.1.10.1. The CESM User’s-Guide¶
release-clm5.0 release-clm5.0 in CESM2.1 is always run from within the standard CESM2.1 build and run scripts. Therefore, the user of CLM5.0 should familiarize themselves with the CESM2.1 scripts and understand how to work with them. User’s-Guide documentation on the CESM2.1 scripts are available from the following web-page. The purpose of this CLM5.0 in CESM2.1 User’s Guide is to give the CLM5.0 user more complete details on how to work with CLM and the set of tools that support CLM, as well as to give examples that are unique to the use of CLM. However, the CESM2.1 Scripts User’s-Guide remains the primary source to get detailed information on how to build and run the CESM system.
1.1.10.2. The CIME User’s-Guide¶
The CIME Users’-Guide goes into the how to use the scripts and infrastructure of the CESM. CIME Users Guide
1.1.10.3. The CESM Bulletin Board¶
There is a rich and diverse set of people that use the CESM, and often it is useful to be in contact with others to get help in solving problems or trying something new. To facilitate this we have an online Bulletin Board for questions on the CESM. There are also different sections in the Bulletin Board for the different component models or for different topics.
1.1.10.4. The CLM web pages¶
The main CLM web page contains information on the CLM, it’s history, developers, as well as downloads for previous model versions. There are also documentation text files in the $CTSMROOT/doc directory that give some quick information on using CLM.
CLM web page |cesmrelease| |version| web page CLM Documentation Text Files
Also note that several of the XML database files can be viewed in a web browser to get a nice table of namelist options, namelist defaults, or compsets. Simply view them as a local file and bring up one of the following files:
$CTSMROOT/bld/namelist_files/namelist_definition_clm4_0.xml – definition of CLM4.0 namelist items.
$CTSMROOT/bld/namelist_files/namelist_definition_clm4_5.xml – definition of CLM4.5/CLM5.0 namelist items.
$CTSMROOT/bld/namelist_files/namelist_defaults_clm4_0.xml – default values for CLM4.0 namelist items.
$CTSMROOT/bld/namelist_files/namelist_defaults_clm4_5.xml – default values for CLM4.5/CLM5.0 namelist items.
$CTSMROOT/cime_config/config_component.xml – definition of all the CLM specific XML variables.
$CTSMROOT/cime_config/config_compsets.xml – definition of all the CLM compsets.
$CTSMROOT/bld/namelist_files/history_fields_clm4_0.xml – definition of CLM4.0 history fields.
$CTSMROOT/bld/namelist_files/history_fields_clm4_5.xml – definition of CLM4.5/CLM5.0 history fields.
1.1.10.5. Reporting bugs in CLM5.0¶
If you have any problems, additional questions, bug reports, or any other feedback, please report it as an issue on GitHub https://github.com/ESCOMP/ctsm/issues or for CIME scripts and infrastructure to https://github.com/ESMCI/CIME/issues. Or send an email to <cesmhelp@cgd.ucar.edu> or <ctsm-software@ucar.edu>. If you find bad, wrong, or misleading information in this users guide report it as an issue on CTSM.
1.1.10.6. Some Acronym’s and Terms We’ll be Using¶
- CAM
Community Atmosphere Model (CAM). The prognostically active atmosphere model component of CESM.
- CESM
Community Earth System Model (CESM). The coupled earth system model that CLM is a component of.
- CIME
The Common Infrastructure for Modeling the Earth (CIME - pronounced “SEAM”) provides a Case Control System for configuring, compiling and executing Earth system models, data and stub model components, a driver and associated tools and libraries.
- CLM
Community Land Model (CLM). The prognostically active land model component of CESM.
- CLMBGC
Community Land Model (CLM5.0) with BGC Biogeochemistry. Uses CN Biogeochemistry with vertically resolved soil Carbon, CENTURY model like pools, and Nitrification/De-Nitrification. The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="phys clm5_0 -bgc bgc
- CLMBGC-Crop
Community Land Model (CLM5.0) with BGC Biogeochemistry and prognotic crop. The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="phys clm5_0 -bgc bgc -crop
- CLMCN
Community Land Model (CLM) with Carbon Nitrogen (CN) Biogeochemistry (either CLM4.0, CLM4.5 or CLM5.0) The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="-bgc cn" -append
- CLMSP
Community Land Model (CLM) with Satellite Phenology (SP) (either CLM4.0, CLM4.5 or CLM5.0) The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="-bgc sp" -append
- CLMU
Community Land Model (CLM) Urban Model (either CLM4.0, CLM4.5 or CLM5.0). The urban model component of CLM is ALWAYS active (unless you create special surface datasets that have zero urban percent, or for regional/single-point simulations for a non-urban area).
- CRUNCEP
The Climate Research Unit (CRU) analysis of the NCEP atmosphere reanalysis atmosphere forcing data. This can be used to drive CLM with atmosphere forcing from 1901 to 2016. This data is updated every year, the version we are currently using is Version-7. The las CESM1.2.2 release used Version-4 data.
- CTSM
The Community Terrestrial Systems Model, of which CLM5.0 and CLM4.5 are namelist option sets of. CTSM is a wider community that includes using CTSM for Numerical Weather Prediction (NWP) as well as climate.
- DATM
Data Atmosphere Model (DATM) the prescribed data atmosphere component for CESM. Forcing data that we provide are either the CRUNCEP, Qian, or GSWP3 forcing datasets (see below).
- DV
Dynamic global vegetation, where fractional PFT (see PFT below) changes in time prognostically. Can NOT be used with prescribed transient PFT (requires either CLMBGC or CLMCN for either CLM4.0, CLM4.5 or CLM5.0). The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="-bgc cndv" -append
This option is being phased out for the different methodology of FATES (see below). DV is not currently scientifically validated and as such should be considered experimental.
- ESMF
Earth System Modeling Framework (ESMF). They are a software project that provides a software library to support Earth System modeling. We provide interfaces for ESMF as well as use their regridding capabilities for offline CLM tools.
- FATES
Functionally Assembled Terrestrial Ecosystem Simulator. This is being developed by the Next Generation Ecosystem Experiment Tropics’ (NGEE-T) project and uses both CLM5.0 and the land model component of E3SM (Energy Exascale Earth System Model).
- FUN
Fixation and Uptake of Nitrogen model, a parameter option of CLM5.0.
- GSWP3
Global Soil Wetness Project (GSPW3) atmospheric forcing data. It is a 3-hourly 0.5° global forcing product (1901-2014) that is based on the NCEP 20th Century Reanalysis, with additional bias corrections added by GSWP3.
- LUNA
Leaf Utilization of Nitrogen for Assimilation parameterization option as part of CLM5.0.
- NCAR
National Center for Atmospheric Research (NCAR). This is the research facility that maintains CLM with contributions from other national labs and Universities.
- NCEP
The National Center for Environmental Prediction (NCEP). In this document this normally refers to the reanalysis atmosphere data produced by NCEP.
- MOSART
Model for Scale Adaptive River Transport, ROF model component option added as part of CLM5.0. It is the standard ROF model used in CLM5.0 compsets.
- PFT
Plant Function Type (PFT). A type of vegetation that CLM parameterizes.
- PTCLM
PoinT CLM (PTCLM) a python script that operates on top of CLM for CLM5.0 to run single point simulations for CLM.
- ROF
River runOff Model to route flow of surface water over land out to the ocean. CESM2.1 has two components options for this the new model MOSART and previous model RTM.
- RTM
River Transport Model, ROF model component option that has been a part of all versions of CESM. It is the standard ROF model used in CLM4.5 and CLM4.0 compsets.
- SCRIP
Spherical Coordinate Remapping and Interpolation Package (SCRIP). We use it’s file format for specifying both grid coordinates as well as mapping between different grids.
- VIC
Variable Infiltration Capacity (VIC) model for hydrology. This is an option to CLM5.0 in place of the standard CLM5.0 hydrology. The CLM_CONFIG_OPTS option for this is
./xmlchange CLM_CONFIG_OPTS="-vichydro on" -append