SMS:ADCIRC Coverages: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(25 intermediate revisions by 2 users not shown)
Line 1: Line 1:
The ADCIRC simulation can make use of different Map coverage types. The coverages specific to ADCIRC are described below.
The ADCIRC simulation can make use of different Map coverage types. The coverages specific to ADCIRC are described below.
==Boundary Condition==
==Boundary Conditions==
Much of ADCIRC's versatility as a model is due to the large number of different boundary types and boundary conditions available in the model. For detailed description of the ADCIRC boundary conditions, see the documentation provided by the ADCIRC development group at http://www.adcirc.org.
Much of ADCIRC's versatility as a model is due to the large number of different boundary types and boundary conditions available in the model. For detailed description of the ADCIRC boundary conditions, see the documentation provided by the ADCIRC development group at http://www.adcirc.org.


[[File:ADCIRC LinearBC.png|thumb|375 px|ADCIRC Boundary Conditions are assigned in the ''ADCIRC Linear BC'' dialog]]
[[File:ADCIRC LinearBC.png|thumb|375 px|ADCIRC Boundary Conditions are assigned in the ''ADCIRC Linear BC'' dialog]]
Boundary conditions are assigned by setting attributes to ''Feature Arcs'' representing boundary arcs in the domain used in the sifmulation.  
Boundary conditions are assigned by setting attributes to ''Feature Arcs'' representing boundary arcs in the domain used in the simulation.  


The ''ADCIRC Linear BC'' dialog defines the type of boundary conditions for each feature arc.  
The ''ADCIRC Linear BC'' dialog defines the type of boundary conditions for each feature arc.  


A feature arc/nodestring can be defined as mainland, island, normal flow, mainland barrier, island barrier, tidal constituents, etc.  
A feature arc/nodestring can be defined as mainland, island, normal flow, mainland barrier, island barrier, tidal constituents, etc. After assigning the type, [[SMS:ADCIRC_Coverages#Forcing_Options|flow forcing]] options can be added if necessary.


To set the boundary types, choose the '''Select Feature Arc''' tool from the Toolbox and double-click the desired arc to open the ''ADCIRC Arc/Nodestring Attributes'' dialog; then assign the desired boundary conditions to the arc.
To set the boundary types, choose the '''Select Feature Arc''' tool from the Toolbox and double-click the desired arc to open the ''ADCIRC Arc/Nodestring Attributes'' dialog; then assign the desired boundary conditions to the arc.
Line 23: Line 23:
* ''Zero Normal'' – This type of boundary forces flow through the specified nodestring reflective of flow at a fictitious point inside the domain.  This is referred to as a weakly reflective boundary in some numerical engines. The fictitious point lies on the inward directed normal to the boundary a distance equal to the distance from the boundary node to its farthest 'neighbor. This should ensure that the fictitious point does not fall into an element that contains the boundary node.  The velocity at the fictitious point is determined by interpolation.
* ''Zero Normal'' – This type of boundary forces flow through the specified nodestring reflective of flow at a fictitious point inside the domain.  This is referred to as a weakly reflective boundary in some numerical engines. The fictitious point lies on the inward directed normal to the boundary a distance equal to the distance from the boundary node to its farthest 'neighbor. This should ensure that the fictitious point does not fall into an element that contains the boundary node.  The velocity at the fictitious point is determined by interpolation.
* ''Flow & Radiation''
* ''Flow & Radiation''
* ''Normal Flow'' – This type of boundary represents a river inflow or open ocean boundary with a specified normal flow condition and free tangential slip. Discharges are specified either for harmonic discharge forcing or for time series discharge forcing.
* ''Normal Flow'' – This type of boundary represents a river inflow or open ocean boundary with a specified normal flow condition and free tangential slip. Discharges are specified either for harmonic discharge forcing or for time series discharge forcing.
* ''Mainland Barrier'' – This type of boundary represents a mainland boundary comprised of a dike or levee. Non-zero normal flow is computed using a supercritical, free surface weir formula if the barrier is overtopped. Zero normal flow is assumed if the barrier is not overtopped.
* ''Mainland Barrier'' – This type of boundary represents a mainland boundary comprised of a dike or levee. Non-zero normal flow is computed using a supercritical, free surface weir formula if the barrier is overtopped. Zero normal flow is assumed if the barrier is not overtopped.
Line 49: Line 48:
| Extract from Dataset|| Ocean
| Extract from Dataset|| Ocean
|}
|}
===Forcing Options===
[[File:ADCIRC-BC-ForcingOptions.png|thumb|400 px|Example of the ''Boundary Conditions Forcing Options'' dialog]]
Forcing attributes can be set by going to the Project Explorer and right-clicking on the ADCRIC boundary condition coverage then selecting '''Forcing Options''' to open the ''Boundary Conditions Forcing Options'' dialog. The dialog contains options for both tidal forcing and flow forcing.
*''Tidal forcing'' – This section contains options to turn tidal forcing on or off.
**''Use periodic water level forcing'' – When turn on, tidal forcing will be applied to the simulation. Perdiodic tidal constituents will be extracted from the simulation's applied tidal constituents. The tidal constituents are applied using a tidal component.
**''Select a fort.19 file containing the non-periodic water levels'' – This option appears when tidal forcing is turned off. The '''Select''' brings up a file browser where a fort.19 file can be selected.
*''Flow forcing'' – This section contains options to turn on flow forcing.
**''Use periodic flow forcing'' – When turned on, flow forcing will be added to the simulation. Flow forcing is designated in the table below:
***'''Add Row''' [[File:Row-add.svg|16px]] – Adds a row to the table.
***'''Delete Row''' [[File:Row-delete.svg|16 px]] – Removes the selected row in the table.
***''Name'' – Enter the name of the periodic flow forcing constituent.
**''Select a fort.20 file containing the non-periodic flow hydrographs'' – This option appears when flow forcing is turned off. The '''Select''' brings up a file browser where a fort.20 file can be selected.
**''Flow data relative to hot start time'' – If turned on, the flow data will relative to the hot start time.
<!--
===Tidal Attributes===
===Tidal Attributes===
The ''ADCIRC Tidal Attributes'' dialog contains two tabs: [[#tidal forcing|''Tidal forcing'']] and [[#tidal potential input|''Tidal potential input'']].
[[File:Adcirc-tidal-att.png|thumb|400 px|Example of the ''ADCIRC Tidal Attributes'' dialog]]
Tidal attributes can be set by going to the Project Explorer and right-clicking on the ADCRIC boundary condition coverage then selecting '''Tidal Attributes''' to open the ''ADCIRC Tidal Attributes'' dialog. This dialog contains two tabs: [[#tidal forcing|''Tidal forcing'']] and [[#tidal potential input|''Tidal potential input'']].


====''Tidal forcing'' tab====
====''Tidal forcing'' tab====
{{anchor|tidal forcing}}
{{anchor|tidal forcing}}
*''Tidal source'' (NBFR) drop-down &ndash; Number of periodic forcing frequencies on elevation specified boundaries.  
''Tidal source'' (NBFR) drop-down &ndash; Number of periodic forcing frequencies on elevation specified boundaries.  
**"Tidal constituents"  
*"Tidal constituents"  
**"Not used"
*"Not used" &ndash; When tidal forcing is turned off, the elevation dataset input is needed to provide elevation forcing for the model. This dataset is typically a transient scatter with a limited number of points around the outside of the ocean boundary. It is not recommended to use a mesh dataset.
*''Tidal database constituents'' section &ndash; There are two columns, and a number of options and buttons:
*''Tidal database constituents'' section &ndash; There are two columns, and a number of options and buttons:
**''Source'' &ndash; Contains a drop-down with the following options:
*''Source'' &ndash; Contains a drop-down with the following options:
***"ADCIRC &ndash; NW Atlantic"
**"ADCIRC &ndash; NW Atlantic"
***"ADCIRC &ndash; NE Pacific"
**"ADCIRC &ndash; NE Pacific"
***"LeProvost"
**"LeProvost"
**''Constituent'' &ndash; Contains a drop-down with the following options:
*''Constituent'' drop-down &ndash; Has the following options:
***"M2"
{{hidden
***"S2"
|List of Constituent Options
***"N2"
|Constituents
***"K1"
*"M2"
***"M4"
*"S2"
***"O1"
*"N2"
***"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"K1"
***"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"M4"
***"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"O1"
***"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
*"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***"Q1"
*"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
***"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"Q1"
***"K2"
*"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
**Below the edit fields are a number of options:
*"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
*"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*"K2"
***'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
|headerstyle=background:#D9E2EA
***'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
|style=text-align:left; margin-left:2em; width:50%;
***'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
}}
***'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
*Below the edit fields are a number of options:
*''User specified constituents'' section &ndash; There are seven columns:
**''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
**''Amplitude'' &ndash; Clicking '''(none selected)''' brings up the ''Select Database'' dialog.
**'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
**''Phase''' &ndash; Clicking '''(none selected)''' brings up the ''Select Database'' dialog.
**'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
**''Constituent'' drop-down &ndash; Has the following options:
**'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
***"M2"
**'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
***"S2"
**'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
***"N2"
 
***"K1"
''User specified constituents'' section &ndash; There are seven columns:
***"M4"
*''Amplitude'' &ndash; Clicking '''(none selected)''' brings up the ''Select Database'' dialog.
***"O1"
*''Phase''' &ndash; Clicking '''(none selected)''' brings up the ''Select Database'' dialog.
***"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*''Constituent'' drop-down &ndash; Has the following options:
***"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
{{hidden
***"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
|List of Constituent Options
***"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
|Constituents
***"Q1"
*"M2"
***"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"S2"
***"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"N2"
***"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"K1"
***"K2"
*"M4"
***"User specified" &ndash; Allows the remaining four columns in this section to be edited.
*"O1"
**''Name'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The name of the constituent.
*"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
**''Frequency'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The frequency of the constituent.
*"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
**''Nodal Factor'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The nodal factor for the constituent.
*"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
**''Equilibrium Argument'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The equilibrium argument for the constituent.
*"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
**Below the edit fields are a number of options:
*"Q1"
***''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
*"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
*"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
***'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*"K2"
***'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*"User specified" &ndash; Allows the remaining four columns in this section to be edited.
***'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
|headerstyle=background:#D9E2EA
|style=text-align:left; margin-left:2em; width:50%;
}}
*''Name'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The name of the constituent.
*''Frequency'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The frequency of the constituent.
*''Nodal Factor'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The nodal factor for the constituent.
*''Equilibrium Argument'' &ndash; Only editable if "User specified" selected from the drop-down in the ''Constituent'' column. The equilibrium argument for the constituent.
*Below the edit fields are a number of options:
**''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
**'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
**'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
**'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
**'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
**'''Delete''' &ndash; Deletes the selected row in the spreadsheet.


====''Tidal potential input'' tab====
====''Tidal potential input'' tab====
{{anchor|tidal potential input|tidal potential}}
{{anchor|tidal potential input|tidal potential}}
*''Tidal potential'' (NTIP) drop-down &ndash; parameter controlling whether tidal potential and self attraction/load tide forcings will be used to force ADCIRC.
''Tidal potential'' (NTIP) drop-down &ndash; Parameter controlling whether tidal potential and self attraction/load tide forcings will be used to force ADCIRC.
**"Not used" &ndash; Tidal potential and self attraction/load tide forcings are not used.
*"Not used" &ndash; Tidal potential and self attraction/load tide forcings are not used.
**"Used" &ndash; Tidal potential forcing is used. Makes the ''Tidal potential constituents'' section visible.
*"Used" &ndash; Tidal potential forcing is used. Makes the ''Tidal potential constituents'' section visible.
***"Tidal potential constituents" section &ndash; There are eight columns, and a number of options and buttons:
 
****''Source'' &ndash; Contains a drop-down with the following options:
"Tidal potential constituents" section &ndash; There are eight columns, and a number of options and buttons:
*****"ADCIRC &ndash; NW Atlantic"
*''Source'' &ndash; Contains a drop-down with the following options:
*****"ADCIRC &ndash; NE Pacific"
**"ADCIRC &ndash; NW Atlantic"
*****"LeProvost"
**"ADCIRC &ndash; NE Pacific"
*****"User defined"
**"LeProvost"
****''Constituent'' &ndash; Contains a drop-down with the following options:
**"User defined"
*****"M2"
*''Constituent'' drop-down &ndash; Has the following options:
*****"S2"
{{hidden
*****"N2"
|List of Constituent Options
*****"K1"
|Constituents
*****"M4"
*"M2"
*****"O1"
*"S2"
*****"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"N2"
*****"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"K1"
*****"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"M4"
*****"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
*"O1"
*****"Q1"
*"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
*****"K2"
*"Q1"
****''Constituent Name'' &ndash;  
*"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Amplitude (TPK)'' &ndash; Tidal potential amplitude.
*"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Frequency (AMIGT)''
*"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Earth Tide Reduction Factor (ETRF)'' &ndash; Earth tide potential reduction factor (generally taken to be "0.690" for all constituents, but&mdash;for more precise calculations&mdash;can take on slightly different values.
*"K2"
****''Nodal Factor (FFT)'' &ndash; Nodal factor argument in degrees.
|headerstyle=background:#D9E2EA
****''Equilibrium (FACET)'' &ndash; Equilibrium argument in degrees.
|style=text-align:left; margin-left:2em; width:50%;
****Below the edit fields are a number of options:
}}
*****''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
*''Constituent Name'' &ndash; An alphanumeric descriptor of the constituent.
*****'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*''Amplitude (TPK)'' &ndash; Tidal potential amplitude.
*****'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
*''Frequency (AMIGT)''
*****'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*''Earth Tide Reduction Factor (ETRF)'' &ndash; Earth tide potential reduction factor (generally taken to be "0.690" for all constituents, but&mdash;for more precise calculations&mdash;can take on slightly different values.
*****'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*''Nodal Factor (FFT)'' &ndash; Nodal factor argument in degrees.
*****'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
*''Equilibrium (FACET)'' &ndash; Equilibrium argument in degrees.
**"Self attraction/earth load tide forcing file" &ndash; Makes the ''Tidal potential constituents'' section visible.
*Below the edit fields are a number of options:
***"Tidal potential constituents" section &ndash; There are eight columns, and a number of options and buttons:
**''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
****''Source'' &ndash; Contains a drop-down with the following options:
**'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*****"ADCIRC &ndash; NW Atlantic"
**'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
*****"ADCIRC &ndash; NE Pacific"
**'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*****"LeProvost"
**'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
****''Constituent'' &ndash; Contains a drop-down with the following options:
**'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
*****"M2"
*"Self attraction/earth load tide forcing file" &ndash; Makes the ''Tidal potential constituents'' section visible.
*****"S2"
 
*****"N2"
"Tidal potential constituents" section &ndash; There are eight columns, and a number of options and buttons:
*****"K1"
*''Source'' &ndash; Contains a drop-down with the following options:
*****"M4"
**"ADCIRC &ndash; NW Atlantic"
*****"O1"
**"ADCIRC &ndash; NE Pacific"
*****"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
**"LeProvost"
*****"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*''Constituent'' drop-down &ndash; Has the following options:
*****"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
{{hidden
*****"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
|List of Constituent Options
*****"Q1"
|Constituents
*****"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"M2"
*****"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"S2"
*****"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*"N2"
*****"K2"
*"K1"
****''Constituent Name'' &ndash; Not editable here.
*"M4"
****''Amplitude (TPK)'' &ndash; Not editable here.
*"O1"
****''Frequency (AMIGT)'' &ndash; Not editable here.
*"NU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Earth Tide Reduction Factor (ETRF)'' &ndash; Not editable here.
*"MU2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Nodal Factor (FFT)'' &ndash; Not editable here.
*"2N2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
****''Equilibrium (FACET)'' &ndash; Not editable here.
*"M6" &ndash; Not available when "LeProvost" is selected in the ''Source'' column.
****Below the edit fields are a number of options:
*"Q1"
*****''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
*"T2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*"P1" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
*"L2" &ndash; Only available when "LeProvost" is selected in the ''Source'' column.
*****'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
*"K2"
*****'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
|headerstyle=background:#D9E2EA
*****'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
|style=text-align:left; margin-left:2em; width:50%;
}}
*''Constituent Name'' &ndash; Not editable here.
*''Amplitude (TPK)'' &ndash; Not editable here.
*''Frequency (AMIGT)'' &ndash; Not editable here.
*''Earth Tide Reduction Factor (ETRF)'' &ndash; Not editable here.
*''Nodal Factor (FFT)'' &ndash; Not editable here.
*''Equilibrium (FACET)'' &ndash; Not editable here.
*Below the edit fields are a number of options:
**''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
**'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
**'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
**'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
**'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.  
**'''Delete''' &ndash; Deletes the selected row in the spreadsheet.


===Flow Attributes===
===Flow Attributes===
[[File:Adcirc-flow-att.png|thumb|400 px|Example of the ''ADCIRC Flow Attributes'' dialog]]
Flow attributes can be set by going to the Project Explorer and right-clicking on the ADCRIC boundary condition coverage, then selecting '''Flow Attributes''' to open the ''ADCIRC Flow Attributes'' dialog.
The first section has a single option: ''Use periodic flow forcing'' (NFFR). This is the number of frequencies in the specified normal flow external boundary condition. It is either on or off. When turned on, a ''Periodic flow forcing'' spreadsheet appears with the following columns:
*''Flow Amplitude'' &ndash; Clicking on the '''(none selected)''' button brings up the Select Dataset dialog where a dataset can be selected.
*''Flow Phase'' &ndash; Clicking on the '''(none selected)''' button brings up the Select Dataset dialog where a dataset can be selected.
*''Name'' &ndash; Enter an alphanumeric descriptor of the forcing frequency.
*''Frequency'' &ndash; A user-defined frequency of occurrence for the constituent. Must be an integer.
*''Nodal Factor'' &ndash; A user-defined nodal factor for the constituent. Must be an integer.
*''Equilibrium Argument'' &ndash; A user-defined equilibrium argument for the constituent. Must be degrees expressed as a decimal numeric value.
At the bottom of the spreadsheet are the following options and buttons:
*''Copy/Paste Mode'' &ndash; Allows data from an external spreadsheet to be pasted into the spreadsheet in this dialog.
*'''Import...''' &ndash; Imports tab-separated values (TSV, TXT) or comma-separated values (CSV, TXT) into the spreadsheet.
*'''Export...''' &ndash; Exports the spreadsheet data as a tab-separated value (TSV, TXT) or comma-separated value (CSV, TXT) file.
*'''Insert Above''' &ndash; Inserts a row above the selected row in the spreadsheet. If no rows exist, a single new row will be added.
*'''Insert Below''' &ndash;  Inserts a row below the selected row in the spreadsheet. If no rows exist, a single new row will be added.
*'''Delete''' &ndash; Deletes the selected row in the spreadsheet.
If ''Use periodic flow forcing'' is turned off, a ''Non-periodic flow forcing'' section is visible. It has the following options:
*''Time increment in seconds'' (FTIMINC) &ndash; time increment (secs) between consecutive sets of normal flow boundary condition values.
*''Offset by hot start time'' &ndash; Can be turned on or left off (default).
*''Normal flow'' &ndash; Click the '''Select''' button to bring up the ''Select Dataset'' dialog where a dataset can be selected.
-->


== Recording Stations ==
== Recording Stations ==
[[File:ADCIRC RecordingStations.png|thumb|300 px|ADCIRC ''Recording Stations'' dialog]]
[[File:ADCIRC RecordingStations.png|thumb|325 px|ADCIRC ''Recording Stations'' dialog]]
The SMS interface allows creating recording stations at specified nodal locations.  At these locations, the ADCIRC model will output specified quantities at a user specified time interface.  This allows for comparison of time series with observed buoy data.  For example, the global output interval may be 30 minutes or 1 hour, while the recording station output could be at a higher frequency such as 6 minutes.
The SMS interface allows creating recording stations at specified nodal locations.  At these locations, the ADCIRC model will output specified quantities at a user specified time interface.  This allows for comparison of time series with observed buoy data.  For example, the global output interval may be 30 minutes or 1 hour, while the recording station output could be at a higher frequency such as 6 minutes.


Line 208: Line 274:


==Pipes==
==Pipes==
[[File:ADCIRC pipe.png|thumb|325 px|Example of the ''ADCIRC Pipe'' dialog]]
Points created on this coverage can be assigned as cross barrier pipes. Right-clicking on a point and selecting the '''Assign Pipe''' command will open the ''ADCIRC Pipe'' dialog. The dialog has the following options:
Points created on this coverage can be assigned as cross barrier pipes. Right-clicking on a point and selecting the '''Assign Pipe''' command will open the ''ADCIRC Pipe'' dialog. The dialog has the following options:
* ''Height'' &ndash; Cross barrier pipe height in internal barrier with cross barrier pipes.
* ''Height'' &ndash; Cross barrier pipe height in internal barrier with cross barrier pipes.
Line 214: Line 281:


==Wind Stations==  
==Wind Stations==  
Right-clicking on a point and selecting the '''Assign Wind Station''' command will open the ''ADCIRC Wind Stations'' dialog. The dialog has the following options:
*Wind velocity in X
*Wind velocity in y
*Pressure




Line 220: Line 291:
[[Category:SMS Map]]
[[Category:SMS Map]]
[[Category:SMS Coverages]]
[[Category:SMS Coverages]]
[[Category:ADCIRC Dialogs|cov]]

Latest revision as of 15:48, 28 March 2023

The ADCIRC simulation can make use of different Map coverage types. The coverages specific to ADCIRC are described below.

Boundary Conditions

Much of ADCIRC's versatility as a model is due to the large number of different boundary types and boundary conditions available in the model. For detailed description of the ADCIRC boundary conditions, see the documentation provided by the ADCIRC development group at http://www.adcirc.org.

ADCIRC Boundary Conditions are assigned in the ADCIRC Linear BC dialog

Boundary conditions are assigned by setting attributes to Feature Arcs representing boundary arcs in the domain used in the simulation.

The ADCIRC Linear BC dialog defines the type of boundary conditions for each feature arc.

A feature arc/nodestring can be defined as mainland, island, normal flow, mainland barrier, island barrier, tidal constituents, etc. After assigning the type, flow forcing options can be added if necessary.

To set the boundary types, choose the Select Feature Arc tool from the Toolbox and double-click the desired arc to open the ADCIRC Arc/Nodestring Attributes dialog; then assign the desired boundary conditions to the arc.

ADCIRC Boundary Types

Boundary types are assigned to feature arcs in the conceptual mode or nodestrings on the ADCIRC mesh. Correct boundary type assignments are very important to run a successful ADCIRC project. The following boundary types are available in SMS for ADCIRC:

  • Unassigned – Default, no boundary condition assigned
  • Ocean – This type of boundary represents an open interface for flow with a specified water surface elevation. Elevations are specified either as tidal constituents for harmonic forcing or as time series or water level.
  • Mainland – This type of boundary represents a mainland boundary with no normal flow condition and free tangential slip.
  • Island – This type of boundary represents an island boundary with no normal flow condition and free tangential slip. This can be selected for a closed feature arc.
  • River Inflow
  • Levee Outflow
  • Radiation – This type of boundary represents an open boundary where waves are allowed to propagate freely out of the domain.
  • Zero Normal – This type of boundary forces flow through the specified nodestring reflective of flow at a fictitious point inside the domain. This is referred to as a weakly reflective boundary in some numerical engines. The fictitious point lies on the inward directed normal to the boundary a distance equal to the distance from the boundary node to its farthest 'neighbor. This should ensure that the fictitious point does not fall into an element that contains the boundary node. The velocity at the fictitious point is determined by interpolation.
  • Flow & Radiation
  • Normal Flow – This type of boundary represents a river inflow or open ocean boundary with a specified normal flow condition and free tangential slip. Discharges are specified either for harmonic discharge forcing or for time series discharge forcing.
  • Mainland Barrier – This type of boundary represents a mainland boundary comprised of a dike or levee. Non-zero normal flow is computed using a supercritical, free surface weir formula if the barrier is overtopped. Zero normal flow is assumed if the barrier is not overtopped.
  • Island Barrier – This type of boundary represents a dike or levee that lies inside the computational domain. Non-zero normal flow is compute using either subcritical or supercritical, free surface weir formula (based on the water level on both sides of the barrier) if the barrier is overtopped. Zero normal flow is assumed if the barrier is not overtopped. This boundary condition requires two nodestrings with an equal number of nodes. See ADCIRC Weirs and Island Barriers for more information.
  • Weir – This type of boundary is similar to an Island Barrier with the addition of cross barrier flow. Cross barrier flow simulates flow through the barrier simulating pipes or culverts from one side to the other. Flow rate and direction are based on barrier height, surface water elevation on both sides of the barrier, barrier coefficient and the appropriate barrier flow formula. In addition cross barrier pipe flow rate and direction are based on pipe crown height, surface water elevation on both sides of the barrier, pipe friction coefficient, pipe diameter and the appropriate pipe flow formula. This boundary condition requires two nodestrings with the same number of nodes. See ADCIRC Weirs and Island Barriers for more information.

ADCIRC Boundary Conditions Options

Depending upon the specified boundary type, the following boundary conditions are available:

Boundary Condition Boundary Type
Essential w/
Tangential Slip
Mainland
Island
Normal Flow
Mainland Barrier
Essential w/o
Tangential Slip
Mainland
Island
Normal Flow
Mainland Barrier
Natural (w/
Tangential Slip)
Mainland
Island
Normal Flow
Mainland Barrier
Tidal Constituents Ocean
Curve Ocean
Extract from Dataset Ocean

Forcing Options

Example of the Boundary Conditions Forcing Options dialog

Forcing attributes can be set by going to the Project Explorer and right-clicking on the ADCRIC boundary condition coverage then selecting Forcing Options to open the Boundary Conditions Forcing Options dialog. The dialog contains options for both tidal forcing and flow forcing.

  • Tidal forcing – This section contains options to turn tidal forcing on or off.
    • Use periodic water level forcing – When turn on, tidal forcing will be applied to the simulation. Perdiodic tidal constituents will be extracted from the simulation's applied tidal constituents. The tidal constituents are applied using a tidal component.
    • Select a fort.19 file containing the non-periodic water levels – This option appears when tidal forcing is turned off. The Select brings up a file browser where a fort.19 file can be selected.
  • Flow forcing – This section contains options to turn on flow forcing.
    • Use periodic flow forcing – When turned on, flow forcing will be added to the simulation. Flow forcing is designated in the table below:
      • Add Row Row-add.svg – Adds a row to the table.
      • Delete Row Row-delete.svg – Removes the selected row in the table.
      • Name – Enter the name of the periodic flow forcing constituent.
    • Select a fort.20 file containing the non-periodic flow hydrographs – This option appears when flow forcing is turned off. The Select brings up a file browser where a fort.20 file can be selected.
    • Flow data relative to hot start time – If turned on, the flow data will relative to the hot start time.

Recording Stations

ADCIRC Recording Stations dialog

The SMS interface allows creating recording stations at specified nodal locations. At these locations, the ADCIRC model will output specified quantities at a user specified time interface. This allows for comparison of time series with observed buoy data. For example, the global output interval may be 30 minutes or 1 hour, while the recording station output could be at a higher frequency such as 6 minutes.

The following recording stations can be assigned to an ADCIRC mesh node:

2D station options include:

  • Elevation – ADCIRC will output a times series of computed water surface elevation at this location.
  • Velocity – ADCIRC will output a times series of computed velocity magnitude at this location.
  • Concentration – ADCIRC will output a times series of constituent concentration at this location.
  • Meteorological – ADCIRC will output a times series of wind and pressure variables at this location.

Pipes

Example of the ADCIRC Pipe dialog

Points created on this coverage can be assigned as cross barrier pipes. Right-clicking on a point and selecting the Assign Pipe command will open the ADCIRC Pipe dialog. The dialog has the following options:

  • Height – Cross barrier pipe height in internal barrier with cross barrier pipes.
  • Coefficient – The bulk pipe friction factor for the internal barrier boundary cross barrier pipe boundary node pair. This bulk friction factor is defined as: PIPECOEFR = fL/D where f is the classical pipe friction coefficient, L is the length of the pipe through the barrier (in consistent units) and D is the diameter of the cross barrier pipe (in consistent units).
  • Diameter – Cross barrier pipe diameter in internal barrier with cross barrier pipes (diameter in units consistent with the mesh).

Wind Stations

Right-clicking on a point and selecting the Assign Wind Station command will open the ADCIRC Wind Stations dialog. The dialog has the following options:

  • Wind velocity in X
  • Wind velocity in y
  • Pressure