|
|
| Line 17: |
Line 17: |
|
| |
|
| = CMS-Wave Model Control File = | | = CMS-Wave Model Control File = |
| The *.std has a maximum of 24 parameters - the first 15 parameters are more the basic ones as | | The CMS-Wave Options File (*.std) can have one of 3 input formats: |
| described in the CMS-Wave Technical Report (CHL-TR-08-13) while the remaining 9 parameters
| | # [[MP_NoCards|No cards - order of values on one line is very important.]] |
| are relatively new for advanced CMS-Wave features.
| | # [[MP_CardFormat1|Card-based - [value] [!card name]]] |
| | | # [[MP_CardFormat2|Card-based - [card name] [value(s)]]] |
| '''Table 1. CMS-Wave parameters in STD file'''
| |
| {| border="1"
| |
| ! Number !! Variable !! Argument Type !! Options/Range !! Description
| |
| |-
| |
| | 1 || iprp || INTEGER || 0 - waves and wind input in *.eng <br/> 1 - waves only, neglect wind input in *.eng <br/> -1 - fast mode <br/> 2 - forced grid internal rotation <br/> 3 - without lateral energy flux || Wave propagation mode.
| |
| |-
| |
| | 2 || icur || INTEGER || 0 - no current input <br /> 1 - with current input *.cur <br/> 2 -with *.cur, use only the 1st set current data || Current interaction
| |
| |-
| |
| | 3 || ibk || INTEGER || 0 - no wave breaking output <br/> 1 - output breaking indices <br/> 2 - output energy dissipation rate || Wave breaking output option
| |
| |-
| |
| | 4 || irs || INTEGER || 0 - no wave radiation stress calculation or output <br/> 1 - calculate and output radiation stresses <br/> 2 - calculate and output radiation stresses plus setup/max-water-level|| Radiation stress and runup options. | |
| |-
| |
| | 5 || kout || INTEGER || >= 0 || Number of special wave output location, output spectrum in *.obs
| |
| and parameters in selhts.out
| |
| |- | |
| | 6 || ibnd || INTEGER ||0 - no input a parent spectrum *.nst <br/> 1 - read *.nst, averaging input spectrum <br/> 2 - read *.nst, spatially variable spectrum input || Nesting option.
| |
| |-
| |
| | 7 || iwet|| INTEGER || 0 - allow wet/dry, default <br/> 1 - without wet/dry <br/> -1 allow wet/dry, output swell and local sea files <br/> -2 - output combined steering wav files <br/> -3 - output swell, local sea, and combined wav files || Wetting and drying options.
| |
| |-
| |
| | 8 || ibf || INTEGER || 0 - no bottom friction calc <br/> 1 - constant Darcy-Weisbach coef, c_f <br/> 2 -read variable c_f file, *.fric <br/> 3 - constant Mannings n <br/> 4 - read variable Mannings n file, *.fric || Bottom friction option.
| |
| |-
| |
| | 9 || iark || INTEGER || 0 - without forward reflection <br/> 1 - with forward reflection || Forward reflection option.
| |
| |- | |
| | 10 || iarkr || INTEGER || 0 - without backward reflection, <br>1 - with backward reflection || backward reflection option.
| |
| |-
| |
| | 11 || akap || REAL || 0.0<=akap<=4.0 || Diffraction intensity coefficient.
| |
| |-
| |
| | 12 || bf || REAL || >=0 || constant bottom friction coef c_f or n
| |
| (typical value is 0.005 for c_f and 0.025 for Mannings n)
| |
| |-
| |
| | 13 || ark || REAL || 0.0<=ark<=1.0 || Constant forward reflection coef, global specification <br>(0 for zero reflection, 1 for full reflection).
| |
| |-
| |
| | 14 || arkr || REAL || 0.0<=arkr<=1.0 || Constant backward reflection coef, global specification <br>(0 for zero reflection, 1 for full reflection)
| |
| |-
| |
| | 15 || iwvbk || INTEGER || 0 - Goda-extended <br/> 1 - Miche-extended <br/> 2 - Battjes and Janssen <br/> 3 - Chawla and Kirby) || Option for the primary wave breaking formula.
| |
| |-
| |
| | 16 || nonln || INTEGER || 0 - none, default <br/> 1 - nonlinear wave-wave interaction || Nonlinear wave-wave interaction
| |
| |-
| |
| | 17 || igrav || INTEGER || 0 - none, default <br/> 1 - infra-gravity wave enter inlets || Infragravity waves option.
| |
| |-
| |
| | 18 || irunup || INTEGER || 0 - none, default <br/> 1 - automatic, runup relative to absolute datum <br/> 2 - automatic, runup relative to updated MWL || Runup option.
| |
| |-
| |
| | 19 || imud || INTEGER || 0 - Mud dissipation on, default <br/> 1 - none || Mud dissipation option. The kinematic viscosity is specified in mud.dat in units of m<sup>2</sup>/sec
| |
| |-
| |
| | 20 || iwnd || INTEGER || 0 - Spatially variable wind on, default <br/> 1 - None || Spatially variable wind field option. The winds are specified in wind.dat in units of m/s <br>and in the reference frame of the CMS-Wave grid
| |
| |-
| |
| | 21 || isolv || INTEGER || 0 - GSR solver, default <br/> 1 - ADI || Matrix solver for CMS-Wave.
| |
| |-
| |
| | 22 || ixmdf || INTEGER || 0 - output ascii, default <br/> 1 - output xmdf <br/> 2 - input & output xmdf || XMDF input and output options.
| |
| |-
| |
| | 23 || iproc || INTEGER || >=0 || Number of threads for parallel computing. Optimum number is approximately <br>equal to the total row number divided by 300. Only for isolv = 0.
| |
| |-
| |
| | 24 || iview || INTEGER || 0 - half-plane, default <br/> 1 - full-plane || Half-plane/full-plane option. users can provide additional input wave <br>spectrum file wave.spc (same format as the *.eng) along the opposite side <br>
| |
| boundary an imaginary origin for wave.spc at the opposite corner; users <br>can rotate the CMS-Wave grid by 180 deg in SMS to generate this wave.spc
| |
| | |
| |}
| |
| | |
| | |
| Among these 24 parameters in *.std, the first 6 parameters are always required in CMS-Wave and
| |
| the remaining ones starting any parameter after the 6<sup>th</sup> will be assigned to the
| |
| default values if not provided in the *.std. The more specific use and options associated with
| |
| each of these 1<sup>st</sup> to 24<sup>th</sup> parameters are given below.
| |
| * Full-plane – In this mode, CMS-Wave performs two half-plane runs in the same grid. The first
| |
| run is in the half-plane with the principle wave direction toward the shore. The second run is in
| |
| the seaward half-plane. Upon the completion of the second run, two half-plane results are
| |
| combined to one full-plane solution. Because the run time for the full-plane is approximately
| |
| twice of the regular half-plane, users shall consider the full-plane mode only if the full-plane
| |
| features like wave generation and propagation in a bay or around an island. An example is to run
| |
| the Shark River wave case, 2009.sim, in the full plane (modify 2009.std).
| |
