SMS:ADCIRC Spatial Attributes

From XMS Wiki
Revision as of 17:36, 5 January 2009 by Rjones (talk | contribs)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)
Jump to navigationJump to search

ADCIRC Spatial Attributes

Spatial attributes are parameters that can be applied to the entire space of the simulation across the nodes of the mesh. ADCIRC is capable of handling such attributes in connection with the SMS interface. The user can define these attributes in a the Spatial Attributes dialog under the ADCIRC menu. There are a number of predefined attributes that the user can use or they can define their own. Here is a list of the predefined spatial attributes and a brief meaning of each.

  • primitive weighting in continuity equation - Tau0
  • surface submergence state - StartDry
  • quadratic friction coefficient at sea floor - Fric
  • surface directional effective roughness length - z0Land
  • surface canopy coefficient - VCanopy
  • bridge pilings friction parameters - BK, BAlpha, BDelX, POAN
  • Manning's n at sea floor - ManningsN
  • Chezy friction coefficient at sea floor - ChezyFric
  • sea surface height above geoid - GeoidOffset
  • horizontal eddy viscosity - ESLM

Please visit the ADCIRC web site to learn more about the meaning of each of the spatial attributes listed above.

How to Use Spatial Attributes in a Simulation

Spatial Attributes are very easy to define and implement into an ADCIRC simulation. First, open the Spatial Attributes dialog from the ADCIRC menu. A dialog with a spreadsheet will appear that shows a list of the names and a comment of each currently defined spatial attribute. From here, you can create a new attribute or delete an existing attribute.

File:Spatial atts.JPG

Creating a New Spatial Attribute

  1. Click the New button in the Spatial Attributes dialog.
  2. In the New Spatial Attribute dialog, select between the Predefined or Custom options. The Custom option will be used mostly for ADCIRC developers only. If Predefined is selected, select an attribute from the list-box and add a comment if so desired. If Custom is selected, type in a name for the new attribute and a comment, and then type the dataset name(s) for that attribute into the spreadsheet. (Before you can define a custom attribute, you must first read in a dataset of values into SMS.) Click the Next button to go to the next page of the dialog.
  3. Notice, in the spreadsheet, all of the defined spatial attributes. The first column of the spreadsheet is called Att Dataset, which tells you the title of the attribute dataset. The next column is entitled Default Value. In this column you can define a constant value for the attribute. The last column of the spreadsheet is entitled Initial Values. Here you can choose which dataset the values of the attribute come from. Set the value of the attribute by entering a value in the Default Value column or pick a dataset for it from the Initial Values column. Click Finish to finalize the definition of the attribute.
  4. Click OK to exit the Spatial Attributes dialog. Notice that the attribute just defined appears in the Project Explorer under the Mesh Data folder. Its dataset can be selected and contoured for viewing.

File:Spatial atts2.JPG

Editing Spatial Attributes

To edit a spatial attribute, open the Spatial Attributes dialog. Here you can create a new attribute to replace the one you want to edit. Once you have redefined the new attribute, SMS will ask you if you want to replace the existing one. Click OK to replace the old attribute with the new one that was just defined.


Related Links