CESM Research Tools: CLM4.5 in CESM1.2.0 User's Guide Documentation

Erik Kluzek

NCAR
Jul-13-2013
$URL: https://svn-ccsm-models.cgd.ucar.edu/clm2/branches/cesm1_2_rel/models/lnd/clm/doc/UsersGuide/clm_ug.xml $

Dedication

Dedicated to the Land Model Working Group, winners of the 2008 CCSM Distinguished Achievement Award. May you continue to collaborate together well, and continue to drive the science of land surface modeling forward with your diligent and persistent efforts.

Table of Contents
Acknowledgments
Introduction
Introduction to the CLM4.5 User's Guide
Important Notes and Best Practices for Usage of CLM4.5
How to Use This Document
What is new with CLM4.5 in CESM1.2.0 since previous public releases?
Quickstart to using CLM4.5
What is scientifically validated and functional in CLM4.5 in CESM1.2.0?
Standard Configuration and Namelist Options that are Validated
Configure Modes NOT scientifically validated, documented, supported or, in some cases, even advised to be used:
Namelist options that should NOT be exercised:
Build-Namelist options that should NOT be exercised:
Namelist items that should NOT be exercised:
What are the UNIX utilities required to use CLM4.5?
Other resources to get help from
The CESM User's-Guide
The CESM Bulletin Board
The CLM web pages
Reporting bugs in CLM4.5
Some Acronym's and Terms We'll be Using
1. How to customize the configuration for a case with CLM
Choosing a compset using CLM
Compsets coupled to data atmosphere and stub ocean/sea-ice ("I" compsets)
Compsets coupled to active atmosphere with data ocean
Fully coupled compsets with fully active ocean, sea-ice, and atmosphere
Conclusion to choosing a compset
Customizing the CLM setup
CLM Script configuration items
User Namelist
Precedence of Options
Setting Your Initial Conditions File
Other noteworthy configuration items
Downloading DATM Forcing Data
Customizing via the build script files
More information on the CLM configure script
Customizing the CLM namelist
Definition of Namelist items and their default values
Examples of using different namelist features
Customizing the DATM Namelist and Streams files
CLMCRUNCEP mode and it's DATM settings
CLM_QIAN mode and it's DATM settings
CLM1PT mode and it's DATM settings
CPLHIST3HrWx mode and it's DATM settings
Conclusion to customizing chapter
2. Using the CLM tools to create your own input datasets
Common environment variables and options used in building the FORTRAN tools
General information on running the FORTRAN tools
Running FORTRAN tools with namelists
Running FORTRAN tools with command line options
Running FORTRAN tools built with SMP=TRUE
Using NCL scripts
The File Creation Process
Using the cprnc tool to compare two history files
Using interpinic to interpolate initial conditions to different resolutions
Creating an output SCRIP grid file at a resolution to run the model on
Using mknocnmap.pl to create grid and maps for single-point regional grids
Creating mapping files that mksurfdata_map will use
Creating a domain file for CLM and DATM
Using mksurfdata_map to create surface datasets from grid datasets
Running mksurfdata.pl
Running mksurfdata_map by Hand
Converting unstructured grid output to gridded datasets for post processing
How to Customize Datasets for particular Observational Sites
Conclusion of tools description
3. Adding New Resolutions or New Files to the build-namelist Database
Managing Your Own Data-files
Adding Resolution Names
Adding or Changing Default Filenames
What are the required files?
4. How to run some special cases
Running with the prognostic crop model on
Running with the irrigation model on (for CLM4.0)
Spinning up the Satellite Phenology Model (CLMSP spinup)
Spinning up the CLM4.5 biogeochemistry (CLMBGC spinup)
Spinning up the CLM4.0 biogeochemistry Carbon-Nitrogen Model (CN spinup)
Spinning up the CLM4.0 Carbon-Nitrogen Dynamic Global Vegetation Model (CNDV spinup)
Running with MOAR data as atmospheric forcing to spinup the model
Running with your own previous simulation as atmospheric forcing to spinup the model
Running stand-alone CLM with transient historical CO2 concentration
5. How to run Single-Point/Regional cases
Which Single Point Option Should I choose?
Running PTS_MODE configurations
Warning about Running with a Single-Processor on a Batch Machine
Running Supported Single-point/Regional Datasets
Running Supported Single-point Datasets that have their own Atmospheric Forcing
Creating your own single-point/regional surface datasets
Running with your own atmosphere forcing
6. How to run PTCLM1.110726
Introduction to PTCLM
Guide to the options of PTCLM
Overview on using PTCLM
Details on the options of PTCLM
Examples using PTCLM
Adding data for use by PTCLM
PTCLM Group Site Lists
Dynamic Land-Use Change Files for use by PTCLM
Converting AmeriFlux Data for use by PTCLM
PTCLM transient example over a shorter time period
A bit about the structure of PTCLM, what it does, and how it works
7. Trouble Shooting Problems
Trouble with Setup
Trouble with Building
Trouble with Running
Tracking Problems by Querying Log Files
General Advice on Debugging Run time Problems
8. Scripts for testing CLM
Testing CLM Using the CESM Test Scripts
Testing CLM tools using the CLM Specific Stand-Alone Tools Testing Scripts
Testing PTCLM use the PTCLM test script
A. Building the Users-Guide Documentation for CLM
List of Tables
1-1. Scientifically Supported I Compsets
1-2. Functionally Supported I Compsets
1-3. CLM History Fields
3-1. Required Files for Different Configurations and Simulation Types
5-1. Atmosphere Forcing Fields
List of Figures
2-1. Data Flow for Creation of Surface Datasets from Raw SCRIP Grid Files
2-2. Legend for Data Flow Figures
2-3. Details of running mkmapdata.sh
2-4. Global Domain file creation
2-5. Domain file creation using mknoocnmap.pl
2-6. Details of running mksurfdata_map
List of Examples
1-1. Example user_nl_clm namelist file
1-2. Default CLM Namelist
1-3. Example user_nl_clm namelist adding and removing fields on primary history file
1-4. Example user_nl_clm namelist adding auxiliary history files and changing output frequency
1-5. Example user_nl_clm namelist removing all history fields
1-6. Example user_nl_clm namelist with various ways to average history fields
1-7. Example user_nl_clm namelist outputting some files in 1D Vector format
2-1. Example of running CLM to create a template file for interpinic to interpolate to
2-2. Example of building and running interpinic to interpolate a 1-degree finidat dataset to 10x15
2-3. Example of running mksurfdata.pl to create a 4x5 resolution fsurdat for a 1850 simulation year
2-4. Getting the raw datasets for mksurfdata_map to your local machine using the check_input_data script
4-1. Example Crop Simulation
4-2. Example Irrigation Simulation
4-3. Example AD_SPINUP Simulation for CLM4.5-BGC
4-4. Example Final CLMBGC Spinup Simulation for CLM4.5-BGC
4-5. Example AD_SPINUP Simulation for CLM4.0-CN
4-6. Example EXIT_SPINUP Simulation for CLM4.0-CN
4-7. Example Final CN Spinup Simulation for CLM4.0-CN
4-8. Example CLM4.0 CNDV Spinup Simulation
4-9. Example Simulation with MOAR Data on yellowstone
4-10. Example Fully Coupled Simulation to Create Data to Force Next Example Simulation
4-11. Example Simulation Forced with Data from the Previous Simulation
4-12. Example Transient Simulation with Historical CO2
5-1. Example of running CLM over a single-point test site in Brazil with the default Qian atmosphere data forcing.
5-2. Example of running CLM over the single-point of Mexicocity Mexico with the default Qian atmosphere data forcing.
5-3. Example of running CLM over the single-point of Vancouver Canada with supplied atmospheric forcing data for Vancouver.
5-4. Example of using CLM_USRDAT_NAME to run a simulation using user datasets for a specific region over Alaska
5-5. Example of creating a surface dataset for a single point
5-6. Example of setting up a case from the single-point surface dataset just created
5-7. Example of setting up a case with your own atmosphere forcing
5-8. Example of DATM streams files with your own forcing for 3-hourly data
6-1. Example of running PTCLM1 for US-UMB on yellowstone
6-2. Example of running PTCLM for the Mexicocity supported single point dataset
6-3. Example of running PTCLM for a spinup simulation with Qian data for tower years.
6-4. Example of running PTCLM on a user-defined machine with global PFT and soil types dataset
6-5. Example of running PTCLM for transient land-use 1991-2006 for US-Ha1 on yellowstone_intel
7-1. Example of cesm_setup problem with missing datasets