5.2.2  Determining Preparation Parameter Values

1. Decide on a name for the problem initialization. This is different from the case name specified in AN_ID.h. Choose a name that can be used as an identifier tag for this setup, for example NA1. Set up a file Prep_parm.tag_root with the tag_root extension that identifies the present model setup, NA1 in the present example. This file will contain the values of the following parameters:

HMAX

Maximum depth in cm.

ZTOP

Top pressure level; midpoint of first layer in cm.

X0DEG

Central longitude of the westernmost grid point (including ``ghost zones'').

Y0DEG

Central latitude of southernmost grid point (including ``ghost zones'').

XRDEG

Distance in degrees between the centers of the westernmost and easternmost grid cells (including ``ghost zones'').

YRDEG

Distance in degrees between the centers of the southernmost and northernmost grid cells (including ``ghost zones'').

DYDX

Ratio of DY to DX. Set DYDX = 999 for a grid that is uniform in lon/lat space. Set DYDX = 1 for a grid that is uniform in X-Y space.

HT\_BBL

Height of bottom boundary layer in cm (if used).

2. Write the tag_root name (NA1 in this example) as the one line of a file prep.in which will be used as the input file in the execution of the file prep. The prep file can then be executed with the command

prep < prep.in >& prep.out

and the standard out will be sent to the file prep.out. If an input file such as prep.in is not used, you need only execute prep and then supply the tag_root identifier name interactively when it is requested by the program.

When prep is executed it creates several subdirectories of the project directory for output files. These subdirectories are identified by the tag_root for the present run:

OUTPUT.TAG_ROOT
OUTPUT.TAG_ROOT/DATA
OUTPUT.TAG_ROOT/SETUP

For example, if the tag_root is NA1, then the subdirectory that will be created is OUTPUT.NA1, with its two subdirectories as above. At present, the following files are created and put in the OUTPUT.TAG_ROOT/DATA directory:

RUNDATA.TAG_ROOT

Model grid information in a binary data file.

EVP.TAG_ROOT

Elliptic solver binary data file.

KBVIEW.TAG_ROOT

Values of array KB(I0,J0) in an ASCII file.

S.TAG_ROOT

Salinity initialization data in a binary file.

T.TAG_ROOT

Temperature initialization data in a binary data file.

ZKB.TAG_ROOT

Vertical setup in a binary data file.

Coriolis.TAG_ROOT

Coriolis parameter values in an ASCII data file.

taux.TAG_ROOT

X-component wind stress in an ASCII file.

tauy.TAG_ROOT

Y-component wind stress in an ASCII file.

total_depth.TAG_ROOT

Model depth in a binary data file.

model_depth.TAG_ROOT

Model depths in an ASCII file.

lat_yr

Latitudes of the rho points in an ASCII.

long_xr

Longitudes of the rho points in an ASCII file.

The above files will be used by the MAIN/ main.F program when running model simulations. At present, three files that are used to set up the simulation are copied from the PREP directory to the subdirectory OUTPUT.TAG_ROOT/SETUP. The user may wish to add additional files to this directory in order to keep a record of how the run was initiated. These files are saved solely for this purpose. The files presently stored in OUTPUT.TAG_ROOT/SETUP are:

OUTPUT.TAG_ROOT/SETUP/ AN_ID.h
OUTPUT.TAG_ROOT/SETUP/ Def_prep.h
OUTPUT.TAG_ROOT/SETUP/ Diecast.h