Overview
Type of inputs for SCHISM¶
Most SCHISM inputs can be visualized with ACE/xmgredit5 or xmgr5 tools; see src/Utility/ACE for instructions on how to install these tools. Other useful tools will be mentioned in the later chapters.
SCHISM input files can be broadly categorized into following 7 groups:
*.gr3
,hgrid.ll
: node centered spatial data and mesh connectivity. These file can be created/visualized usingACE/xmgredit5
;*.th
: time history files in ASCII format. The ASCII files can be visualized usingACE/xmgr5
;*.ic
: initial condition files. Some of these files use.gr3
format, while others have simple ASCII format;*.prop
: element-centered spatial data and properties; can be created/visualized usingACE/xmgredit5
;*.nc
: netcdf4 inputs, including time history (*.th.nc
), hotstart (hotstart.nc
), and nudging inputs (*_nu.nc
). These inputs may be created by PYSCHISM tool;*.nml
: main parameter input (param.nml
);*.in
: role-specific input files with individual formats. ASCII inputs include vertical grid (vgrid.in
), B.C. input (bctides.in
), andhydraulics.in
(for hydraulics module) etc;sflux/
: atmospheric and heat flux files in netcdf format (CF convention v1.0). These files can be visualized using standard tools like ncview, ferret etc;- Inputs from modules:
.nml
,.inp
etc.
Mandatory inputs¶
These inputs are required for all SCHISM simulations:
- Horizontal grid (
hgrid.gr3
) - Vertical grid (
vgrid.in
) - Parameter input (
param.nml
) - B.C. input (
bctides.in
) - Bottom friction input (
drag.gr3
, orrough.gr3
ormanning.gr3
, depending on parameter choice inparam.nml
)
We’ll explain these inputs in detail below. Comments/explanations are usually preceded by '!'.