GMS:Datasets: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(68 intermediate revisions by 5 users not shown)
Line 1: Line 1:
A data set is a set of values associated with each node, cell, vertex, or scatter point in an object. A data set can be steady state (one value per item) or transient (one value per item per time step). The values in the data set can be scalar values or vector values. Certain types of objects in GMS have an associated list of scalar data sets and a list of vector data sets. Each of the following objects in GMS can have both scalar a vector data sets:
{{TOCright}}
A dataset is a set of values associated with each node, cell, vertex, or scatter point in an object. A dataset can be steady state (one value per item) or transient (one value per item per time step). The values in the dataset can be scalar values or vector values. Certain types of objects in GMS have an associated list of scalar datasets and a list of vector datasets. Each of the following objects in GMS can have both scalar and vector datasets:


*[[GMS:TIN Module|TINs]]
*[[GMS:TIN Module|TINs]]
Line 11: Line 12:
*[[GMS:3D Grid Module|3D Grids]]
*[[GMS:3D Grid Module|3D Grids]]


The following objects can only have scalar data sets:
*[[GMS:UGrid Module|UGrids]]
 
The following objects can only have scalar datasets:


*[[GMS:Boreholes|Borehole Sample Data]]
*[[GMS:Boreholes|Borehole Sample Data]]
Line 19: Line 22:
*[[GMS:3D Scatter Point Module|3D Scatter Point Set]]
*[[GMS:3D Scatter Point Module|3D Scatter Point Set]]


The commands for manipulating data sets are located in the Data menu.
The commands for manipulating datasets are located in the ''Edit'' menu.


Data sets are used for both pre- and post-processing of models. For example, a scalar data set associated with a 3D grid can represent starting values of head or values of hydraulic conductivity for a groundwater modeling problem. Another data set associated with the same grid may represent computed head values. Data sets can be used to generate contours, [[GMS:Iso Surfaces|iso-surfaces]], [[GMS:Vectors|vector plots]], and [[GMS:Animations|animation]] sequences.
Datasets are used for both pre- and post-processing of models. For example, a scalar dataset associated with a 3D grid can represent starting values of head or values of hydraulic conductivity for a groundwater modeling problem. Another dataset associated with the same grid may represent computed head values. Datasets can be used to generate contours, [[GMS:Isosurfaces|isosurfaces]], [[GMS:Vectors|vector plots]], and [[GMS:Animations|animation]] sequences.


=== Generating Data Sets ===
=== Generating Datasets ===


Data sets can be generated in a variety of ways. They can represent output from a groundwater model (head, drawdown, etc.). They can represent tabular values in a text file entered by the user or exported from another application such as a GIS. They can be created by [[GMS:Interpolation|interpolating]] from a scatter point set to a TIN, grid, or mesh. Data sets can also be generated by performing mathematical operations on other data sets with the [[Data Calculator]].
Datasets are generated in a variety of ways. They can represent output from a groundwater model (head, drawdown, etc.). They can represent tabular values in a text file entered manually or exported from another application such as GIS. They can be created by [[GMS:Interpolation|interpolating]] from a scatter point set to a TIN, grid, or mesh. Datasets can also be generated by performing mathematical operations on other datasets with the ''[[Data Calculator]]''.


One advantage of the data set list approach for managing information is that it facilitates transfer of information between different types of models or models with differing resolution. This is accomplished through scatter point sets and interpolation. TINs, borehole contacts, borehole sample data, grids, and meshes can all be converted to a 2D or 3D scatter point set. When an object is converted to a scatter point set, all scalar data sets associated with the object are copied to the new scatter point set. The data sets can then be transferred from the scatter point set group to other objects of any type using one of the supported interpolation schemes.
One advantage of the dataset list approach for managing information is that it facilitates transfer of information between different types of models or models with differing resolution. This is accomplished through scatter point sets and interpolation. TINs, borehole contacts, borehole sample data, grids, and meshes can all be converted to a 2D or 3D scatter point set. When an object is converted to a scatter point set, all scalar datasets associated with the object are copied to the new scatter point set. The datasets can then be transferred from the scatter point set group to other objects of any type using one of the supported interpolation schemes.


Importing/Exporting Data Sets
===Importing/Exporting Datasets===
A data set can be exported by right-clicking on the data set in the [[GMS:Project Explorer|Project Explorer]] and select the Export command. The Save As dialog has three filter types that can be exported:  
To export a dataset, right-click on the dataset in the [[GMS:Project Explorer|Project Explorer]] and select the '''Export''' command. The ''Save As'' dialog has three filter types that can be exported:  


*Binary Data Set Files (*.dat)
*Binary Dataset Files (*.dat)


*ASCII Data Set Files (*.dat)
*ASCII Dataset Files (*.dat)


*HDF5 data Set Files (*.h5)
*HDF5 Dataset Files (*.h5)


A data set can be imported by right-clicking on any of the objects explained above in the [[GMS:Project Explorer|Project Explorer]] and select the Import Data Set command. This command brings up the File Open dialog.  
To import a dataset, right-click on any of the objects explained above in the [[GMS:Project Explorer|Project Explorer]] and select the '''Import Dataset''' command. This command brings up the File Open dialog.  


=== Project Explorer ===
=== Project Explorer ===


Data sets are displayed and managed in the [[GMS:Project Explorer|Project Explorer]]. Click [[GMS:Data Sets in the Project Explorer|here]] to learn about data sets in the [[GMS:Project Explorer|Project Explorer]].
Datasets are displayed and managed in the [[GMS:Datasets#Datasets in the Project Explorer|Project Explorer]].


=== Active Data Set ===
=== Active Dataset ===


Each object (TIN, Grid, Mesh, or Scatter Point Set) in GMS has a set of values which is designated as the "active data set." The active data set is an important part of model visualization in GMS. Each time the display is refreshed, the contours and other display features are generated using the active data set.
Each object (TIN, grid, mesh, or scatter point set) in GMS has a set of values which is designated as the "active dataset." The active dataset is an important part of model visualization in GMS. Each time the display is refreshed, the contours and other display features are generated using the active dataset.


The active data set and time step are displayed in the [[GMS:Project Explorer|Project Explorer]]. Left-clicking on a solution or data set in the [[GMS:Project Explorer|Project Explorer]] makes that item "active" and the display is automatically updated in the GMS window. The table below shows the icons displayed next to the active data sets.  
The active dataset and time step are displayed in the [[GMS:Project Explorer|Project Explorer]]. Clicking on a solution or dataset in the [[GMS:Project Explorer|Project Explorer]] makes that item "active" and the display is automatically updated in the GMS window. The table below shows the icons displayed next to the active datasets.  
{| class="wikitable"
{| class="wikitable"
|-
|-
|[[Image:Tree_DataSetActive.gif]]
|active scalar data set
|-
|-
|[[Image:Tree_VectorDataSetActive.gif]]
|[[File:Dataset Cells Active.svg|16 px]]
|active vector data set
|active scalar dataset on cells
|-
||[[File:Dataset Points Active.svg|16 px]]
|active scalar dataset on points
|-
|[[File:Vector Dataset Active.svg|16 px]]
|active vector dataset
|-
|-
|[[Image:Tree_CCFDataSetActive.gif]]
|[[File:CCF Dataset Active.svg|16 px]]
|active ccf data set
|active ccf dataset
|}
|}


==Data Set Info==
==Dataset Info==
Selecting the '''''Properties''''' command in right click menu on a data set in the [[GMS:Project Explorer|Project Explorer]] will bring up the Data Set Info Dialog. The components of the dialog are as follows:
[[File:DatasetInfo.png|thumb|375 px|Example of the ''Dataset Info'' dialog]]
Selecting the '''Dataset Info''' command in the right-click menu on a dataset in the [[GMS:Project Explorer|Project Explorer]] brings up the ''Dataset Info'' dialog. The components of the dialog are as follows:


===Statistics===
===Statistics===
A set of statistics related to the active data set is displayed on the left side of the Data Set Info dialog. the statixtics for all time steps can be shown by selecting the ''Show all time step stats''. toggle. A histogram of the data values is displayed on the right side. Right-clicking on the plot and selecting the '''Plot Data''' command brings up the X-Axis Precision dialog. This dialog enables users to set the precision of the x-axis of the Histogram.
A set of statistics related to the active dataset and the active time step is displayed on the left side of the ''Dataset Info'' dialog. The statistics for all time steps can be shown by selecting the ''Show all time step stats'' checkbox. To see info for multiple time steps, expand the ''Dataset Info'' dialog horizontally or scroll horizontally in the Time step table. A histogram of the active data values is displayed on the right side. The histogram shows the value intervals on the x-axis, and the number of occurrences within that interval on the y-axis. For example, the head output dataset histogram from a MODFLOW model will show the number of active cells with final head values within a given interval. The ''Intervals'' setting at the bottom of the histogram adjusts the number of intervals displayed along the x-axis.<!--Right-clicking on the plot and selecting the '''Plot Data''' command brings up the ''X-Axis Precision'' dialog. This dialog enables users to set the precision of the x-axis of the Histogram.-->


===View/Edit Values===
===View/Edit Values===
For data sets associated with model solutions, the data values can be displayed in a spreadsheet using the View Values button. For all other data sets, the button label changes to Edit Values and the spreadsheet can be used to change the data set values.
For datasets associated with model solutions, the data values can be displayed in a spreadsheet using the '''View Values''' button. For all other datasets, the button label changes to '''Edit Values''' and the spreadsheet can be used to change the dataset values.


===Active/Inactive Flags===
===Active/Inactive Flags===
If the currently selected module is the 3D Grid module, the active/inactive status of cells can be changed by selecting the Edit button at the bottom left of the dialog. This brings up the Active/Inactive Flags dialog.
If the currently selected module is the 3D Grid module, the active/inactive status of cells can be changed by selecting the '''Edit''' button at the bottom left of the dialog. This brings up the ''Active/Inactive Flags'' dialog.


===Date/Time Display===
===Date/Time Display===
For a transient data set, the time values can be displayed in the Time Step Window using either a relative time format (e.g., 100.0) or using a date/time format (e.g., 1/12/1998 3:23:48). The relative times are computed using a reference time that is defined for the model (MODFLOW, FEMWATER etc.). The reference time represents the date/time corresponding to t=0.
For a transient dataset, the time values can be displayed in the [[GMS:The GMS Window#Time_Steps_Window|Time Steps Window]] using either a relative time format (e.g., 100.0) or using a date/time format (e.g., 1/12/1998 3:23:48). The relative times are computed using a reference time that is defined for the model (MODFLOW, FEMWATER etc.). The reference time represents the date/time corresponding to t=0.


==Datasets in the Project Explorer==
The solutions and datasets associated with a particular object (grid, mesh, scatter point set, etc.) are managed using the [[GMS:The GMS Window|Project Explorer]].


==Data Sets in the Project Explorer==
=== Datasets ===
The solutions and data sets associated with a particular object (grid, mesh, scatter point set, etc.) are managed using the [[GMS:The GMS Screen|Project Explorer]].


=== Data Sets ===
Three different types of datasets are shown in the Project Explorer: scalar, vector, and CFF. For scalar datasets, they can be associated with either cells or points. The icons used to identify the datasets are shown below.


{| class="wikitable"
{| class="wikitable"
!width="100"|[[Image:Tree_DataSet.gif]]
! Dataset Type
!width="300"|scalar data set
! Active
!width="100"|[[Image:Tree_DataSetActive.gif]]
! Inactive
!width="300"|active scalar data set
|-
|scalar dataset on cells||[[File:Dataset Cells Active.svg|16 px]]||[[File:Dataset Cells Inactive.svg|16 px]]
|-
|-
|<center>[[Image:Tree_VectorDataSet.gif]]</center>||<center>'''vector data set'''</center>||<center>[[Image:Tree_VectorDataSetActive.gif]]</center>||<center>'''active vector data set'''</center>
|scalar dataset on points||[[File:Dataset Points Active.svg|16 px]]||[[File:Dataset Points Inactive.svg|16 px]]
|-
|-
|<center>[[Image:Tree_CCFDataSet.gif]]</center>||<center>'''ccf data set'''</center>||<center>[[Image:Tree_CCFDataSetActive.gif]]</center>||<center>'''active ccf data set'''</center>
|vector dataset||[[File:Vector Dataset Active.svg|16 px]]||[[File:Vector Dataset Inactive.svg|16 px]]
|-
|ccf dataset||[[File:CCF Dataset Active.svg|16 px]]||[[File:CCF Dataset Inactive.svg|16 px]]
|}
|}


3 different types of data sets are shown in the Data Tree: scalar, vector, and cff.  The icons used to identify the data sets are shown below.
If the active dataset is transient then the time steps are displayed in the [[GMS:The GMS Window#Time_Steps_Window|Time Steps Window]].
 
If the active data set is transient then the time steps are displayed in the [[GMS:The GMS Screen|Time Step Window]].


=== Solutions ===
=== Solutions ===


Solutions are output from a [[GMS:Numerical Models|numerical model]] that GMS supports. Solutions are shown in the [[GMS:Project Explorer|Project Explorer]] as a folder with an lock on it [[Image:Tree_Folder_Lock.gif]]. If a solution is transient then the time steps are displayed in the [[GMS:The GMS Screen|Times Step Window]]. Data sets can not be moved into or out of a solution folder. Also, the solution may contain text files such as the *.out and *.glo files produced by MODFLOW. These files can viewed by right clicking on the item and selecting '''View File''' from the pop up menu, or you can double click on the item.
Solutions are output from a [[GMS:Numerical Models|numerical model]] that GMS supports. Solutions are shown in the [[GMS:Project Explorer|Project Explorer]] as a folder with a lock on it [[File:Generic Folder Locked.svg|16 px]]. If a solution is transient then the time steps are displayed in the [[GMS:The GMS Window#Time_Steps_Window|Times Steps Window]]. Datasets cannot be moved into or out of a solution folder. Also, the solution may contain text files such as the *.out and *.glo files produced by MODFLOW. These files can be viewed by right-clicking on the [[File:External Text File Icon.svg|14 px]] item and selecting '''View File''' from the pop-up menu, or by double-clicking on the item.


Clicking on a solution or data set makes that item "active" and the display is automatically updated in the GMS window.
Clicking on a solution or dataset makes that item "active" and the display is automatically updated in the GMS window.


=== Folder ===
=== Folder ===


The data sets and solutions are organized by folders. The user can create new folders and move data sets, solutions, and folders to other folders anywhere on the [[GMS:Project Explorer|Project Explorer]]. Folders can be created by right clicking on the certain items in the [[GMS:Project Explorer|Project Explorer]] and selecting '''New Folder''' in the menu. A data set or folder can be deleted simply by selecting the folder and selecting the Delete key or by right-clicking on the item and selecting the '''Delete''' option in the corresponding pop-up menu. Statistics about a data set can be viewed by right-clicking on a data set and selecting the Properties option from the pop-up menu.
The datasets and solutions are organized by folders. The user can create new folders and move datasets, solutions, and folders to other folders anywhere on the [[GMS:Project Explorer|Project Explorer]]. Folders can be created by right-clicking on the certain items in the [[GMS:Project Explorer|Project Explorer]] and selecting '''New Folder''' in the menu. A dataset or folder can be deleted by selecting the folder and selecting the ''Delete'' key or by right-clicking on the item and selecting the '''Delete''' option in the corresponding pop-up menu. Statistics about a dataset can be viewed by right-clicking on a dataset and selecting the '''Properties''' option from the menu.


{{Navbox GMS}}
{{Navbox GMS}}
[[Category:GMS Dialogs|D]]
[[Category:Datasets]]
[[Category:Project Explorer]]

Latest revision as of 17:14, 3 May 2022


A dataset is a set of values associated with each node, cell, vertex, or scatter point in an object. A dataset can be steady state (one value per item) or transient (one value per item per time step). The values in the dataset can be scalar values or vector values. Certain types of objects in GMS have an associated list of scalar datasets and a list of vector datasets. Each of the following objects in GMS can have both scalar and vector datasets:

The following objects can only have scalar datasets:

The commands for manipulating datasets are located in the Edit menu.

Datasets are used for both pre- and post-processing of models. For example, a scalar dataset associated with a 3D grid can represent starting values of head or values of hydraulic conductivity for a groundwater modeling problem. Another dataset associated with the same grid may represent computed head values. Datasets can be used to generate contours, isosurfaces, vector plots, and animation sequences.

Generating Datasets

Datasets are generated in a variety of ways. They can represent output from a groundwater model (head, drawdown, etc.). They can represent tabular values in a text file entered manually or exported from another application such as GIS. They can be created by interpolating from a scatter point set to a TIN, grid, or mesh. Datasets can also be generated by performing mathematical operations on other datasets with the Data Calculator.

One advantage of the dataset list approach for managing information is that it facilitates transfer of information between different types of models or models with differing resolution. This is accomplished through scatter point sets and interpolation. TINs, borehole contacts, borehole sample data, grids, and meshes can all be converted to a 2D or 3D scatter point set. When an object is converted to a scatter point set, all scalar datasets associated with the object are copied to the new scatter point set. The datasets can then be transferred from the scatter point set group to other objects of any type using one of the supported interpolation schemes.

Importing/Exporting Datasets

To export a dataset, right-click on the dataset in the Project Explorer and select the Export command. The Save As dialog has three filter types that can be exported:

  • Binary Dataset Files (*.dat)
  • ASCII Dataset Files (*.dat)
  • HDF5 Dataset Files (*.h5)

To import a dataset, right-click on any of the objects explained above in the Project Explorer and select the Import Dataset command. This command brings up the File Open dialog.

Project Explorer

Datasets are displayed and managed in the Project Explorer.

Active Dataset

Each object (TIN, grid, mesh, or scatter point set) in GMS has a set of values which is designated as the "active dataset." The active dataset is an important part of model visualization in GMS. Each time the display is refreshed, the contours and other display features are generated using the active dataset.

The active dataset and time step are displayed in the Project Explorer. Clicking on a solution or dataset in the Project Explorer makes that item "active" and the display is automatically updated in the GMS window. The table below shows the icons displayed next to the active datasets.

Dataset Cells Active.svg active scalar dataset on cells
Dataset Points Active.svg active scalar dataset on points
Vector Dataset Active.svg active vector dataset
CCF Dataset Active.svg active ccf dataset

Dataset Info

Example of the Dataset Info dialog

Selecting the Dataset Info command in the right-click menu on a dataset in the Project Explorer brings up the Dataset Info dialog. The components of the dialog are as follows:

Statistics

A set of statistics related to the active dataset and the active time step is displayed on the left side of the Dataset Info dialog. The statistics for all time steps can be shown by selecting the Show all time step stats checkbox. To see info for multiple time steps, expand the Dataset Info dialog horizontally or scroll horizontally in the Time step table. A histogram of the active data values is displayed on the right side. The histogram shows the value intervals on the x-axis, and the number of occurrences within that interval on the y-axis. For example, the head output dataset histogram from a MODFLOW model will show the number of active cells with final head values within a given interval. The Intervals setting at the bottom of the histogram adjusts the number of intervals displayed along the x-axis.

View/Edit Values

For datasets associated with model solutions, the data values can be displayed in a spreadsheet using the View Values button. For all other datasets, the button label changes to Edit Values and the spreadsheet can be used to change the dataset values.

Active/Inactive Flags

If the currently selected module is the 3D Grid module, the active/inactive status of cells can be changed by selecting the Edit button at the bottom left of the dialog. This brings up the Active/Inactive Flags dialog.

Date/Time Display

For a transient dataset, the time values can be displayed in the Time Steps Window using either a relative time format (e.g., 100.0) or using a date/time format (e.g., 1/12/1998 3:23:48). The relative times are computed using a reference time that is defined for the model (MODFLOW, FEMWATER etc.). The reference time represents the date/time corresponding to t=0.

Datasets in the Project Explorer

The solutions and datasets associated with a particular object (grid, mesh, scatter point set, etc.) are managed using the Project Explorer.

Datasets

Three different types of datasets are shown in the Project Explorer: scalar, vector, and CFF. For scalar datasets, they can be associated with either cells or points. The icons used to identify the datasets are shown below.

Dataset Type Active Inactive
scalar dataset on cells Dataset Cells Active.svg Dataset Cells Inactive.svg
scalar dataset on points Dataset Points Active.svg Dataset Points Inactive.svg
vector dataset Vector Dataset Active.svg Vector Dataset Inactive.svg
ccf dataset CCF Dataset Active.svg CCF Dataset Inactive.svg

If the active dataset is transient then the time steps are displayed in the Time Steps Window.

Solutions

Solutions are output from a numerical model that GMS supports. Solutions are shown in the Project Explorer as a folder with a lock on it Generic Folder Locked.svg. If a solution is transient then the time steps are displayed in the Times Steps Window. Datasets cannot be moved into or out of a solution folder. Also, the solution may contain text files such as the *.out and *.glo files produced by MODFLOW. These files can be viewed by right-clicking on the External Text File Icon.svg item and selecting View File from the pop-up menu, or by double-clicking on the item.

Clicking on a solution or dataset makes that item "active" and the display is automatically updated in the GMS window.

Folder

The datasets and solutions are organized by folders. The user can create new folders and move datasets, solutions, and folders to other folders anywhere on the Project Explorer. Folders can be created by right-clicking on the certain items in the Project Explorer and selecting New Folder in the menu. A dataset or folder can be deleted by selecting the folder and selecting the Delete key or by right-clicking on the item and selecting the Delete option in the corresponding pop-up menu. Statistics about a dataset can be viewed by right-clicking on a dataset and selecting the Properties option from the menu.