next up previous contents
Next: 2 Creating and Running Up: UsersGuide Previous: Contents   Contents

1 Obtaining the Source Code and Datasets

The source code and datasets required to run the Community Land Model version 2.0 (CLM2.0) in offline mode (uncoupled from other components of the Community Climate System Model version 2 (CCSM2.0)) 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 User's Guide for instructions on obtaining code and datasets to run CLM2.0 coupled to other CCSM2.0 components.

It is assumed that the user has access to the utilities tar, Free Software Foundation gunzip and gmake (GNU gmake).

The CLM2.0 distribution consists of two tar files:


CLM2.0_code.tar.gz


and


CLM2.0_inputdata.tar.gz.


The file CLM2.0_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.0_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 Synopsis
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/ CLM2.0 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 CLM2.0 netCDF history files (this tool is used independent of running the model)
tools/makdep/ Produces executable needed by Makefile to generate dependencies when the model is built.


The file CLM2.0_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.0_inputdata.tar.gz | tar xvf -


The above command both uncompresses and "untars" the file into a inputdata/lnd/clm2/ subdirectory. The directory hierarchy for "inputdata/lnd/clm2/" is as follows:


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/ Directory heirarchy containing netCDF CLM2.0 initial datasets
inidata/cam Initial datasets for initializing CLM2.0 from a spun-up state when running in cam mode
  (can also be used when running in offline mode)
inidata/csm Initial datasets for initializing CLM2.0 from a spun-up state when running in csm mode
  (can also be used when running in offline mode)
inidata/offline initial datasets for initializing CLM2.0 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.0 to generate surface datasets at model resolution)
rtmdata/ River direction map for RTM in ascii format
srfdata/ Directory heirarchy containing netCDF CLM2.0 surface datasets
srfdata/cam Surface datasets for running CLM2.0 in cam mode
  (can also be used when running in offline mode)
srfdata/csm Surface datasets for running CLM2.0 in csm mode
  (can also be used when running in offline mode)
srfdata/offline Surface datasets for running CLM2.0 in offline mode



next up previous contents
Next: 2 Creating and Running Up: UsersGuide Previous: Contents   Contents
Mariana Vertenstein 2002-05-16