SMS:CMS-Wave Simulation File

From XMS Wiki
Revision as of 18:05, 24 May 2016 by Dharker (talk | contribs) (added filetype ending.)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to: navigation, search

CMS-Wave simulation files (*.sim) contain a list of file names that are part of the simulation. This file is created by SMS when the simulation is exported. The file begins with a keyword that identifies this as a CMS-Wave simulation file, followed by the world origin and orientation of the grid.

The origin positions the grid in a projection (such as UTM or State Plane). It generally corresponds to the location of the corner of the grid offshore. The orientation is the CCW angle from East to the direction of the grid that goes from offshore to on shore. (For example, a coast that opens due West would have an orientation of 0.0, an coast line open to the South would have an orientaion around 270 (or -90) degrees.)

Each line begins with a key word identifying the file name. The order can be changed and only the DEP, OPTS and WAVE files are strictly required. The OPTS file includes the options that have been enabled for this simulation. If the OPTS file indicates that a file is needed, the line must appear in the SIM file. If a file is missing, the simulation will not perform as expected. If files are not needed, the presence of the line in the SIM file is ignored. For this reason, SMS writes all files to the SIM file every time.

Sample File

CMS-Wave 902500.0 4086600 135 /* Key word, grid origin, grid orientation*/
DEP grid.dep /* Name of input file containing depth values for each cell */
OPTS grid.std /* Name of input file containing model parameters */
SPEC grid.eng /* Name of input file containing energy density spectra (required in most cases) */
OBSE grid.obs /* Name of output file to save full spectra at specified monitoring locations */
NEST grid.nst /* Name of output file to save full spectra at specified nesting cells */
BREAK grid.brk /* Name of output file to save wave breaking indices or energy disipations at each cell. Follows the format of the DEP file */
SPGEN grid.txt /* Name of spectral parameter file, contains parameters used to generate spectra */
RADS grid.rad /* Name of output file to save wave radiation stress gradients at each cell. Follows the format of the CUR file */
STRUCT grid.struct /* Name of input file containing structure flags for each cell */
SELHTS grid.out /* Name of output file where CMS-Wave will write the bulk wave parameters for selected monitoring cells */
ETA grid.eta /* Name of optional input file containing water levels for each cell. Follows the format of the DEP file. This replaces the SUR card. Both are supported */
FRIC grid.fric /* Name of input file containing manning's n value for each cell. Follows the format of the DEP file */
FREF grid.fref /* Name of input file containing forward reflection value for each cell. Follows the format of the DEP file */
BREF grid.bref /* Name of input file containing reverse reflection value for each cell. Follows the format of the DEP file */
MUD grid.mud /* Name of input file containing mud(absorption) coefficient value for each cell. Follows the format of the DEP file */
WIND grid.wind /* Name of input file containing wind components for each cell. Follows the format of the CUR file */
WAVE grid.wav /* Name of output file for spatial wave conditions (height, direction) for each cell */
CURR grid.cur /* Name of optional input file containing current values (vx and vy) for each cell */

Related Topics