SMS:CMS-Wave Structure File: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(12 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Hide in print|{{CMS-Wave Menubox}}
CMS-Wave structure files (*.struct) contain a line defining the number of cells that should be treated as structures in the model simulation, and then a list of these cells with special features assigned to them.  These are specified in the SMS interface by selecting the cell and assigning cell attributes (CMS-Wave menu or right click on selected cell). These cells can represent:
}}
 
CMS-Wave structure files contain a line defining the number of cells that should be treated as structures in the model simulation, and then a list of these cells with special features assigned to them.  These are specified in the SMS interface by selecting the cell and assigning cell attributes (CMS-Wave menu or right click on selected cell). These cells can represent:


* a floating breakwater
* a floating breakwater
Line 14: Line 11:


== File Format ==
== File Format ==
 
<blockquote>
{|
{|style = "background: #F9F9F9"
|number of structure cells
|number of structure cells
|-
|-
|one row for each structure cell (each row includes the I and J indices of a selected output cell, the structure type and the modifier value
|one row for each structure cell (each row includes the I and J indices of a selected output cell, the structure type and the modifier value
|}
|}</blockquote>


== Sample File ==
== Sample File ==
 
<blockquote>
{|
{|style="background: #F9F9F9"
|4    /* there are 5 structure cells in this sample file */
|4    /* there are 5 structure cells in this sample file */
|-
|-
Line 33: Line 30:
|-
|-
|16  22  4  3    /* model will treat cell (16,22) as a breakwater/seawall/mound with an elevation of 3 meters above sealevel */
|16  22  4  3    /* model will treat cell (16,22) as a breakwater/seawall/mound with an elevation of 3 meters above sealevel */
|}
|}</blockquote>


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


{| class="wikitable"
{| class="wikitable"
!width="50"|kstruc
!width="30"|kstruc
!width="200"|Description
!width="200"|Description
!width="400"|Modifier value (cstruc)
!width="400"|Modifier value (cstruc)
|-
|-
| 1 || add alternative depth without modifying input depth file
|width="30"| 1 || add alternative depth without modifying input depth file
| specify the new structure depth (assumed land if no depth specified)
| specify the new structure depth (assumed land if no depth specified)
|-
|-
| 2 || for calculation of wave runup and overwash on beach face or structure and adjacent land
|width="30"| 2 || for calculation of wave runup and overwash on beach face or structure and adjacent land
| specify the elevation above mean water level for the cell.  Input depth used in no value specified.  Has no impact if elevation < 0)
| specify the elevation above mean water level for the cell.  Input depth used in no value specified.  Has no impact if elevation < 0)
|-
|-
| 3 || for calculation of transmitted wave under a floating breakwater
|width="30"| 3 || for calculation of transmitted wave under a floating breakwater
| specify the floating breakwater draft (skipped if not provided or value is < 0.05 m)
| specify the floating breakwater draft (skipped if not provided or value is < 0.05 m)
|-
|-
| 4 || for a vertical wall breakwater
|width="30"| 4 || for a vertical wall breakwater
| rowspan="2"| specify breakwater/structure elevation (input depth value used in not provided; immersed if value < 0.0)
| rowspan="2"| specify breakwater/structure elevation (input depth value used in not provided; immersed if value < 0.0)
|-
|-
| 5 || for a composite or rubble-mound breakwater
|width="30"| 5 || for a composite or rubble-mound breakwater
|}
|}


==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]]


Line 64: Line 61:
{{Template:Navbox SMS}}
{{Template:Navbox SMS}}


[[Category:CMS-Wave]]
[[Category:CMS-Wave|S]]
[[Category:SMS File Formats|C]]

Latest revision as of 16:40, 22 September 2017

CMS-Wave structure files (*.struct) contain a line defining the number of cells that should be treated as structures in the model simulation, and then a list of these cells with special features assigned to them. These are specified in the SMS interface by selecting the cell and assigning cell attributes (CMS-Wave menu or right click on selected cell). These cells can represent:

  • a floating breakwater
  • a bottom mound breakwater
  • a beach segment and the land adjacent to it
  • jetties or seawalls
  • underwater features such as reefs or submerged structures

A trench, submerged mound or structure can be added to the bed as features without modifying the input depth file. Each feature cell is described by four parameters in a line in the structure file. A sample file and table of the parameters is defined below.

File Format

number of structure cells
one row for each structure cell (each row includes the I and J indices of a selected output cell, the structure type and the modifier value

Sample File

4 /* there are 5 structure cells in this sample file */
10 15 1 3 /* cell (10,15) will be modified to have a depth of 3 meters */
23 41 2 0.5 /* model will calculate runup and overwash at cell (23,41). It will be assigned an elevation 0f 0.5 meters above sea level */
15 7 3 1.5 /* model will treat cell (15,7) as a floating breakwater with a draft of 1.5 meters to calculate transmission of waves under the structure */
16 22 4 3 /* model will treat cell (16,22) as a breakwater/seawall/mound with an elevation of 3 meters above sealevel */

Parameter definitions

kstruc Description Modifier value (cstruc)
1 add alternative depth without modifying input depth file specify the new structure depth (assumed land if no depth specified)
2 for calculation of wave runup and overwash on beach face or structure and adjacent land specify the elevation above mean water level for the cell. Input depth used in no value specified. Has no impact if elevation < 0)
3 for calculation of transmitted wave under a floating breakwater specify the floating breakwater draft (skipped if not provided or value is < 0.05 m)
4 for a vertical wall breakwater specify breakwater/structure elevation (input depth value used in not provided; immersed if value < 0.0)
5 for a composite or rubble-mound breakwater

Related Topics