This section describes a typical directory structure the user will be working with when running the TIEGCM model. The working directory (workdir) is the “root” directory of the user’s project.
The model directory (modeldir) is typically a subdirectory under the working directory, and contains the model source code, supporting scripts, documentation, and scripts for running tests.
The data directory (datadir) may also be a subdirectory under the working directory, or it may be on a large temporary disk that is accessible from the working directory. The data directory contains start-up and input data files for running the model.
The user’s working directory will typically look something like this (the datadir can be on a large separate disk system):
workdir
|
-----------------------------------------------
| | | |
*.inp execdir/ modeldir/ datadir/
*.job |
*.out *.o
*.mod
*.nc
Make*
exec
Here, \*.inp are namelist input files, \*.job are job script s, and \*.out are are stdout files from model runs. The execdir is the build/execution directory (created by the first build), with object code (\*.o, \*.mod), model output history files (\*.nc), make files (Make\*), and an executable file (exec). Various other files may also be in the execdir. The modeldir and datadir directories are described below.
The job script in your working directory contains a shell variable specifying the modeldir, so it knows where to find the source code and supporting scripts for the build process. The namelist input file also refers to the datadir for start-up and other data input files (e.g., SOURCE, GPI_NCFILE, IMF_NCFILE, etc). These namelist parameters can use the environment variable TGCMDATA to specify the datadir (see section on namelist input files).
The model root directory is what you get when you download the model source code tar file. The model directory contains subdirectories with the model source code, supporting scripts, documentation, and test scripts:
modeldir
|
----------------------------------------------------------------------
| | | |
src/ scripts/ doc/ tests/
| | | |
Make.* userguide/ control/
*.F linux.job description/ climatology/
*.h ibm.job release/ dec2006
default.inp diags.table nov2003/
tgcm_contents README.download whi2008/
tgcm_ncdump
etc
src/ directory contents:
scripts/ directory contents:
doc/ directory contents:
tests/ directory contents:
The public TIEGCM data directory is what you get when you download the data tar file. This directory is typically referred to with the environment variable TGCMDATA. Subsequently, after the data download, you may obtain additional needed data files from the NCAR Community Data Portal. Here is a partial schematic of the datadir (where “tiegcmx.xx” is the desired model version):
datadir
|
-----------------------------------------------
| |
gpi*.nc tiegcmx.xx/
gswm*.nc |
imf *.nc TGCM.tiegcmx.xx.p*.nc
etc pcntr*smin*.nc
pcntr*smax*.nc
etc
Files listed on the left side refer to data input files that may be needed when running the model in different modes. These are netCDF files, specifically prepared for import into the TIEGCM model (they are not model start-up SOURCE files). These files are version-independent (can be used by (almost) any version of the model). They are usually provided to the model as namelist input parameters:
The “tiegcmx.xx/” subdirectory refers to the version of the model that was downloaded. This subdirectory contains start-up SOURCE files from benchmark runs executed by that version of the model (see Section on Benchmark Test Runs). These files can be used to remake the benchmark runs for testing and validation. Here is an example of start-up files provided for benchmark runs made by TIEGCM version 1.95:
TGCM.tiegcm1.94.p_dec2006_heelis_gpi_001.nc
TGCM.tiegcm1.94.p_dec2006_weimer_imf_001.nc
TGCM.tiegcm1.94.p_nov2003_heelis_gpi_001.nc
TGCM.tiegcm1.94.p_nov2003_weimer_imf_001.nc
TGCM.tiegcm1.94.p_whi2008_heelis_gpi_001.nc
TGCM.tiegcm1.94.p_whi2008_weimer_imf_001.nc
TGCM.tiegcm1.94.pclim_heelis_001.nc
pcntr_decsol_smax.nc
pcntr_decsol_smin.nc
pcntr_junsol_smax.nc
pcntr_junsol_smin.nc
pcntr_mareqx_smax.nc
pcntr_mareqx_smin.nc
pcntr_sepeqx_smax.nc
pcntr_sepeqx_smin.nc