| CCSM Research Tools: CLM4.0 User's Guide Documentation | ||
|---|---|---|
| Prev | Chapter 3. Adding New Resolutions or New Files to the build-namelist Database | Next |
To add or change the default filenames you edit the models/lnd/clm/bld/namelist_files/namelist_defaults_clm.xml and either change an existing filename or add a new one. Most entries in the default namelist files, include different attributes that describe the different properties that describe the differences in the datasets. Attributes include the: resolution, year to simulation, range of years to simulate for transient datafiles, the land-mask, the representative concentration pathway (rcp) for future scenarios, and the type of biogeochemistry (bgc) model used. For example the fatmgrid for the 1.9x2.5 resolution is as follows:
<fatmgrid hgrid="1.9x2.5" >lnd/clm2/griddata/griddata_1.9x2.5_060404.nc </fatmgrid> |
Different types of simulations and different types of configurations for CLM require different lists of files. The Carbon Nitrogen (cn) Biogeochemistry model for example requires fndepdat files, which are NOT required by other bgc modes. Transient simulations also require transient datasets, and the names of these datasets are sometimes different from the static versions (sometimes both are required as in the dynamic PFT cases).
In the following table we list the different files used by CLM, they are listed in order of importance, dependencies, and customizing. So the required files are all near the top, and the files used only under different conditions are listed later, and files with the fewest dependencies are near the top, as are the files that are least likely to be customized.
Table 3-1. Required Files for Different Configurations and Simulation Types
| Filename | Config. type | Simulation type | Resol. Dependent? | Other Dependencies? |
|---|---|---|---|---|
| Notes | ||||
| fpftcon | ALL | ALL | No | No |
Not usually customized, as describes plant function type properties. | ||||
| fsnowoptics | ALL | ALL | No | No |
Not usually customized as describes global snow optical properties. | ||||
| fsnowaging | ALL | ALL | No | No |
Not usually customized as describes global snow aging properties. | ||||
| fatmgrid | ALL | ALL | Yes | No |
Creating, using mkgriddata usually gives you the amount of customization you need, as it just describes the grid and grid extents. | ||||
| fatmlndfrc | ALL | ALL | Yes | land-mask |
Describes the land-mask for points with active land, as well as the fraction of each grid-cell covered by land. You might customize it to make sure the land-fraction of your grid-cell matches the expected values for your site. But, usually you will just use what mkgriddata gives you. | ||||
| fsurdat | ALL | ALL | Yes | simulation-year |
Describes percentages of different land-units, columns and vegetation types within each grid-cell. To customize for a specific point or region you may want to use custom input datasets to mksurfdata when creating the file. | ||||
| faerdep | ALL | Constant and transient scenarios | Yes | simulation-year,simulation-year range, and possibly representative concentration pathway (rcp) |
You may customize this file to get the aerosol deposition characteristics of your site if available. Or use a higher resolution dataset when you use aerdepregrid.ncl to create this file. Note, both constant and transient files have the same namelist entry name. | ||||
| fndepdat | bgc=cn/cndv | Constant scenarios | Yes | simulation-year and possibly representative concentration pathway (rcp) |
You may customize this file to get the Nitrogen deposition characteristics of your site if available. Or use a higher resolution dataset when you use ndepregrid.ncl to create this file. | ||||
| fpftdyn | ALL | transient land-use land-cover change | Yes | Simulation year range, and possibly representative concentration pathway (rcp) |
| See notes on fsurdat files. | ||||
| frivinp_rtm | RTM only | ALL | No | No |
We only provide a half-degree global river routing file. If you want to model river flow for a smaller scale, or a basin regional scale, you would need to create your own custom file to do that. Normally, we turn river-routing OFF for regional or single point simulations. | ||||
| flndtopo | ALL | fine-mesh simulations (specifying land resolution as a finer grid than atmosphere resolution). | Yes | No |
You may customize to give better surface heights for your site, or input a higher resolution orography file when you create it using mkgriddata. | ||||
| fatmtopo | ALL | fine-mesh simulations (specifying land resolution as a finer grid than atmosphere resolution). | Yes | No |
You may customize to give better surface heights for your site, or input a higher resolution orography file when you create it using mkgriddata. | ||||
| fndepdyn | bgc=cn/cndv | transient simulations | Yes | Simulation year range |
You may customize this file to get the Nitrogen deposition characteristics of your site if available. Or use a higher resolution dataset when you use ndepregrid.ncl to create this file. | ||||
| finidat | ALL | RUN_TYPE="startup", CLM_FORCE_COLDSTART="off" | Yes | mask, maxpft, bgc, sim_year, start-date |
Used for starting the model from a spun-up state. Create these files by running the model for multiple years and saving the restart file from the end of a spin-up simulation. | ||||