SMS:2D Mesh Nodestrings Menu: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
(21 intermediate revisions by 3 users not shown)
Line 1: Line 1:
The ''Nodestrings'' Menu includes the following commands:
{{toc right}}
The use of nodestrings has varied from one version of SMS to another.  Historically, nodestrings served the following purposes:
# Breakline to enforce element edges.
# Location for boundary condition assignment.
# Location for mesh renumbering for efficient numerical analysis.


== General Commands ==
With the development of a [[SMS:Renumber|global renumbering]] option the need to check matrix efficiency from a number of starting points was eliminated.  The ''renumber'' command that had been in the nodestring menu was moved to the nodes menu.  This feature was added in [[XMS:What's_New_in_SMS_11.1|SMS 11.1]].  The option for local renumbering was retained as a right click command when clicking on a nodestring.
*'''Options'''
 
<blockquote>[[SMS:Breaklines|Breakline]] options</blockquote>
As the modeling approach moves to a simulation based approach, rather than a geomtry based approach, the use of nodestrings to assign boundary conditions is transitioning to the assignment on arcs in a boundary condition coverage.
*'''Force Breaklines'''  
<blockquote>Force element edges to follow the selected nodestring</blockquote>
The ''Nodestrings'' functions includes:
*'''Smooth'''
 
<blockquote>Smooth the mesh boundary along the path of a selected nodestring by moving midside nodes. Only used for quadratic elements.</blockquote>
== Nodestrings Menu ==
*'''Renumber Nodestrings'''
*'''Options''' &ndash; This command invokes the ''Nodestring Options'' dialog.  This dialog is described below.
<blockquote>Renumbers the nodestrings starting with an id of 1.</blockquote>
*'''Force Breaklines''' &ndash; This command is only available when at least one nodestring is selected.  The command forces element edges to follow the selected nodestring(s).  This can be accomplished by swapping element edges or by inserting nodes where the nodestring crosses an element edge.  This capability is described in the [[SMS:Breaklines|Breaklines]] article.
*'''Merge'''
*'''Smooth''' &ndash; This command is only available when at least one nodestring is selected and the mesh includes quadratic elements (midside nodes). The result of the command is to move the midside nodes to create a geometrically smooth curve from one element edge to the next. This continuity is based on the edges being interpreted as quadratic curves rather than linear segments. If the angle between adjacent element edges in the nodestring is greater than 60 degrees, the break in the smoothing is left to avoid severe distortion of the quadratic edge.
<blockquote>Merge selected nodestrings to form a single nodestring. Available if more than one nodestring is selected.</blockquote>
*'''Renumber''' &ndash; This command is only available in version 11.0 and older.  It is only available when one nodestring is selected. The function reorders the nodes and elements (resetting the ID values) with the nodes on the selected nodestring being the starting point and sweeping through the domain as described in [[SMS:Renumber|renumbering]].  
*'''Split'''
*'''Renumber Nodestrings''' &ndash; This command appears in the menu starting at version 11.1. This allows to explicitly remove any gaps in the nodestring ID numbers.
<blockquote>Split a single nodestring into multiple nodestrings at the selected mesh node. Available if a mesh node is selected.</blockquote>
*'''Extract Weir Elevations...''' &ndash;  This command appears in the menu starting at version 11.1 for ADCIRC meshes when two nodestrings making up a weir or island barrier are selected.  The command invokes the '''Extract Weir Elevations''' dialog that allows extracting the elevations for the weir to a coverage.
*'''Reverse Direction'''
*'''Merge''' &ndash; This command is available if more than one nodestring is selected. It looks for nodestrings that share a single point (end to end) and merges them into a single nodestring if these conditions exist.
<blockquote>Reverse the direction of selected nodestrings. Selecting a nodestring causes the direction arrows to be displayed and can be used to verify the nodestring direction.</blockquote>
*'''Split''' &ndash; This command is available if a mesh node is selected.  When the command is issued, SMS looks for nodestrings that use the selected node. When such a nodestring is found, the string is split into two nodestrings at the selected mesh node.
*'''Reverse Direction''' &ndash; This command reverses the direction of selected nodestrings. Selecting a nodestring causes the direction arrows to be displayed and can be used to verify the nodestring direction. This is typically only useful for extracted 2D plots.
 
==Nodestring Right-Click Commands==
Many of the ''Nodestring'' menu commands are also available by right-clicking on a selected nodestring. In addition to the commands that are described in the previous section, the following are available as right-click commands on nodestring.
*'''Delete Selected''' &ndash; Standard right click menu command
*'''Add Weir...''' &ndash; This command was added for version 12.0 of SMS for ADCIRC meshes.  It appears only when the selected nodestring(s) are fully internal to the mesh. It invokes the ''Add Weir'' dialog which specifies a width (in m) for a new weir to be inserted into the mesh along the nodestring.
*'''Remove Weir...''' &ndash; This command was added for version 12.0 of SMS for ADCIRC meshes.  It appears only when a pair of selected nodestring(s) define an ADCIRC weir or island barrier boundary condition. It invokes the ''Remove Weir'' dialog which specifies a method for removing the weir.  These include an option to pave over the weir, which fills the area between the nodestrings with elements, or to merge the nodestrings, which creates a new node for each pair of nodes in the weir at the midpoint between the nodes on the weir.  By default the command will also renumber the mesh since the edit changes the mesh definition.
*'''Assign BC...''' &ndash; This command applies to mesh based simulations and invokes the model specific boundary condition dialog to allow a boundary condition to be applied at the nodestring.
*'''Renumber Nodes''' &ndash; This command was added when the global renumber capability was implemented in the SMS and the menu command was removed.
*'''Clear Selection''' &ndash; Standard right-click menu command
*'''Invert Selection''' &ndash; Standard right-click menu command
*'''Zoom to Selection''' &ndash; Standard right-click menu command


==Nodestring Options==
==Nodestring Options==
[[Image:Mesh Nodestring Options.jpg|thumb|200 px|Mesh ''Nodestring Options'' dialog]]
[[Image:Mesh Nodestring Options.png|thumb|230 px|Mesh ''Nodestring Options'' dialog]]
The ''Nodestring Options'' dialog, invoked by the menu command described above, includes the following.
 
=== Breakline Options ===
=== Breakline Options ===
Controls how [[SMS:Breaklines|breaklines]] are processed.
Controls how [[SMS:Breaklines|breaklines]] are processed.
* '' Insert new nodes'' &ndash; Triangles intersected by the breakline are modified by adding new nodes at necessary locations to ensure that the edges of the triangles will conform to the breakline. The elevations of the new nodes are based on a linear interpolation of the breakline segments. The locations of the new nodes are determined in such a way that the [[SMS:Triangulation|Delauney criterion]] is satisfied.
* '' Insert new nodes'' &ndash; Triangles intersected by the breakline are modified by adding new nodes at necessary locations to ensure that the edges of the triangles will conform to the breakline. The elevations of the new nodes are based on a linear interpolation of the breakline segments. The locations of the new nodes are determined in such a way that the [[SMS:Scatter_Triangles_Menu#Delaunay_Criterion|Delaunay criterion]] is satisfied.
* '' Swap element edges'' &ndash; Triangles intersected by the breakline are modified by swapping element edges to ensure that the edges of the triangles will conform to the breakline.
* '' Swap element edges'' &ndash; Triangles intersected by the breakline are modified by swapping element edges to ensure that the edges of the triangles will conform to the breakline.
===Renumber Options===
===Renumber Options===
'''''Note:''' This feature was moved to the [[SMS:2D Mesh Nodes Menu|Nodes menu]] beginning in SMS version 11.1.''
* ''Band Width'' &ndash; See [[SMS:Renumber#Front Width and Band Width|Front Width and Band Width]] for more information.
* ''Band Width'' &ndash; See [[SMS:Renumber#Front Width and Band Width|Front Width and Band Width]] for more information.
* ''Front Width'' &ndash; See [[SMS:Renumber#Front Width and Band Width|Front Width and Band Width]] for more information.
* ''Front Width'' &ndash; See [[SMS:Renumber#Front Width and Band Width|Front Width and Band Width]] for more information.


[[Category:SMS Dialogs|2]]
[[Category:SMS Mesh Dialogs|Nodestring]]


==Related Topics==
==Related Topics==
Line 38: Line 57:
[[Category:SMS 2D Mesh|N]]
[[Category:SMS 2D Mesh|N]]
[[Category:SMS Menus|2]]
[[Category:SMS Menus|2]]
[[Category:SMS Boundary Conditions|Nodestrings]]

Revision as of 15:30, 24 April 2020


The use of nodestrings has varied from one version of SMS to another. Historically, nodestrings served the following purposes:

  1. Breakline to enforce element edges.
  2. Location for boundary condition assignment.
  3. Location for mesh renumbering for efficient numerical analysis.

With the development of a global renumbering option the need to check matrix efficiency from a number of starting points was eliminated. The renumber command that had been in the nodestring menu was moved to the nodes menu. This feature was added in SMS 11.1. The option for local renumbering was retained as a right click command when clicking on a nodestring.

As the modeling approach moves to a simulation based approach, rather than a geomtry based approach, the use of nodestrings to assign boundary conditions is transitioning to the assignment on arcs in a boundary condition coverage.

The Nodestrings functions includes:

Nodestrings Menu

  • Options – This command invokes the Nodestring Options dialog. This dialog is described below.
  • Force Breaklines – This command is only available when at least one nodestring is selected. The command forces element edges to follow the selected nodestring(s). This can be accomplished by swapping element edges or by inserting nodes where the nodestring crosses an element edge. This capability is described in the Breaklines article.
  • Smooth – This command is only available when at least one nodestring is selected and the mesh includes quadratic elements (midside nodes). The result of the command is to move the midside nodes to create a geometrically smooth curve from one element edge to the next. This continuity is based on the edges being interpreted as quadratic curves rather than linear segments. If the angle between adjacent element edges in the nodestring is greater than 60 degrees, the break in the smoothing is left to avoid severe distortion of the quadratic edge.
  • Renumber – This command is only available in version 11.0 and older. It is only available when one nodestring is selected. The function reorders the nodes and elements (resetting the ID values) with the nodes on the selected nodestring being the starting point and sweeping through the domain as described in renumbering.
  • Renumber Nodestrings – This command appears in the menu starting at version 11.1. This allows to explicitly remove any gaps in the nodestring ID numbers.
  • Extract Weir Elevations... – This command appears in the menu starting at version 11.1 for ADCIRC meshes when two nodestrings making up a weir or island barrier are selected. The command invokes the Extract Weir Elevations dialog that allows extracting the elevations for the weir to a coverage.
  • Merge – This command is available if more than one nodestring is selected. It looks for nodestrings that share a single point (end to end) and merges them into a single nodestring if these conditions exist.
  • Split – This command is available if a mesh node is selected. When the command is issued, SMS looks for nodestrings that use the selected node. When such a nodestring is found, the string is split into two nodestrings at the selected mesh node.
  • Reverse Direction – This command reverses the direction of selected nodestrings. Selecting a nodestring causes the direction arrows to be displayed and can be used to verify the nodestring direction. This is typically only useful for extracted 2D plots.

Nodestring Right-Click Commands

Many of the Nodestring menu commands are also available by right-clicking on a selected nodestring. In addition to the commands that are described in the previous section, the following are available as right-click commands on nodestring.

  • Delete Selected – Standard right click menu command
  • Add Weir... – This command was added for version 12.0 of SMS for ADCIRC meshes. It appears only when the selected nodestring(s) are fully internal to the mesh. It invokes the Add Weir dialog which specifies a width (in m) for a new weir to be inserted into the mesh along the nodestring.
  • Remove Weir... – This command was added for version 12.0 of SMS for ADCIRC meshes. It appears only when a pair of selected nodestring(s) define an ADCIRC weir or island barrier boundary condition. It invokes the Remove Weir dialog which specifies a method for removing the weir. These include an option to pave over the weir, which fills the area between the nodestrings with elements, or to merge the nodestrings, which creates a new node for each pair of nodes in the weir at the midpoint between the nodes on the weir. By default the command will also renumber the mesh since the edit changes the mesh definition.
  • Assign BC... – This command applies to mesh based simulations and invokes the model specific boundary condition dialog to allow a boundary condition to be applied at the nodestring.
  • Renumber Nodes – This command was added when the global renumber capability was implemented in the SMS and the menu command was removed.
  • Clear Selection – Standard right-click menu command
  • Invert Selection – Standard right-click menu command
  • Zoom to Selection – Standard right-click menu command

Nodestring Options

Mesh Nodestring Options dialog

The Nodestring Options dialog, invoked by the menu command described above, includes the following.

Breakline Options

Controls how breaklines are processed.

  • Insert new nodes – Triangles intersected by the breakline are modified by adding new nodes at necessary locations to ensure that the edges of the triangles will conform to the breakline. The elevations of the new nodes are based on a linear interpolation of the breakline segments. The locations of the new nodes are determined in such a way that the Delaunay criterion is satisfied.
  • Swap element edges – Triangles intersected by the breakline are modified by swapping element edges to ensure that the edges of the triangles will conform to the breakline.

Renumber Options

Note: This feature was moved to the Nodes menu beginning in SMS version 11.1.

Related Topics