SMS:CMS-Wave Wave Breaking File

From XMS Wiki
Jump to navigationJump to search

CMS-Wave creates a solution consisting of energy dissipation values due to wave breaking at each cell in the domain. These values are stored in a single file for all input spectra. This file is the "brk" file. In SMS terminology, this is a scalar dataset on the grid.

When SMS reads the values from this file, it creates a scalar datasets for breaking. If the indices for the wave cases are coded as dates, SMS will simply create a new time step for each case. Otherwise, a new dataset will be created for each set of breaking values.

The BRK file created by CMS-Wave is an ASCII data file. There is no header or identifier as to what the data in the file is, other than the default extension of *.brk. However, that is not even required.

The first line of the file contains the dimensions of the grid (number of columns, number of rows) and the default size of a grid cell (in the I direction and then the J direction). If the grid does not consist of cells of constant size, the size for the J direction will be written as 999. Since this file is only utilized for dataset values, the dimensions are not important here.

The second line of the file contains the index of the case or wave spectra that resulted in these solution values. This is typically either a coded date (YYMMDDHH or YYYYMMDDHHMM), a simple index (1, 2, 3, ...) or a bin number indicating principal direction and period.

The values in the file are organized in row major format, starting with the "top" row (farthest away from the grid origin) and ending with the "bottom" row (closest to the origin and following the I direction).

CMS-Wave writes files with 5 values per row.

Sample File

80 80 10.000 10.000 // number of columns, number of rows, cell dimensions (dimensions are ignored)
201305281500 // index of first case in the simulation - often a coded date
-2.7912201E-05 -1.6299966E-05 ... -2.1632750E-05 // first 5 energy dissipation values of cells on the top row
. . . // remaining dissipation values
201305281800 // index of next case in the simulation
. . . // data for this case, repeated for each case


Related Topics