SMS:CMS-Wave Control File: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
No edit summary
 
(16 intermediate revisions by 3 users not shown)
Line 1: Line 1:
CMS-Wave parameter files always contain a single line of data defining the parameter options for the simulation. This line will include either 6, 10 or 15 values.  SMS writes all 15 values to the input files it creates.  The other formats are supported for backward compatibility.
CMS-Wave parameter files (*.std) have been reworked for SMS 11.1 and later versions and their associated versions of CMS.
 
== File Format ==
 
The new CMS-Wave parameters file (also referred to as an options or std file) begins with an identifier line.  This line includes the text CMS_WAVE_STD and a version number.
 
Each subsequent line on the file includes a value, followed by a comment defining the option.  The design was intended to replicate a card based ability to omit lines if the default value is to be used.
 
== Sample File ==
 
:{|style="background: #F9F9F9"
|CMS_WAVE_STD 1  !free format
|-
|1                !iprp
|-
|0                !icur
|-
|0                !ibreak
|-
|0                !irs
|-
|0                !kout
|-
|
|-
|
|-
|0                !ibnd
|-
|0                !iwet
|-
|0                !ibf
|-
|0                !iark
|-
|0                !iarkr
|-
|
|-
|0                !iwvbk
|-
|0                !nonlin
|-
|0                !igrav
|-
|0                !irunup
|-
|1                !imud
|-
|1                !iwnd
|-
|
|-
|
|-
|4.0000          !akap
|-
|0.025            !bf
|-
|0.5000          !ark
|-
|0.3000          !arkr
|-
|0                !isolve
|-
|0                !ixmdf
|-
|1                !iproc
|-
|0                !iview
|-
|0                !inest
|}
 
 
== Old File Format ==
 
The old parameter file always contain a single line of data defining the parameter options for the simulation. This line will include either 6, 10 or 15 values.  SMS writes all 15 values to the input files it creates.  The other formats are supported for backward compatibility.


If only the first six values are present, the other nine values will be assigned default values.  The default for the diffraction intensity factor is weak diffraction (akap = 1.0).  The default for the other eight parameters is 0 (defined in table below).  
If only the first six values are present, the other nine values will be assigned default values.  The default for the diffraction intensity factor is weak diffraction (akap = 1.0).  The default for the other eight parameters is 0 (defined in table below).  
Line 9: Line 86:
A sample file and table of the parameters is defined below.
A sample file and table of the parameters is defined below.


== File Format ==
<blockquote>
 
{|style="background: #F9F9F9"
{|
|iprp  icur  ibrk  irs  kout ibnd iwet ibf iark iarkr akap bf arc arkr iwvbk
|iprp  icur  ibrk  irs  kout ibnd iwet ibf iark iarkr akap bf arc arkr iwvbk
|-
|-
Line 20: Line 96:
|nestout rows (each row includes the I and J indices of selected nesting output cells  
|nestout rows (each row includes the I and J indices of selected nesting output cells  
|}
|}
</blockquote>


== Sample File ==
== Sample Old File ==


{|
<blockquote>
{|style="background: #F9F9F9"
|1  0  0  0  2 0 0 0 0 0 4.000000 0.005000 0.500000 0.300000 0
|1  0  0  0  2 0 0 0 0 0 4.000000 0.005000 0.500000 0.300000 0
|-
|-
Line 40: Line 118:
|29  10
|29  10
|}
|}
</blockquote>


== Parameter definitions ==
== Parameter definitions ==


{| border="1" cellpadding="2"
{| class="wikitable"
!Parameter
!Parameter
!Description
!Description
Line 57: Line 136:
|rowspan="3"| icur || 0, no current file read
|rowspan="3"| icur || 0, no current file read
|-
|-
| 1, read current file with a data set for each input spectra
| 1, read current file with a dataset for each input spectra
|-
|-
| 2, read single data set from current file for all spectra
| 2, read single data set from current file for all spectra
Line 77: Line 156:
| n, output spectra (.obs) and parameters (selhts.out) files will be created at n specified cells  
| n, output spectra (.obs) and parameters (selhts.out) files will be created at n specified cells  
|-
|-
|rowspan="3"| ibnd|| 0, simulation will use single spectra (.eng) file along offshore boundary
|rowspan="3"| ibnd|| 0, simulation will use single spectra (*.eng) file along offshore boundary
|-
|-
| 1, simulation will use nesting file (.nst) with linear interpolation of boundary input
| 1, simulation will use nesting file (.nst) with linear interpolation of boundary input
Line 121: Line 200:
| 3, for Chawla and Kirby wave breaking (2002)
| 3, for Chawla and Kirby wave breaking (2002)
|}
|}


==Related Topics==
==Related Topics==
* [[SMS:CMS-Wave_Files]]
* [[SMS:CMS-Wave Files|CMS-Wave Files]]
* [[SMS:File Formats|File Formats]]
* [[SMS:File Formats|File Formats]]


{{Template:SMSMain}}


[[Category:CMS-Wave]]
{{Template:Navbox SMS}}
 
[[Category:CMS-Wave|Control]]
[[Category:SMS File Formats|C]]

Latest revision as of 16:09, 17 November 2016

CMS-Wave parameter files (*.std) have been reworked for SMS 11.1 and later versions and their associated versions of CMS.

File Format

The new CMS-Wave parameters file (also referred to as an options or std file) begins with an identifier line. This line includes the text CMS_WAVE_STD and a version number.

Each subsequent line on the file includes a value, followed by a comment defining the option. The design was intended to replicate a card based ability to omit lines if the default value is to be used.

Sample File

CMS_WAVE_STD 1 !free format
1 !iprp
0 !icur
0 !ibreak
0 !irs
0 !kout
0 !ibnd
0 !iwet
0 !ibf
0 !iark
0 !iarkr
0 !iwvbk
0 !nonlin
0 !igrav
0 !irunup
1 !imud
1 !iwnd
4.0000 !akap
0.025 !bf
0.5000 !ark
0.3000 !arkr
0 !isolve
0 !ixmdf
1 !iproc
0 !iview
0 !inest


Old File Format

The old parameter file always contain a single line of data defining the parameter options for the simulation. This line will include either 6, 10 or 15 values. SMS writes all 15 values to the input files it creates. The other formats are supported for backward compatibility.

If only the first six values are present, the other nine values will be assigned default values. The default for the diffraction intensity factor is weak diffraction (akap = 1.0). The default for the other eight parameters is 0 (defined in table below).

If ten values exist in the file, bottom reflection is defaulted to off, forward reflection is defaulted to 50% and reverse reflection is defaulted to 30%.

After this single line, additional lines may be present to define the location of observation and nesting cells. CMS-Wave will save additional output (spectra) at these cells into the specified *.obs and *.nst files.

A sample file and table of the parameters is defined below.

iprp icur ibrk irs kout ibnd iwet ibf iark iarkr akap bf arc arkr iwvbk
kout rows (each row includes the I and J indices of a selected output cell
nestout
nestout rows (each row includes the I and J indices of selected nesting output cells

Sample Old File

1 0 0 0 2 0 0 0 0 0 4.000000 0.005000 0.500000 0.300000 0
10 15
23 41
4
28 7
27 8
28 9
29 10

Parameter definitions

Parameter Description
iprp -1, for fast-mode simulation
0, for wave generation and propagation (uses wind input and spectra)
1, for propagation only (neglect wind input)
2, for wind only (implies a zero energy spectra)
icur 0, no current file read
1, read current file with a dataset for each input spectra
2, read single data set from current file for all spectra
ibrk 0, no breaking file will be created
1, breaking file with be created with breaking index for each cell
2, breaking file with be created with energy dissipation flux saved for each cell
irs 0, no radiation stress gradient file will be created
1, radiation stress gradient file will be created
2, radiation stress gradient file and wave setup/maximum water level files will be created
kout 0, no selected output data files will be created
n, output spectra (.obs) and parameters (selhts.out) files will be created at n specified cells
ibnd 0, simulation will use single spectra (*.eng) file along offshore boundary
1, simulation will use nesting file (.nst) with linear interpolation of boundary input
2, simulation will use nesting file (.nst) with morphic interpolation of boundary input
iwet 0, normal wetting/drying (based on water level input)
1, no wetting/drying (water level input ignored)
ibf 0, no bottom friction
1, for bottom friction with constant Darcy-Weisbach type coefficient (bf)
2, for bottom friction with variable Darcy-Weisbach type coefficient (friction.dat)
3, for bottom friction with constant Manning coefficient (bf)
4, for bottom friction with variable Manning coefficient (friction.dat)
iark 0, no forward reflection
1, with forward reflection
iarkr 0, no backward reflection
1, with backward reflection
akap diffraction intensity factor (0 for no diffraction, 4 for strong diffraction)
bf constant bottom friction coefficient
ark constant forward reflection coefficient (0 for no reflection, 1 for maximum forward reflection)
arkr constant backward reflection coefficient (0 for no reflection, 1 for maximum backward reflection)
iwvbk 0, for extended Goda wave breaking (Sakai et al. 1989)
1, for extended Miche wave breaking (Battjes 1972; Mase et al. 2005b)
2, for Battjes and Janssen wave breaking (1978)
3, for Chawla and Kirby wave breaking (2002)

Related Topics