SMS:ADCIRC Interface Changes for SMS 13.1: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(13 intermediate revisions by the same user not shown)
Line 1: Line 1:
__NOINDEX__
{{Version SMS 13.1}}
With the release of SMS 13.1, several changes were made to how ADCIRC interfaces with SMS. Changes to the user interface for ADCIRC include the following:
With the release of SMS 13.1, several changes were made to how ADCIRC interfaces with SMS. Changes to the user interface for ADCIRC include the following:
* Depth bathymetry datasets have been eliminated. Instead of a depth dataset, an elevation dataset is used. The elevation dataset uses negative Z-values to represent depth.
* Depth bathymetry datasets have been eliminated. Instead of a depth dataset, an elevation dataset is used. The elevation dataset uses negative Z-values to represent depth.
* Boundary conditions are no longer assigned to nodestrings directly on the ADCIRC mesh. Instead, boundary condition attributes are assigned to feature arcs on an ADCIRC boundary condition coverage which is then mapped to the ADCIRC mesh. This method allows the arc to be snapped to the mesh which reduces the time needed to create boundary conditions.
* Boundary conditions are no longer assigned to nodestrings directly on the ADCIRC mesh like they were in SMS 12.3 and earlier. Instead, boundary condition attributes are assigned to feature arcs on an ADCIRC boundary condition coverage which is then mapped to the ADCIRC mesh. This method allows the arc to be snapped to the mesh which reduces the time needed to create boundary conditions.
* The boundary conditions must be applied to the ADCIRC simulation before tidal forcing can be applied to the simulation.
* The workflow for adding tidal forcing attributes has changed. Tidal forcing attributes are now created as a separate component that are linked to the ADCIRC simulation.
* The workflow for adding tidal forcing attributes has changed. Tidal forcing attributes are now created as a separate component that are linked to the ADCIRC simulation.
* The workflow for adding flow forcing attributes has changed.
* The workflow for adding flow forcing attributes has changed.
An updated workflow for creating an ADCIRC project can be found in the article [[ADCIRC_Project_Workflow|ADCIRC Project Workflow]].
It should be noted that once an ADCIRC project has been imported into SMS 13.1, it cannot be reverted to an earlier version of SMS.


===New Boundary Conditions Workflow===
===New Boundary Conditions Workflow===
Line 15: Line 18:


===New Tidal Forcing Workflow===
===New Tidal Forcing Workflow===
Tidal constituents are now defined on a simulation that is linked to the ADCIRC simulation. This is done by doing the following:
<blockquote>
<blockquote>
{|class="mw-collapsible mw-collapsed" style="width: 100%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
{|class="mw-collapsible mw-collapsed" style="width: 100%; border:1px solid #D0E0FF; margin-bottom:0.4em;"
Line 34: Line 38:
|}
|}
</blockquote>
</blockquote>
After the tidal constituents have been defined, the tidal constituent simulation must be applied to the ADCIRC simulation before the model run.


===New Flow Forcing Workflow===
===New Flow Forcing Workflow===
Line 40: Line 45:
:# Turn on ''Flow forcing'' in the [[SMS:ADCIRC_Coverages#Forcing_Options|''Boundary Conditions Forcing Options'']] dialog.
:# Turn on ''Flow forcing'' in the [[SMS:ADCIRC_Coverages#Forcing_Options|''Boundary Conditions Forcing Options'']] dialog.
:# Define flow forcing parameters.
:# Define flow forcing parameters.
===Importing Native ADCIRC Model===
Migrating SMS 13.0 ADCIRC Projects into SMS 13.1 or later is not supported. When importing an ADCIRC 13.0 project into SMS 13.1 or later, the following message will appear:
SMS 13.0 ADCIRC projects are not supported in this version of SMS. Read the native ADCIRC input files to load this ADCIRC model(s). See https://www.xmswiki.com/wiki/SMS:ADCIRC_Interface_Changes_for_SMS_13.1#Importing_Native_ADCIRC_Model for more details.
Therefore, the native ADCIRC files will need to be imported for ADCIRC projects that were created in SMS 13.0 and are being migrated to SMS 13.1 or later. When importing the native ADCIRC files, pay attention to the following:
*Reading a fort.15 creates a new simulation (and possibly a mapped tidal component) and reads all data in the fort.14, fort.13, or fort.22 files in the same folder.
*Reading a fort.14 independently creates a new simulation, mesh, and mapped boundary condition component
*Reading a fort.13 independently just creates the nodal attribute datasets.
==Related Topics==
*[[SMS:ADCIRC|ADCIRC]]
*[[ADCIRC_Project_Workflow|ADCIRC Project Workflow]]


{{Navbox SMS}}
{{Navbox SMS}}
[[Category:ADCIRC]]

Latest revision as of 23:00, 17 March 2021

With the release of SMS 13.1, several changes were made to how ADCIRC interfaces with SMS. Changes to the user interface for ADCIRC include the following:

  • Depth bathymetry datasets have been eliminated. Instead of a depth dataset, an elevation dataset is used. The elevation dataset uses negative Z-values to represent depth.
  • Boundary conditions are no longer assigned to nodestrings directly on the ADCIRC mesh like they were in SMS 12.3 and earlier. Instead, boundary condition attributes are assigned to feature arcs on an ADCIRC boundary condition coverage which is then mapped to the ADCIRC mesh. This method allows the arc to be snapped to the mesh which reduces the time needed to create boundary conditions.
  • The boundary conditions must be applied to the ADCIRC simulation before tidal forcing can be applied to the simulation.
  • The workflow for adding tidal forcing attributes has changed. Tidal forcing attributes are now created as a separate component that are linked to the ADCIRC simulation.
  • The workflow for adding flow forcing attributes has changed.

An updated workflow for creating an ADCIRC project can be found in the article ADCIRC Project Workflow.

It should be noted that once an ADCIRC project has been imported into SMS 13.1, it cannot be reverted to an earlier version of SMS.

New Boundary Conditions Workflow

Creating ADCIRC boundary conditions use the following workflow:

1. Create an ADCIRC Boundary Conditions map coverage.
Create a new coverage with the "ADCIRC Boundary Condition" type.
1. Create new coverage from scratch.
  1. Select Map Data in the Project Explorer and use the New Coverage right-click command.
  2. Use the New Coverage dialog to create a new coverage by selecting the desired coverage type, and naming the coverage.
2. Create new coverage from an existing coverage.
  1. Use the Duplicate command on an existing coverage. This will copy any feature objects on the coverage.
  2. Use the Rename command to give the coverage a new name.
  3. Change the coverage type.
2. Create the mainland arc.
1. Import an existing mainland arc. (optional)
  1. Use the File | Open command to import a coastline file containing a coastline arc.
  2. Right-click on the coastline arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Attributes command.
  3. Define the arc as a mainland arc in the ADCIRC Linear BC dialog.
2. Create a feature arc to use as a mainland.
1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to digitize the coastline.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
2. Assign attributes to the mainland arc.
  1. Right-click on the coastline arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Attributes command.
  2. Define the arc as a mainland arc in the ADCIRC Linear BC dialog.
3. Define the domain.
  1. Use the Feature Objects | Define Domain command.
  2. Define the domain in the Domain Options dialog.
4. Assign ocean arc attributes.
  1. Right-click on the domain arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Attributes command.
  2. Define the arc in the ADCIRC Linear BC dialog.
5. Assign other boundary condition attributes. (optional)
1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to digitize the boundary condition arc.
1. Create feature arcs, nodes and vertices.
In the Map module, create feature objects in the active coverage.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to create arcs in the map coverage.
  2. Begin creating a new arc by clicking in the Graphics Window at either arc end. If clicking on an existing feature node, vertex or arc, the new arc will snap to that object.
  3. Double-click or press the Enter key to terminate the arc.
  4. Use the Create Feature Node Create Points Tool.svg tool to create additional nodes alone or to split arcs.
2. Modify arcs.
Feature arcs often need to be edited after initial creation.
1. Create additional vertices on arcs.
  1. Use the Create Feature Vertex SMS Create Vertex Tool.svg tool to add vertices along arcs.
2. Refine the arc shape.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and the Select Feature Node SMS Select Node Tool.svg tool to move/edit existing arcs and refine the shape by dragging the nodes/vertices.
  2. Use the Select Feature Arc SMS Select Arc Tool.svg tool to move entire arcs .
3. Split arcs.
An existing arc can be split by:
1. Converting a vertex to a node.
  1. Use the Select Feature Vertex SMS Select Vertex Tool.svg tool and right-click on a vertex along an arc.
  2. Select the Convert to Node command to split the arc into two arcs.
2. Add a node the arc.
  1. Use the Create Feature Node Create Points Tool.svg tool to add a node on an arc in order to split it into two arcs.
3. Add a new connecting arc.
  1. Use the Create Feature Arc SMS Create Arc Tool.svg tool to start or end a new arc on an existing arc to split the existing arc into two arcs.
4. Use the Split Arcs Tool.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Split Arc(s)... command.
  2. Use the Split Arcs Tool to divide arcs.
5. Split overlapping arcs using the Clean Options dialog.
  1. Select overlapping arcs using the Select Feature Arc SMS Select Arc Tool.svg tool.
  2. Use the Feature Objects | Clean command to bring up the Clean Options dialog.
  3. Select the Intersect selected arcs option (for selected arcs) or Intersect arcs option (for all overlapping arcs) to split the arcs.
4. Merge arcs.
Two arcs that share an end node can be merged together.
  1. Select the shared node using the Select Feature Node SMS Select Node Tool.svg tool.
  2. Right-click on the node and select the Convert to Vertex command to merge the arcs.
  3. If desired, the Select Feature Vertex SMS Select Vertex Tool.svg tool can be used to select and delete the new vertex.
5. Smooth arcs.
The variability or roughness of an arc can be reduced.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Smooth Arc(s)... command.
  2. Use the Smooth Arcs Tool to reduce the variability of the arc.
6. Prune arcs.
Concave sections of the arc can be removed.
  1. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Prune Arc(s)... command.
  2. Use the Prune Arcs dialog to remove concave sections.
7. Extend/trim arcs.
Extend or shorten an arc to match an existing arc's length.
  1. Using the Select Feature Arc SMS Select Arc Tool.svg tool, select two intersecting arcs.
  2. Right-click on an arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Extend/Trim Arc... command.
  3. Use the Trim/Extend Arc dialog to select the target arc and source arc.
2. Assign attributes to the arc.
  1. Right-click on the boundary condition arc using the Select Feature Arc SMS Select Arc Tool.svg tool and select the Attributes command.
  2. Define the arc with the desired boundary condition in the ADCIRC Linear BC dialog.

After the boundary conditions arcs have been created and defined on the ADCIRC boundary condition coverage, the coverage and the mesh are linked to the ADCIRC simulation in the Project Explorer.

New Tidal Forcing Workflow

Tidal constituents are now defined on a simulation that is linked to the ADCIRC simulation. This is done by doing the following:

1. Turn on tidal forcing.
  1. In the Project Explorer, right-click on the ADCIRC boundary conditions coverage and select Forcing Options.
  2. Turn on Tidal forcing in the Boundary Conditions Forcing Options dialog.
2. Define tidal constituents.
  1. Right-click in the Project Explorer and select the New Simulations | Tidal Constituents command.
  2. In the Project Explorer, right-click on the tidal constituents simulation and select Edit Constituents.
  3. Define tidal constituents in the Tidal Constituents dialog.

After the tidal constituents have been defined, the tidal constituent simulation must be applied to the ADCIRC simulation before the model run.

New Flow Forcing Workflow

To add flow forcing to an ADCIRC project in SMS 13.1 or later, do the following:

  1. In the Project Explorer, right-click on the ADCIRC boundary conditions coverage and select Forcing Options.
  2. Turn on Flow forcing in the Boundary Conditions Forcing Options dialog.
  3. Define flow forcing parameters.

Importing Native ADCIRC Model

Migrating SMS 13.0 ADCIRC Projects into SMS 13.1 or later is not supported. When importing an ADCIRC 13.0 project into SMS 13.1 or later, the following message will appear:

SMS 13.0 ADCIRC projects are not supported in this version of SMS. Read the native ADCIRC input files to load this ADCIRC model(s). See https://www.xmswiki.com/wiki/SMS:ADCIRC_Interface_Changes_for_SMS_13.1#Importing_Native_ADCIRC_Model for more details.

Therefore, the native ADCIRC files will need to be imported for ADCIRC projects that were created in SMS 13.0 and are being migrated to SMS 13.1 or later. When importing the native ADCIRC files, pay attention to the following:

  • Reading a fort.15 creates a new simulation (and possibly a mapped tidal component) and reads all data in the fort.14, fort.13, or fort.22 files in the same folder.
  • Reading a fort.14 independently creates a new simulation, mesh, and mapped boundary condition component
  • Reading a fort.13 independently just creates the nodal attribute datasets.

Related Topics