CAM2.0.2 is a combination of atmosphere, land, ocean and sea-ice components. In what follows we discuss the input datasets required by each of these components. CSMDATA refers to the root directory where the distribution datasets have been untarred by the user.
Input datasets needed for the atmospheric component provide initial state data, ozone boundary data and water vapor absorptivity/emissivity data. Only the ozone dataset contains time-variant input data which is based on a 365 day year with no leap years. All initial and boundary datasets are in NetCDF format.
In general, input dataset names follow the convention:
typesimulation dateresolutionSpectral truncation Vertical levelscreation date Where
|Field Name||Variable Name||Description|
|U||u||Zonal Wind component (m/sec)|
|V||v||Meridional Wind component (m/sec)|
|Q||q||Water vapor specific humidity (Kg/Kg)|
|Single Level Fields|
|PHIS||Surface geo-potential (m/s)|
|PS||P||Surface pressure (Pa)|
|SGH||SGH||Standard deviation of geo-potential height (m)|
|LANDM||landm||Land Ocean transition mask: LANDM = 0 indicates ocean, LANDM = 1 indicates land, and 0 LANDM 1 indicates a transition region.|
|TSICE||T||CSIM sea-ice model snow/ice surface temperature (not stored on CCSM flux-coupled simulations).|
|SNOWHICE||Snow depth over ice|
|TS1, TS2, TS3, TS4||T||Four CSIM sea-ice subsurface temperature levels (not stored on CCSM flux-coupled simulations) (K)|
At times it may be desirable to start the model from a more exact state of the atmosphere, with some of the fast processes (spin-up time 1 day) also represented on the initial conditions file. Table 2.6 lists optional fields which the model will read if they exist on the file. Fields which don't exist will be set to arbitrary values as indicated in the table:
|Field Name||Variable Name||Description|
|CLDLIQ||q(:,:,,ixcldliq,:)||Cloud liquid water mass mixing ratio (Kg/Kg); set to 0. if READTRACE=.false. or field not on file|
|CLDICE||q(:,:,,ixcldice,:)||Cloud ice mass mixing ratio (Kg/Kg); set to 0. if READTRACE=.false. or field not on file|
|CLOUD||cld||Cloud fraction ; set to 0. if field not on file|
|QCWAT||q||Specific humidity associated with cloud water routines ; (Kg/Kg); set to Q if field not on file|
|TCWAT||T||Temperature associated with cloud water routines ; (K); set to T if field not on file|
|LCWAT||lcwat||Total cloud water amount (liquid + ice) associated with cloud water routines ; (Kg/Kg); set to "CLDLIQ+CLDICE" if field not on file|
|PBLH||pblht||PBL height (m); set to 0. if field not on file|
|TPERT||T||Perturbation temperature (eddies in PBL) (K); set to 0. if field not on file|
|QPERT||q||Perturbation specific humidity (eddies in PBL) (KG/KG); set to 0. if field not on file|
|TSICERAD||T||Radiatively equivalent Surface T over seaice (K); set to TSICE if field not on file|
|TBOT||T||Lowest model level temperature (K); set to T(:,plev,:) if field not on file|
Finite-volume dynamics uses the same set of prognostic variables as shown above, except that U and V are on a staggered grid and are identified with names US and VS. When running with finite-volume dynamics, the initial dataset must contain US and VS; U and V are Ignored.
All Fields are instantaneous values. In addition to the fields listed above, the initial dataset contains information on the model date, the dimensionality of the fields, the spectral truncation, and the latitudes, longitudes, and vertical levels of the data.
A T42 (64 latitudes x 128 longitudes grid resolution) 26-level initial dataset is provided with the CAM2.0.2 distribution:
Other initial datasets at different model resolutions can also be found in the directories
The ozone boundary dataset contains ozone volume mixing ratios which are constant for a given latitude. This dataset is defined on a pressure grid (unlike the hybrid grid of the model). These values are interpolated to the model vertical levels at each model grid point. The ozone dataset is in NetCDF format and contains the fields PS and OZONE. PS is a constant 1000 mb pressure field needed for interpolation. The ozone dataset is specified by namelist variable BNDTVO. Unlike the initial conditions file, CAM is capable of interpolating the ozone dataset to any vertical and or horizontal resolution so the user need not specify new ozone datasets when changing model resolution. The default ozone dataset provided with the distribution is
This is a lookup table for water vapor absorption. It is specified by setting the namelist variable, ABSEMS_DATA. The default dataset provided with the dataset distribution can be found in
[Science description if any goes here]. As of CAM2.0.2.dev40, CAM requires the input aerosol dataset to be resolution-dependent. Memory and startup CPU overheads proved to be a bottleneck in the original implementation. Now horizontal interpolation to the target CAM grid and vertical integrals are done offline. Code and README describing the procedure are in subdirectory cam/tools/interpaerosols of the CAM distribution.
CAM 3.0 supports running with either a data ocean model or a prognostic slab ocean model. The data ocean model simply reads and interpolates sea surface temperature (SST) data. Running the data ocean component requires a time-variant SST dataset. The SST dataset must be at the model resolution and is specified by the namelist variable BNDTVS.
The standard SST dataset is a climatological dataset containing 12 monthly time samples. The model can also read multi-year SST datasets. If a multi-year SST dataset is used, the namelist variable, SST_CYC must be set to .false. (it's default value is .true.).
An SST dataset on a (64 X 128) Gaussian grid can be found in
Other SST datasets, at different model resolutions, can also be found in this directory.
The slab ocean model requires that the SST dataset specified by BNDTVS contain two additional fields specifying mixed layer depths and Q-fluxes. Preparation of these special SST datasets for the slab ocean model is described in Section 2.3.2.
The sea-ice component in CAM2.0.2 is a simplified version of the CCSM CSIM4 code. This component requires ice coverage data. The ice coverage data is contained in the same file as the SST data required by the ocean component. For the standard configuration, ice-coverage data is found in
For a full discussion of CLM2.1 input datasets see the CLM2.1 User's Guide at
CLM2.1 always requires a dataset providing plant functional type physiological constants. This dataset is specified via the CLM2.1 namelist variable FPFTCON.
A time-invariant CLM surface dataset will be generated at run time if the CLM namelist variable FSURDAT is set to blank. If this is the case, additional settings must be provided for MKSRF_FGLACIER, MKSRF_FLAI, MKSRF_FLANWAT, MKSRF_FSOICOL, MKSRF_FSOITEX, MKSRF_FURBAN, MKSRF_FVEGTYP. If a surface dataset at the model resolution already exists, then FSURDAT should be set appropriately. The default land surface dataset provided with the distribution is
Other provided surface datasets at other model resolutions can also be found in this directory.
CLM2.1 initial conditions will be generated at run time if the CLM2.1 namelist variable FINIDAT is blank (the default setting). It is important to note that due to the differences in data structures, CLM2.1 initial datasets are not in the same form as CLM2.0 initial datasets. The directory models/lnd/clm2/tools/convert_inic contains routines needed to perform the conversion of CLM2.0 initial datasets to CLM2.1 form. The README file in that directory contains necessary information to build and utilize the conversion tool. If spun up values exist for a model run, then FINIDAT should be correspondingly set. The default initial dataset provided with the distribution is:
This initial dataset should only be used in conjunction with the default CLM2.1 surface dataset given above.