The source code and datasets required to run the Community Land Model version 2.1 (CLM2.1) in offline mode (uncoupled from other components of the Community Climate System Model version 2 (CCSM2.0.1)) can be obtained via the web from:
http://www.cgd.ucar.edu/tss/clm.
The user should refer to the CAM2.0 User's Guide or the CCSM2.0.1 General Documentation for instructions on obtaining code and datasets to run CLM2.1 coupled to other CCSM2.0.1 components.
It is assumed that the user has access to the utilities tar, Free Software Foundation gunzip and gmake (GNU gmake).
The CLM2.1 distribution consists of two tar files:
CLM2.1_code.tar.gz
and
CLM2.1_inputdata.tar.gz.
The file CLM2.1_code.tar.gz contains code, documentation, and scripts. This file must first be uncompressed with the gunzip utility and then "untarred" as follows:
gunzip -c CLM2.1_code.tar.gz | tar xvf -
The above command both uncompresses and "untars" the code into a clm2/ subdirectory. The directory hierarchy for "clm2/" is as follows:
| Directory Name | Description |
| src/ | Directory of FORTRAN and "C" source code |
| src/biogeophys/ | Biogeophysics routines (e.g., surface fluxes) |
| src/camclm_share/ | Code shared between the CLM2 and CAM (e.g., calendar information) |
| src/csm_share/ | Code shared by all the geophysical model components of the Community |
| Climate System Model (CCSM). Currently contains code for CCSM | |
| message passing orbital calculations, and system utilities. | |
| src/ecosysdyn/ | Ecosystem dynamics routines (e.g., leaf and stem area index) |
| src/main/ | Control (driver) routines |
| src/mksrfdata/ | Routines for generating surface datasets |
| src/riverroute/ | River routing (RTM) routines |
| src/utils/ | Independent utility routines |
| src/utils/esmf/ | Earth System Modeling Framework utilities |
| src/utils/timing/ | General purpose timing library |
| bld/ | Directory of build, test and run scripts |
| bld/offline/ | Script to build and execute the model on various platforms |
| bld/offline/tests | Perl scripts for model development testing |
| doc/ | model documentation |
| tools/ | Directory of tools for input dataset manipulation |
| tools/convert_ascii/ | Routines for converting user-generated ascii surface dataset files to netCDF format suitable for use by the model (this tool is used independent of running the model) |
| tools/cprlndnc/ | Produces executable that compares model netCDF history files (this tool is used independent of running the model) |
| tools/convert_init | Tool for converting CLM2.0 initial datasets to CLM2.1 form. |
The file CLM2.1_inputdata.tar.gz contains surface and offline
atmospheric forcing datasets. This file must first be uncompressed
with the gunzip utility and then "untarred" as follows:
gunzip -c CLM2.1_inputdata.tar.gz | tar xvf -
The above command results in a directory hierarchy containing inputdata/lnd/clm2/ as the root. This directory hierarchy is
outlined below.
| Directory Name | Synopsis |
| NCEPDATA/ | One year's worth of atmospheric forcing variables in monthly netCDF format suitable for running the model in offline mode (uncoupled from the atmospheric model) |
| inidata_2.1/ | Directory hierarchy containing netCDF CLM2.1 initial datasets |
| inidata_2.1/cam | Initial datasets for initializing CLM2.1 from a spun-up state when running in cam mode (can also be used when running in offline mode) |
| inidata_2.1/ccsm | Initial datasets for initializing CLM2.1 from a spun-up state when running in ccsm mode (can also be used when running in offline mode) |
| inidata_2.1/offline | initial datasets for initializing CLM2.1 from a spun-up state when running in offline mode |
| pftdata/ | Plant functional type (PFT) physiological constants dataset (ascii format) |
| rawdata/ | "Raw" (highest provided resolution) datasets (netCDF format) |
| (used by CLM2.1 to generate surface datasets at model resolution) | |
| rtmdata/ | River direction map for RTM in ascii format |
| srfdata/ | Directory hierarchy containing netCDF CLM2.1 surface datasets |
| srfdata/cam | Surface datasets for running CLM2.1 in cam mode |
| (can also be used when running in offline mode) | |
| srfdata/csm | Surface datasets for running CLM2.1 in ccsm mode |
| (can also be used when running in offline mode) | |
| srfdata/offline | Surface datasets for running CLM2.1 in offline mode |