CESM Research Tools: CLM4.5 in CESM1.2.0 User's Guide Documentation | ||
---|---|---|
Prev | Chapter 2. Using the CLM tools to create your own input datasets | Next |
The tools run either one of two ways, with a namelist to provide options, or with command line arguments (and NOT both). interpinic, gen_domain and cprnc run with command line arguments, and the other tools run with namelists.
mksurfdata_map and mkmapgrids run with namelists that are read from standard input. Hence, you create a namelist and then run them by redirecting the namelist file into standard input as follows:
./program < namelist |
interpinic, gen_domain, and cprnc run with command line arguments. The detailed sections below will give you more information on the command line arguments specific to each tool. Also running the tool without any arguments will give you a general synopsis on how to run the tool. For example to get help on running interpinic do the following.
> cd models/lnd/clm/tools/clm4_5/interpinic > gmake > ./interpinic |
When you enable SMP=TRUE
on your build of one of the tools that
make use of it, you are using OpenMP for shared memory parallelism (SMP). In
SMP loops are run in parallel with different threads run on different processors
all of which access the same memory (called on-node). Thus you can only usefully
run up to the number of processors that are available on a single-node of the machine
you are running on. For example, on the NCAR machine yellowstone there are 16 processors
per node, but the SMT hardware on the machine allows you to submit twice as many
threads or 32 threads. So to run interpinic on yellowstone
optimized, with 32 threads you would do the following:
> cd models/lnd/clm/tools/clm4_5/interpinic/src > gmake OPT=TRUE SMP=TRUE > setenv OMP_NUM_THREADS 32 > cd .. > ./interpinic `cat interpinic.runoptions` |