SMS:CMS-Wave Simulation File

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

• CMS-Wave Files
• File Formats