SMS:Coverages: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(46 intermediate revisions by 2 users not shown)
Line 1: Line 1:
{{Template:Infobox SMS Map Module}}
{{Template:Infobox SMS Map Module}}
== Coverages ==
__TOC__
Feature objects in the Map module are grouped into coverages. Each coverage has a specific type, which determines the attributes that can be associated with geometric objects in that coverage.  The coverages are grouped into conceptual models. The type of the active coverage is displayed in the "information" box displayed from the "Get Info" command.
Feature objects in the Map module are grouped into coverages. Each coverage has a specific type, which determines the attributes that can be associated with geometric objects in that coverage.  The coverages are grouped into conceptual models. The type of the active coverage is displayed in the [[SMS:Object Info|information]] box displayed from the '''Get Info''' command.


A coverage is similar to a layer in a CAD drawing. Each coverage represents a  particular set of information. For example, one coverage could be used to define  meshing zones and another coverage could be used to define zones of consistent  roughness parameters. These objects could not be included in a single coverage  since polygons within a coverage are not allowed to overlap and material zone  boundaries don't necessarily coincide with meshing zone boundaries.  Alternatively, one coverage could define Cartesian grid parameters for the same  zone.
A coverage is similar to a layer in a CAD drawing. Each coverage represents a  particular set of information. For example, one coverage could be used to define  meshing zones and another coverage could be used to define zones of consistent  roughness parameters. These objects could not be included in a single coverage  since polygons within a coverage are not allowed to overlap and material zone  boundaries don't necessarily coincide with meshing zone boundaries.  Alternatively, one coverage could define Cartesian grid parameters for the same  zone.


Coverages are managed using the Project Explorer.  When SMS is  first launched, a default coverage exists.  If the user creates feature objects they are placed in the current  coverage. When multiple coverages are created, one coverage is designated the  "active" coverage. New feature objects are always added to the active coverage  and only objects in the active coverage can be edited. The figure below shows  several coverages in the Project Explorer.  The active coverage is displayed  with a green colored icon and bold text. A coverage is made the active coverage by  selecting it from the Project Explorer. In some cases it is useful to hide some  or all of the coverages. The visibility of a coverage is controlled using the  check box next to the coverage in the  Project Explorer. In the example below, several design options are not displayed.
Coverages are managed using the Project Explorer.  When SMS is  first launched, a default coverage exists.  If feature objects are created, they are placed in the current  coverage. When multiple coverages are created, one coverage is designated the  "active" coverage. New feature objects are always added to the active coverage  and only objects in the active coverage can be edited. The figure below shows  several coverages in the Project Explorer.  The active coverage is displayed  with a green colored icon [[File:Coverage Active Icon.svg|16 px]] and bold text. A coverage is made the active coverage by  selecting it from the Project Explorer. In some cases it is useful to hide some  or all of the coverages. The visibility of a coverage is controlled using the  check box next to the coverage in the  Project Explorer. In the example below, several design options are not displayed.


[[Image:Project_explorer_coverages.jpg]]
[[Image:Project_explorer_coverages.png|thumb|none|180 px|Example of coverages in the Project Explorer]]


=== Creating a New Coverage ===
== Creating a New Coverage ==
A new coverage can be created by right-clicking on the Map Data folder in the Project Explorer.  Select New Coverage from the pop-up menu.  The New Coverage dialog will appear and the coverage type will need to be defined.  Each  coverage type is organized according to whether it is a Generic or a Model type  coverage.  If a coverage type was selected that has attributes associated with it, they can be changed by clicking the Attributes button. If there are no attributes associated with the selected coverage type the Attributes button will be unavailable.  The name of the coverage is also specified here.  After clicking the OK button, the new coverage will appear in the Project Explorer.
[[File:SMS NewCoverage.png|thumb|270 px|The ''New Coverage'' dialog]]
A new coverage can be created by right-clicking on the "[[File:Map Folder.svg|16 px]] Map Data" folder in the Project Explorer.  Select '''New Coverage''' from the pop-up menu.  The ''New Coverage'' dialog will appear and the coverage type will need to be defined.  Each  coverage type is organized according to whether it is a ''Generic'' or a ''Model'' type  coverage.  If a coverage type was selected that has attributes associated with it, they can be changed by clicking the Attributes button. If there are no attributes associated with the selected coverage type the '''Attributes''' button will be unavailable.  The name of the coverage is also specified here.  After clicking the '''OK''' button, the new coverage will appear in the Project Explorer.


=== Coverage Right-click Menu ===
:'''''Note:''''' Apostrophes and other special characters are not allowed and may cause an error if included in the coverage name.
 
== Coverage Right-Click Menu ==
Right-clicking on a coverage brings up a menu with the following options:
Right-clicking on a coverage brings up a menu with the following options:
* '''Delete''' – Removes the selected coverage along with any data in the coverage.
* '''Delete''' – Removes the selected coverage along with any data in the coverage.
* '''Duplicate''' – Will create a copy of the coverage.  
* '''Duplicate''' – Will create a copy of the coverage.  
* '''Rename''' – Allows the coverage to be given a different name.  
* '''Rename''' – Allows the coverage to be given a different name. Note that apostrophes and other special characters are not allowed and may cause an error if included in the coverage name.
* '''Convert''' – Coverage feature object data can be mapped to other geometric objects or numerical models by selecting  one of the Map -> ... options in the Convert submenu.
* ''Convert'' – Coverage feature object data can be mapped to other geometric objects or numerical models by selecting  one of the '''Map → ...''' commands in the ''Convert'' submenu.
* '''Coordinate Conversion''' – The Coordinate Conversion dialog opens, which allows the user to specify a coordinate conversion to be performed on the coverage data.
* '''Coordinate Conversion''' – The ''Coordinate Conversion'' dialog opens, which aspecifies a coordinate conversion to be performed on the coverage data.
* '''Metadata''' – Metadata associated with this coverage can be edited and viewed.
* '''Metadata''' – Metadata associated with this coverage can be edited and viewed.
* '''Zoom to Coverage''' – Frames the [[SMS:Graphics Window|graphics window]] to the extents of the data displayed in the selected coverage.
* '''Zoom to Coverage''' – Frames the [[SMS:Graphics Window|graphics window]] to the extents of the data displayed in the selected coverage.
* '''Type''' – Sets the [[SMS:Coverages#Coverage Types|coverage type]].
* ''Type'' – Sub-menu containing options to set the [[SMS:Coverages#Coverage Types|coverage type]].
* '''Properties''' – Opens a ''Coverage Properties'' dialog that show information such as number of feature objects and the coverage's projection.
See the [[SMS:Map_Project_Explorer#Coverage_Item_Right-Click_Menus|Map Project Explorer]] for more details.


=== Merging Existing Coverages ===
== Merging Existing Coverages ==
Occasionally, a user may want independent features of two separate coverages combined into one converage.  SMS allows the user to merge these two coverages together.  The user should left click one of the coverages listed in the data tree then multi-select the other coverages to be merged.  This can be done one at a time by holding the CTRL key, or several adjacent coverages can be selected by holding the SHIFT key and then clicking the last adjacent dataset.
Occasionally, its desirable to have independent features of two separate coverages combined into one converage.  SMS allows merging these two coverages together.  Select one of the coverages listed in the data tree then multi-select the other coverages to be merged.  This can be done one at a time by holding the ''CTRL'' key, or several adjacent coverages can be selected by holding the ''SHIFT'' key and then clicking the last adjacent dataset.


Once all datasets to be merged have been selected, the user simply accesses the right-click menu and chooses "Merge Coverages".  A dialog may appear asking the user if they wish to delete the coverages used to create the merged coverage.
Once all datasets to be merged have been selected, access the right-click menu and chooses '''Merge Coverages'''.  A dialog may appear asking if wanting to delete the coverages used to create the merged coverage.


== Coverage Types ==
== Coverage Types ==
The attributes of entities on a coverages belong to a list of attributes associated with a type of coverage. For example, arcs in mesh coverages have boundary conditions compatible with the specific finite element model they are associated with, and polygons in those coverages include attributes associated with meshing and material types.  The following coverage types include the following:
The attributes of entities on a coverages belong to a list of attributes associated with a type of coverage. For example, arcs in mesh coverages have boundary conditions compatible with the specific finite element model they are associated with, and polygons in those coverages include attributes associated with meshing and material types.   
* Generic Input (Preprocessing)
 
** [[SMS:Area Property Coverage|Area Property]]
Coverages are grouped into two categories:
** [[SMS:Feature Stamping|Feature Stamping]]
* [[SMS:Generic Coverages|Generic]] – coverages for generic input prepossessing, generic output postprocessing and generic model interfaces.
** [[SMS:Spatial Data Coverage|Spatial Data]]
* [[SMS:Model Specific Coverages|Models]] – coverages for specific models in SMS.
* Generic Output (Postprocessing)
 
** [[SMS:Observation Coverage|Observation]]
==Export Coverage==
** [[SMS:Particle/Drogue Coverage|Particle/Drogue]]
To export a coverage as a DMC file, complete the following:
** [[SMS:Tabular Data Files - SHOALS *.pts|Shoals]]
# Right-click on a coverage in the Project Explorer and select the '''Export''' command.
* Generic Model Interface
# In the ''Export Coverage'' dialog, change ''Save as type'' to be "SMS model coverage (*.dmc)".
** [[SMS:Mapping Coverage|Mapping]]
# Save the DMC file.
* Models
See the [[SMS:Model Coverage File|Model Coverage File]] article for more information.
** [[SMS:ADCIRC Coverage|ADCIRC]]
** [[SMS:ADH Coverage|ADH]]
** [[SMS:BOUSS-2D|BOUSS-2D]]
** [[SMS:CGWAVE|CGWAVE]]
** [[SMS:CMS-Flow|CMS-FLOW]]
** [[SMS:CMS-Wave|CMS-WAVE]]
** [[SMS:FESWMS|FESWMS]]
** [[SMS:GenCade|GenCade]]
** [[SMS:GENESIS|GENESIS]] (replaced by GenCade)
** [[SMS:Generic Mesh Coverage|Generic Mesh]]
** [[SMS:PTM|PTM]]
** [[SMS:STWAVE|STWAVE]]
** [[SMS:TABS|TABS]]
** [[SMS:TUFLOW Coverages|TUFLOW]]


==Related Topics==
==Related Topics==
* [[SMS:Map Module|Map Module]]
* [[SMS:Map Module|Map Module]]
* [[SMS:Model Coverage File|Model Coverage File]]




Line 63: Line 55:


[[Category:SMS Map|Coverages]]
[[Category:SMS Map|Coverages]]
[[Category:SMS Coverages|C]]
[[Category:SMS Coverages|Coverage]]
[[Category:SMS Map Dialogs|coverage]]
[[Category:Project Explorer]]
[[Category:Map Module]]

Latest revision as of 17:15, 25 June 2024

Map Module
Map Data Set.png
Map
Feature Objects
Coverages
More
Map Module Interface
Map Display Options
Map Module Tools
Feature Objects Menu
Map Project Explorer

Feature objects in the Map module are grouped into coverages. Each coverage has a specific type, which determines the attributes that can be associated with geometric objects in that coverage. The coverages are grouped into conceptual models. The type of the active coverage is displayed in the information box displayed from the Get Info command.

A coverage is similar to a layer in a CAD drawing. Each coverage represents a particular set of information. For example, one coverage could be used to define meshing zones and another coverage could be used to define zones of consistent roughness parameters. These objects could not be included in a single coverage since polygons within a coverage are not allowed to overlap and material zone boundaries don't necessarily coincide with meshing zone boundaries. Alternatively, one coverage could define Cartesian grid parameters for the same zone.

Coverages are managed using the Project Explorer. When SMS is first launched, a default coverage exists. If feature objects are created, they are placed in the current coverage. When multiple coverages are created, one coverage is designated the "active" coverage. New feature objects are always added to the active coverage and only objects in the active coverage can be edited. The figure below shows several coverages in the Project Explorer. The active coverage is displayed with a green colored icon Coverage Active Icon.svg and bold text. A coverage is made the active coverage by selecting it from the Project Explorer. In some cases it is useful to hide some or all of the coverages. The visibility of a coverage is controlled using the check box next to the coverage in the Project Explorer. In the example below, several design options are not displayed.

Example of coverages in the Project Explorer

Creating a New Coverage

The New Coverage dialog

A new coverage can be created by right-clicking on the "Map Folder.svg Map Data" folder in the Project Explorer. Select New Coverage from the pop-up menu. The New Coverage dialog will appear and the coverage type will need to be defined. Each coverage type is organized according to whether it is a Generic or a Model type coverage. If a coverage type was selected that has attributes associated with it, they can be changed by clicking the Attributes button. If there are no attributes associated with the selected coverage type the Attributes button will be unavailable. The name of the coverage is also specified here. After clicking the OK button, the new coverage will appear in the Project Explorer.

Note: Apostrophes and other special characters are not allowed and may cause an error if included in the coverage name.

Coverage Right-Click Menu

Right-clicking on a coverage brings up a menu with the following options:

  • Delete – Removes the selected coverage along with any data in the coverage.
  • Duplicate – Will create a copy of the coverage.
  • Rename – Allows the coverage to be given a different name. Note that apostrophes and other special characters are not allowed and may cause an error if included in the coverage name.
  • Convert – Coverage feature object data can be mapped to other geometric objects or numerical models by selecting one of the Map → ... commands in the Convert submenu.
  • Coordinate Conversion – The Coordinate Conversion dialog opens, which aspecifies a coordinate conversion to be performed on the coverage data.
  • Metadata – Metadata associated with this coverage can be edited and viewed.
  • Zoom to Coverage – Frames the graphics window to the extents of the data displayed in the selected coverage.
  • Type – Sub-menu containing options to set the coverage type.
  • Properties – Opens a Coverage Properties dialog that show information such as number of feature objects and the coverage's projection.

See the Map Project Explorer for more details.

Merging Existing Coverages

Occasionally, its desirable to have independent features of two separate coverages combined into one converage. SMS allows merging these two coverages together. Select one of the coverages listed in the data tree then multi-select the other coverages to be merged. This can be done one at a time by holding the CTRL key, or several adjacent coverages can be selected by holding the SHIFT key and then clicking the last adjacent dataset.

Once all datasets to be merged have been selected, access the right-click menu and chooses Merge Coverages. A dialog may appear asking if wanting to delete the coverages used to create the merged coverage.

Coverage Types

The attributes of entities on a coverages belong to a list of attributes associated with a type of coverage. For example, arcs in mesh coverages have boundary conditions compatible with the specific finite element model they are associated with, and polygons in those coverages include attributes associated with meshing and material types.

Coverages are grouped into two categories:

  • Generic – coverages for generic input prepossessing, generic output postprocessing and generic model interfaces.
  • Models – coverages for specific models in SMS.

Export Coverage

To export a coverage as a DMC file, complete the following:

  1. Right-click on a coverage in the Project Explorer and select the Export command.
  2. In the Export Coverage dialog, change Save as type to be "SMS model coverage (*.dmc)".
  3. Save the DMC file.

See the Model Coverage File article for more information.

Related Topics