GMS:Preferences: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(51 intermediate revisions by 3 users not shown)
Line 1: Line 1:
{{Hide in print|[[File:PreferencesGeneral.jpg|thumb|450 px|The ''Preference'' dialog showing the ''General'' tab]]}}
The ''Edit'' | '''Preferences''' command brings up the ''Preferences'' dialog.
The ''Edit'' | '''Preferences''' command brings up the ''Preferences'' dialog.


==General==
==General==
The ''General'' tab has all the of the general options in GMS.
[[File:PreferencesGeneral.png|thumb|450 px|The ''Preference'' dialog showing the ''General'' tab]]
*''Show welcome dialog on startup'' – When turned off, the welcome dialog will not appear when starting GMS.
The ''General'' tab has all of the general options in GMS.
<!--*''Show welcome dialog on startup'' &ndash; When turned off, the welcome dialog will not appear when starting GMS.-->
*''Check for newer version on startup'' &ndash; When turned on, GMS will check aquaveo.com downloads page for the most recent release of GMS. If a new release is found, a prompt will appear asking if wanting to download the newer release.
*''Check for newer version on startup'' &ndash; When turned on, GMS will check aquaveo.com downloads page for the most recent release of GMS. If a new release is found, a prompt will appear asking if wanting to download the newer release.
*''Confirm Deletions'' &ndash; Choose whether or not to be prompted to confirm the deletion whenever a set of selected objects is about to be deleted. This is meant to ensure that objects are not deleted accidentally.
*''Confirm Deletions'' &ndash; Choose whether or not to be prompted to confirm the deletion whenever a set of selected objects is about to be deleted. This is meant to ensure that objects are not deleted accidentally.
Line 11: Line 11:
*''Show new project wizard on startup'' &ndash; Shows the ''New Project'' dialog on startup. -->
*''Show new project wizard on startup'' &ndash; Shows the ''New Project'' dialog on startup. -->
*''Invert mouse wheel zoom'' &ndash; Changes direction of the zoom with the mouse wheel
*''Invert mouse wheel zoom'' &ndash; Changes direction of the zoom with the mouse wheel
*''Create GMS notes automatically'' &ndash; When on, certain actions will cause [[GMS:Notes#Automatic_Notes|notes]] to be automatically generated.
*''Icon size'' &ndash; Specifies the display size for icons.
**"Auto" &ndash; The default icon display size.
**"Small" &ndash; Causes the icons to be displayed at a smaller size; around 9 pixels wide.
**"Large" &ndash; Causes the icons to be displayed at a larger size; around 27 pixels wide.
Sections:
Sections:
*''File compression'' &ndash; Use compression when saving XMDF files.  The compression factor can be specified.
*''File compression'' &ndash; Use compression when saving XMDF files.  The compression factor can be specified.
*''[[GMS:Project Explorer|Project Explorer]]'' &ndash; Allows modifying preferences related to the Project Explorer.  
*''[[GMS:Project Explorer|Project Explorer]]'' &ndash; Allows modifying preferences related to the Project Explorer.  
<blockquote style="margin-top:0px; margin-bottom:0px;">
**''Change Module when Project Explorer selection changes'' &ndash; Changes the current module when an item is selected in the Project Explorer. This option is on by default.
*''Change Module when tree selection changes'' &ndash; Changes the current module when a item is selected in the Project Explorer. This option is on by default.
**''Scroll Project Explorer when changing module'' &ndash; Ensures the visibility of the Project Explorer item objects in a module when the module is changed.
*''Scroll Project Explorer when changing module'' &ndash; Ensures the visibility of the tree item objects in a module when the module is changed.
**''Synchronize active dataset and Z elevations for TINs, 2D Meshes, 2D Grids, and 2D Scatter Sets''
*''Synchronize active dataset and Z elevations for TINs, 2D Meshes, 2D Grids, and 2D Scatter Sets''
**''Simulation right-click menu options'' &ndash; Select '''Edit...''' to open the ''Simulation Menu Preferences'' dialog. This allows for adjusting options that will appear when right-clicking a simulation in the Project Explorer. Not all options are compatible with every model. [[File:GMS_Simulation_Menu_Preferences.png|thumb|325 px| The ''Simulation Menu Preferences'' dialog.]]
</blockquote>
*''Contouring'' &ndash; Allows entering a filled contour tolerance.
*''Contouring'' &ndash; Allows entering a filled contour tolerance.
*''North arrow path'' &ndash; Specify the path to the folder containing the North Arrows.
*''North arrow path'' &ndash; Specify the path to the folder containing the [[GMS:Annotations#North_Arrows|North Arrows]].
*''Help'' &ndash; Options to use local help or online help. Online help is the default option.
*''Model Run'' &ndash; Options for processes that can run in conjunction with the model run.
**''Run checks before adding to Run Queue'' &ndash; When turned on, the model check will run before the model is added to the run queue. If errors are found, a prompt will appear and the model will not be added to the Run Queue.
**''Prompt before unloading solution datasets'' &ndash; When turned on, a warning will appear if the solution datasets need to be removed from the project before the model can run, for example when running the same simulation again. When turned off, the solution datasets will be removed without any warning.
<!--*''Help'' &ndash; Options to use local help or online help. Online help is the default option.-->


Buttons at the bottom:
Buttons at the bottom:
*'''Help...''' &ndash; Specify to use either a local help file or the online help file when clicking on the '''Help''' button in any dialog.
*'''Help...''' &ndash; Opens xmswiki.com to this page (GMS:Preferences). <!--Specify to use either a local help file or the online help file when clicking on the '''Help''' button in any dialog.-->
*'''Restore Factory Preferences''' &ndash; Reverts all settings to the factory defaults.
*'''Restore Factory Preferences''' &ndash; Reverts all settings to the factory defaults.
*'''OK''' &ndash; Accepts the settings as selected and entered and closes the ''Preferences'' dialog.
*'''OK''' &ndash; Accepts the settings as selected and entered. Closes the ''Preferences'' dialog.
*'''Cancel''' &ndash; Close the ''Preferences'' dialog without saving any changes to the settings.
*'''Cancel''' &ndash; Close the ''Preferences'' dialog without saving any changes to the settings.
{{-}}
==2D Mesh==
The ''2D Mesh'' tab has the following options:
*Interpolate for default z on interior
::Default z (ft)
*Assign default z-value
*Prompt for z-value
*Insert nodes into triangulated mesh
*Check for coincident nodes
*Retriangulate voids when deleting
*Thin triangle aspect ratio
*Min interior angel for merging triangles
For more information, see [[GMS:2D Mesh Settings|2D Mesh Settings]].
{{-}}
==Boreholes==
[[File:PreferencesBoreholes.png|thumb|450 px|The ''Prefences'' dialog showing the ''Borehole'' tab.]]
*[[GMS:Horizons#Automatic¬_Assignment|''Auto-assign Horizons'']] &ndash; Options for settings related to the ''Boreholes'' | '''Auto-assign Horizons…''' command.
**''Rows per lift''
**''Row overlapped between lifts''
**''Sets retained between lifts''
**''Measure slope from borehole tips''
**''Average horizon slope''
**''Horizon slope weight''
**''Gap weight''
*[[GMS:Borehole Cross Sections# Automatic_Editing|Auto-Fill cross sections]] <!--&ndash; These are the settings for when the ''Boreholes'' | '''Auto-Fill Blank Cross Sections''' command gets used. Some also affect the ''Boreholes'' | '''Auto-Create Blank Cross Sections''' command.-->
**''Prompt for vertex spacing'' &ndash; Option for GMS to open a dialog to prompt for the desired vertex spacing. It prompts for the desired spacing in the units set for the project.
**''Do not redistribute vertices'' &ndash; Option for GMS to not redistribute the vertices.
**''Use default spacing'' &ndash; GMS will redistribute vertices without prompting using a default ratio defined in the ''Default spacing/length ratio'' option.
***''Default spacing/length ratio'' &ndash; The default ratio used by GMS to calculate vertices placement when ''Use default spacing'' is selected.
**''Max. lense thickness ratio''
{{-}}
==Graphics==
*''Multisampling level'' &ndash; Bigger numbers result in smoother, antialiased graphics. 0 = no multisampling, 16 = maximum multisampling. If this option is changed, GMS must be restarted before the change will take effect.
*''Use smooth fonts'' &ndash; anti-alias fonts
'''''Obsolete Options'''''
The following options are not in use in current versions of GMS, but apply to older versions.
*Ask which library to use if system does not support all functionality
*Autoselect the software library if system does support all functionality
*Always use system library like a dedicated GPU (may not support all features)
*Always use software library on the CPU (may be slower)
:[[File:PreferencesGraphics.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Graphics'' tab]]
{{-}}
==Images / CAD==
*''Draw Order''
::Allows determining the vertical location of objects when being drawn.
*''Bitmap Scale Factor''
::When the copy command is selected, a bitmap image of the screen is placed on the clipboard.  The scale factor can be used to increase or decrease the resolution of the bitmap.  This scale factor also applies when saving the image as a bitmap.
*''Confirm scale factor before copying''
:::Select this for GMS to confirm the scale factor each time the ''Edit'' | '''Screen Capture…''' command is used.
*''Draw points and symbols as points''
:::CAD points and symbols will be drawn as points in the GMS Graphics Window. Note that these are sometimes very difficult to see.
*''Draw points and symbols as shapes''
:::CAD points and symbols will be drawn as shapes in the GMS Graphics Window.
*''Specify CAD symbol size''
:::The size of the CAD symbol shape display can be specified. May require clicking on ''Draw points and symbols as shapes'' button to activate (even if ''Draw points and symbols as shapes'' is already selected). Option not available when CAD points and symbols are drawn as points.
:[[File:PreferencesImagesCAD.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Images / CAD'' tab]]
{{-}}
==Map==
*''Snap feature objects to displayed nodes and vertices''
::Select for arcs to align (snap) to displayed nodes and vertices from other displayed coverages while the arcs are being drawn. When using the '''Create Arc''' tool, getting close to nodes or vertices from a displayed coverage causes a red box to appear. Place the arc node or vertex inside the red box, and it aligns the feature just created to the feature from the other coverage. If a coverage is not displayed, then the arc will not align to features from that coverage. If unselected, the red boxes will not appear for any nodes or vertices inside any coverage. Snapping will still occur with nodes and vertices of the same coverage, but not with those of other coverages.
*''Automatically perform the '''Map&rarr;SEEP2D''' command after editing attributes.''
::Gives the option to automatically perform the '''Map&rarr;SEEP2D''' command.
:[[File:PreferencesMap.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Map'' tab.]]
{{-}}


==Model Executables==
==Model Executables==
[[File:PreferencesModEx.png|thumb|450 px|The ''Preferences'' dialog showing the ''Models'' options]]
The ''Models'' page allows specifying the location of model executables, as well as the option to use the Model Wrapper.
The ''Models'' page allows specifying the location of model executables, as well as the option to use the Model Wrapper.
*''Model Wrapper''
*''Model Wrapper''
<blockquote style="margin-top:0px; margin-bottom:0px;"> GMS is a pre- and post-processor for [[GMS:Numerical Models|Numerical Models]].  Most of these numerical models are run externally in the DOS environment.  The default option is to use the Model Wrapper. The Model Wrapper "wraps" itself around the same DOS executables and gives more model feedback including graphs and tables. The Model Wrapper includes a toggle box in the bottom left that, when checked and after exiting the Model Wrapper, GMS will automatically read in the results of the solution. This toggle will only be checked by default if the model converged. The option to use the Model Wrapper or the old DOS view is included in the ''Preferences'' dialog.  Certain models, including [[GMS:Stochastic Modeling|Stochastic]] and inverse modeling, can only be run using the Model Wrapper.</blockquote>
:: GMS is a pre- and post-processor for [[GMS:Numerical Models|Numerical Models]].  Most of these numerical models are run externally in the DOS environment.  The default option is to use the Model Wrapper. The Model Wrapper "wraps" itself around the same DOS executables and gives more model feedback including graphs and tables. The Model Wrapper includes the option to tell GMS to automatically read in the results of the solution upon exiting the Model Wrapper. The box to select this options is in the bottom left of the Model Wrapper. This box will only be checked by default if the model converged. The option to use the Model Wrapper or the old DOS view is included in the ''Preferences'' dialog.  Certain models, including [[GMS:Stochastic Modeling|Stochastic]] and inverse modeling, can only be run using the Model Wrapper.


Parallel versions of MODFLOW-2000, MODFLOW-2005, and SEAWAT are shipped with GMS to run simulations. Beginning with version 8, GMS ships parallel versions where the SAMG solver has been parallelized. Even when this option is on, when running Parallel PEST with MODFLOW the serial (non-parallel) version of MODFLOW will be used since the Parallel PEST will use all of the available cores on the computer with the serial version.  Also see [[GMS:Preferences#MODFLOW|MODFLOW preferences]] for an option to turn on or off the parallel version.
Parallel versions of MODFLOW-2000, MODFLOW-2005, and SEAWAT are shipped with GMS to run simulations. Beginning with version 8, GMS ships parallel versions where the SAMG solver has been parallelized. Even when this option is on, when running Parallel PEST with MODFLOW the serial (non-parallel) version of MODFLOW will be used since the Parallel PEST will use all of the available cores on the computer with the serial version.  Also see [[GMS:Preferences#MODFLOW|MODFLOW preferences]] for an option to turn on or off the parallel version.


[[File:PreferencesModEx.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''Models'' options]]
:Note: the default directory location for most model executables is: C:\Program Files\GMS **.* 64-bit\python\Lib\site-packages
{{-}}


==MODFLOW==
==MODFLOW==
[[File:PreferencesMODFLOW.png|thumb|450 px|The ''Preferences'' dialog showing the ''MODFLOW'' tab.]]
The ''MODFLOW'' page has options related to the MODFLOW interface in GMS.
The ''MODFLOW'' page has options related to the MODFLOW interface in GMS.


*''Reverse mini-grid increment''
*''Reverse mini-grid increment''
<blockquote style="margin-top:0px; margin-bottom:0px;">The default functionality of the arrows next to the edit field on the mini-grid tool bar is for the up arrow to increase the layer number and for the down arrow to decrease the layer number. This option changes direction of the arrows so that down will increase the layer number and up will decrease the layer number.</blockquote>
::The default functionality of the arrows next to the edit field on the mini-grid tool bar is for the up arrow to increase the layer number and for the down arrow to decrease the layer number. This option changes direction of the arrows so that down will increase the layer number and up will decrease the layer number.
*''Compress MODFLOW H5 files''
*''Compress MODFLOW h5 files''
<blockquote style="margin-top:0px; margin-bottom:0px;">This option will force the H5 files saved with MODFLOW to be compressed. Generally this option should be turned on.</blockquote>
::This option will force the h5 files saved with MODFLOW to be compressed. Generally this option should be turned on.
*''Create h5 copy of head solution''
*''Create h5 copy of head solution''
<blockquote style="margin-top:0px; margin-bottom:0px;">Turning on this option can speed up reading the MODFLOW head solution especially when there are a large number of stress periods.  When this option is on, GMS writes an HDF5 copy of the MODFLOW head solution upon reading it the first time.  The following times GMS reads the head solution, it doesn't take as much time.</blockquote>
::Turning on this option can speed up reading the MODFLOW head solution especially when there are a large number of stress periods.  When this option is on, GMS writes an HDF5 copy of the MODFLOW head solution upon reading it the first time.  The following times GMS reads the head solution, it doesn't take as much time.
*''Create cell summary text file''
*''Create cell summary text file''
<blockquote style="margin-top:0px; margin-bottom:0px;">A text file is created when reading the MODFLOW head file that provides a summary of the the number of active, inactive, dry, and flooded cells at each output time of the simulation. The text file is added to the MODFLOW solution and can be opened from the Project Explorer.</blockquote>
::A text file is created when reading the MODFLOW head file that provides a summary of the the number of active, inactive, dry, and flooded cells at each output time of the simulation. The text file is added to the MODFLOW solution and can be opened from the Project Explorer.
*''Save copy of MODFLOW simulation in native text format''
*''Save copy of MODFLOW simulation in native text format''
<blockquote style="margin-top:0px; margin-bottom:0px;">This option will create an additional MODFLOW directory when the GMS project is saved that will contain native MODFLOW text files of the MODFLOW simulation. The new directory will be named as follows ''myProject''_MODFLOW_text. There are three additional preferences with this option: all arrays be written internally in the MODFLOW files (default option), all arrays are external from the MODFLOW files, or all arrays are external and are placed in a directory named ''arrays''. </blockquote>
::This option sets the default for the ''Save native text copy'' option in the [[GMS:Global Options/Basic Package|''MODFLOW Global/Basic Package'']] dialog. New models will be set to create an additional MODFLOW directory that contains native MODFLOW text files of the MODFLOW simulation. GMS will create the new directory when the GMS project is saved and will be named as follows ''myProject''_MODFLOW_text. This option does not change the settings for the current MODFLOW model. Settings for the current model must be adjusted in the ''MODFLOW Global/Basic Package'' dialog. There are three additional preferences with this option: all arrays be written internally in the MODFLOW files (default option), all arrays are external from the MODFLOW files, or all arrays are external and are placed in a directory named ''arrays''.  
<blockquote style="margin-top:4px; margin-bottom:0px;">
::External arrays are placed in their own text files and are named as follows ''myProject_array_PACKAGE_VARIABLE_LAYERorSP''. For example the ibound array for layer 1 would have the following name ''myProject_array_BAS_IBOUND_1.txt''. The recharge array for stress period 3 would have the following name ''myProject_array_RCH_RECH_3.txt''.
External arrays are placed in their own text files and are named as follows ''myProject_array_PACKAGE_VARIABLE_LAYERorSP''. For example the ibound array for layer 1 would have the following name myProject_array_BAS_IBOUND_1.txt. The recharge array for stress period 3 would have the following name myProject_array_RCH_RECH_3.txt.</blockquote>
*''Save copy of MODFLOW simulation in MODFLOW 6 format''
 
::This option sets the default for the ''Save MODFLOW 6 copy'' option in the ''MODFLOW Global/Basic Package'' dialog. New models will be set to create an additional MODFLOW directory that contains MODFLOW 6 files of the MODFLOW simulation. GMS will create the new directory when the GMS project is saved and will be named as follows ''myProject''_MODFLOW_mf6. This option does not change the settings for the current MODFLOW model. Settings for the current model must be adjusted in the ''MODFLOW Global/Basic Package'' dialog.
*''Use custom Run dialog when running MODFLOW''
*''Use custom Run dialog when running MODFLOW''
<blockquote style="margin-top:0px; margin-bottom:0px;">This option will bring up the [[GMS:Custom Run MODFLOW|Custom Run MODFLOW]] dialog when the ''MODFLOW'' | '''Run MODFLOW''' menu command is selected.</blockquote>
::This option sets the default for the ''Use custom Run dialog'' option in the ''MODFLOW Global/Basic Package'' dialog. New models will be set for the [[GMS:Custom Run MODFLOW|Custom Run MODFLOW]] dialog to appear when running MODFLOW. This default will apply to all new models. This does not change the preferences for the current model, which must be changed in the ''MODFLOW Global/Basic Package'' dialog
*''Warn when switching to USG-Transport that it is one way''
::Select for GMS to warn when switching to [[GMS:MODFLOW-USG Transport|USG-Transport]] that the model cannot be changed back to other MODFLOW versions. This warning will appear when ''USG-Transport'' is selected in the [[GMS:Global Options/Basic Package|''MODFLOW Global/Basic Package'' dialog]] after '''OK''' is clicked to close the dialog. It's on by default.
*''Default version of MODFLOW to run''
*''Default version of MODFLOW to run''
<blockquote style="margin-top:0px; margin-bottom:0px;">Allows selecting the version of MODFLOW to be used as a default when GMS is started.</blockquote>
::Allows selecting the version of MODFLOW to be used as a default when GMS is started.
*''Double precision''
*''Double precision''
<blockquote style="margin-top:0px; margin-bottom:0px;">When this option is on, GMS will use the double precision version of MODFLOW to run simulations. By default this option is off and GMS uses the single precision version of MODFLOW.</blockquote>
::When this option is on, GMS will use the double precision version of MODFLOW to run simulations. By default this option is off and GMS uses the single precision version of MODFLOW.
*''Parallel'' (not used by Parallel PEST)
*''Parallel'' (not used by Parallel PEST)
<blockquote style="margin-top:0px; margin-bottom:0px;">When this option is on, GMS will use the parallel version of MODFLOW to run simulations. Beginning with version 8, GMS ships parallel versions of MODFLOW where the SAMG solver has been parallelized. Even when this option is on, Parallel PEST will use the serial (non-parallel) version of MODFLOW since the Parallel PEST will use all of the available cores on the computer.</blockquote>
::When this option is on, GMS will use the parallel version of MODFLOW to run simulations. Beginning with version 8, GMS ships parallel versions of MODFLOW where the SAMG solver has been parallelized. Even when this option is on, Parallel PEST will use the serial (non-parallel) version of MODFLOW since the Parallel PEST will use all of the available cores on the computer.
 
{{-}}
[[File:PreferencesMODFLOW.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''MODFLOW'' tab.]]
 
==Images / CAD==
*Bitmap Scale Factor
<blockquote style="margin-top:0px; margin-bottom:0px;">When the copy command is selected, a bitmap image of the screen is placed on the clipboard.  The scale factor can be used to increase :or decrease the resolution of the bitmap.  This scale factor also applies when saving the image as a bitmap.</blockquote>
*CAD Symbol Size
<blockquote style="margin-top:0px; margin-bottom:0px;">The size of the CAD symbol display can be specified.</blockquote>
 
[[File:PreferencesImagesCAD.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''Images / CAD'' tab]]


==Printing==
==Printing==
Specifies scaling points, lines, and fonts while printing.
Specifies scaling points, lines, and fonts while printing.
[[File:PreferencesPrinting.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''Printing'' tab]]
:[[File:PreferencesPrinting.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Printing'' tab]]
{{-}}


==Program Mode==
==Program Mode==
[[File:PreferencesProgMode.jpg|thumb|400 px|The ''Preferences'' dialog showing the ''Program Mode'' tab.]]
[[File:PreferencesProgMode.png|thumb|400 px|The ''Preferences'' dialog showing the ''Program Mode'' tab.]]
GMS has the option of changing the "mode" or "skin" that GMS is running. The purpose of the mode is to simplify the items available in the interface.
GMS has the option of changing the "mode" or "skin" that GMS is running. The purpose of the mode is to simplify the items available in the interface.


===Available Modes===
===Available Modes===
* GMS
* GMS
<blockquote style="margin-top:0px; margin-bottom:0px;">This is the default mode.</blockquote>
::This is the default mode.
* GMS 2D
* GMS 2D
<blockquote style="margin-top:0px; margin-bottom:0px;">GMS 2D is for only using GMS to do seepage and slope stability. In GMS 2D mode the only tools that are available are the 2D mesh and the Map. There are several changes to the GMS interface when in this mode, including:
::GMS 2D is for only using GMS to do seepage and slope stability. In GMS 2D mode, the only tools that are available are the 2D mesh and the Map. There are several changes to the GMS interface when in this mode, including:
<blockquote style="margin-top:0px; margin-bottom:0px;">
::#Hiding of tools and modules not in use
#Hiding of tools and modules not in use
::#SEEP2D model automatically initialized from conceptual model
#SEEP2D model automatically initialized from conceptual model
::#SEEP2D boundary conditions automatically mapped from conceptual model (no need to run Map &rarr; SEEP2D)
#SEEP2D boundary conditions automatically mapped from conceptual model (no need to run Map &rarr; SEEP2D)
::#Easily create all coverage types in one step
#Easily create all coverage types in one step
::#Feature object types automatically assigned based on coverage attributes
#Feature object types automatically assigned based on coverage attributes
::#Allows only one conceptual model
#Allow only one conceptual model
</blockquote>


When starting up in GMS 2D mode, a ''New Project'' dialog will appear. The following errors may also appear when opening some project files. These errors may state any of the following:
When starting up in GMS 2D mode, a ''New Project'' dialog will appear. The following errors may also appear when opening some project files. These errors may state any of the following:
<blockquote style="margin-top:0px; margin-bottom:0px;">
<!-- Please do not change the following bullet points. These are exact quotes from the error messages. Thanks! -->
<!-- Please do not change the following bullet points. These are exact quotes from the error messages. Thanks! -->
*Your project file contained more than one conceptual model. This version of GMS only supports one SEEP2D/UTEXAS conceptual model. The first encountered SEEP2D/UTEXAS conceptual model has been preserved and all other conceptual models have been removed from the project.
:*Your project file contained more than one conceptual model. This version of GMS only supports one SEEP2D/UTEXAS conceptual model. The first encountered SEEP2D/UTEXAS conceptual model has been preserved and all other conceptual models have been removed from the project.
*Error. This requires the "MODFLOW" component. Your GMS license does not include this component. Contact your vendor if you would like to enable this feature.
:*Error. This requires the "MODFLOW" component. Your GMS license does not include this component. Contact your vendor if you would like to enable this feature.
*The project that you are reading does not have a SEEP2D/UTEXAS conceptual model. The project can not be loaded into this version of GMS.
:*The project that you are reading does not have a SEEP2D/UTEXAS conceptual model. The project can not be loaded into this version of GMS.
</blockquote></blockquote>
* GMS Site
* GMS Site
<blockquote style="margin-top:0px; margin-bottom:0px;">GMS Site is for only using tools for site characterization. As such the tools available in this mode are TINs, Boreholes, Solids, 2D Scatter, and Map. These tools can be used to construct solid models of stratigraphy.</blockquote>
::GMS Site is for only using tools for site characterization. As such the tools available in this mode are TINs, Boreholes, Solids, 2D Scatter, and Map. These tools can be used to construct solid models of stratigraphy.
* TPROGS
* TPROGS
<blockquote style="margin-top:0px; margin-bottom:0px;">[[GMS:T-PROGS|T-PROGS]] is used to perform transition probability geostatistics on borehole data.</blockquote>
::[[GMS:T-PROGS|T-PROGS]] is used to perform transition probability geostatistics on borehole data.


===Caveats===
===Caveats===
When GMS is running in a particular mode then only data associated with the available tools will be read into GMS. For example, if having a GMS project file that contains a 3D Grid, and running in "GMS 2D" mode then when reading in the project file a message will appear stating that GMS is not enabled to read in 3D Grid data. The only data that will read into GMS in "GMS 2D" mode is data associate with the 2D Mesh and the Map.
When GMS is running in a particular mode then only data associated with the available tools will be read into GMS. For example, attempting to read in a GMS project that contains a 3D Grid while in "GMS 2D" mode will produce an error message. The message will state that GMS is not enabled to read in 3D Grid data. The only data that will read into GMS in "GMS 2D" mode is data associated with the 2D Mesh and the Map.
{{-}}
 
==Scatter sets==
''2D scatter''
*''Default dataset value''
::Sets default value for new points created in dataset.
*''Confirm dataset value''
::Select for option to set value of each new point created in a dataset. When selected, a ''Scatter Point Dataset Value'' dialog will open each time a new point is created. It will automatically populate with the current value from the ''Default dataset value'' field but can be edited.
''3D scatter''
*''Default dataset value''
::Sets default value for new points created in dataset.
*''Default Z value''
::Sets default Z value for new points created in dataset.
*''Confirm dataset value''
::Select for option to set value of each new point created in a dataset. When selected, a ''Scatter Point Dataset Value'' dialog will open each time a new point is created.
:[[File:PreferencesScatterSet.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Scatter Sets'' tab.]]
{{-}}


==Map==
==SEAWAT==
[[File:PreferencesMap.jpg|thumb|450 px|The ''Preferences'' dialog showing the ''Map'' tab.]]
''Default version of SEAWAT to run''
Gives the option to automatically perform the '''Map&rarr;SEEP2D''' command.
:''Parallel (only SAMG solver parallelized)'' &ndash; Option to run some parts of the SEAWAT process in parallel to speed up computation time.
[[File:PreferencesSEAWAT.jpg|left|thumb|450px|The ''SEAWAT'' tab of the ''Preferences'' dialog.]]
{{-}}


==TINs==
==TINs==
The ''TINs'' tab has the following options:
The ''TINs'' tab has the following options:
*Vertex options
*Vertex options
<blockquote style="margin-top:0px; margin-bottom:0px;">
**Retriangulate after deleting
*Retriangulate after deleting
***Default z-value
<blockquote style="margin-top:0px; margin-bottom:0px;">Default z-value</blockquote>
**Confirm z-value
*Confirm z-value
**Interpolate for default z on interior
*Interpolate for default z on interior
**Extrapolate for default z on exterior
*Extrapolate for default z on exterior
**Breakline options
</blockquote>
***Add supplementary points
*Breakline options
***Swap edges
<blockquote style="margin-top:0px; margin-bottom:0px;">
*Add supplementary points
*Swap edges
</blockquote>
*Minimum length ratio
*Minimum length ratio


For more detailed information, see [[GMS:TIN Settings|TIN Settings]].
For more detailed information, see [[GMS:TIN Settings|TIN Settings]].
{{-}}


==Boreholes==
==Licensing==
[[File:PreferencesBoreholes.jpg|thumb|450 px|The ''Prefences'' dialog showing the ''Borehole'' tab.]]
This tab shows information about the application license.
*Auto-assign horizons
*''Use Legacy Licensing'' &ndash; Turning on will revert to using older licenses.
<blockquote style="margin-top:0px; margin-bottom:0px;">Rows per lift </blockquote>
*''Information'' &ndash; Shows information about the license being used.
<blockquote style="margin-top:0px; margin-bottom:0px;">Row overlapped between lifts </blockquote>
:[[File:PreferencesLicensing.png|thumb|left|450 px|The ''Preferences'' dialog showing the ''Licensing'' tab]]
<blockquote style="margin-top:0px; margin-bottom:0px;">Sets retained between lifts </blockquote>
{{-}}
*Measure slope from borehole tips
<blockquote style="margin-top:0px; margin-bottom:0px;">Average horizon slope</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">Horizon slope weight</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">Gap weight </blockquote>
*Auto-Fill cross sections
<blockquote style="margin-top:0px; margin-bottom:0px;">
*Prompt for vertex spacing
*Do not redistribute vertices
*Use default spacing
</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">Default spacing/length ratio</blockquote>
<blockquote style="margin-top:0px; margin-bottom:0px;">Max. lense thickness ratio</blockquote>
 
==Scatter sets==
*2D scatter
<blockquote style="margin-top:0px; margin-bottom:0px;">
*Default dataset value
*Confirm dateset value</blockquote>
*3D scatter
<blockquote style="margin-top:0px; margin-bottom:0px;">
*Default dataset value
*Default Z value
*Confirm dateset value</blockquote>
 
[[File:PreferencesScatterSet.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''Scatter Sets'' tab.]]
 
==2D Mesh==
The ''2D Mesh'' tab has the following options:
*Interpolate for default z on interior
<blockquote style="margin-top:0px; margin-bottom:0px;">Default z (ft)</blockquote>
*Assign default z-value
*Prompt for z-value
*Insert nodes into triangulated mesh
*Check for coincident nodes
*Retriangulate voids when deleting
<blockquote style="margin-top:0px; margin-bottom:0px;">Thin triangle aspect ratio</blockquote>
 
For more information, see [[GMS:2D Mesh Settings|2D Mesh Settings]].
 
==Graphics==
*''Multisampling level'' &ndash; Bigger numbers result in smoother, antialiased graphics. 0 = no multisampling, 16 = maximum multisampling. If this option is changed, GMS must be restarted before the change will take effect.
*''Use smooth fonts'' &ndash; anti-alias fonts
[[File:PreferencesGraphics.jpg|thumb|none|left|450 px|The ''Preferences'' dialog showing the ''Graphics'' tab]]
'''''Obsolete Options'''''
*Ask which library to use if system does not support all functionality
*Autoselect the software library if system does support all functionality
*Always use system library like a dedicated GPU (may not support all features)
*Always use software library on the CPU (may be slower)


==Related Topics==
==Related Topics==
*[[GMS:Edit Menu|Edit Menu]]
*[[GMS:Edit Menu|Edit Menu]]





Latest revision as of 22:10, 26 September 2024

The Edit | Preferences command brings up the Preferences dialog.

General

The Preference dialog showing the General tab

The General tab has all of the general options in GMS.

  • Check for newer version on startup – When turned on, GMS will check aquaveo.com downloads page for the most recent release of GMS. If a new release is found, a prompt will appear asking if wanting to download the newer release.
  • Confirm Deletions – Choose whether or not to be prompted to confirm the deletion whenever a set of selected objects is about to be deleted. This is meant to ensure that objects are not deleted accidentally.
  • Ask for file editor program
  • Invert mouse wheel zoom – Changes direction of the zoom with the mouse wheel
  • Create GMS notes automatically – When on, certain actions will cause notes to be automatically generated.
  • Icon size – Specifies the display size for icons.
    • "Auto" – The default icon display size.
    • "Small" – Causes the icons to be displayed at a smaller size; around 9 pixels wide.
    • "Large" – Causes the icons to be displayed at a larger size; around 27 pixels wide.

Sections:

  • File compression – Use compression when saving XMDF files. The compression factor can be specified.
  • Project Explorer – Allows modifying preferences related to the Project Explorer.
    • Change Module when Project Explorer selection changes – Changes the current module when an item is selected in the Project Explorer. This option is on by default.
    • Scroll Project Explorer when changing module – Ensures the visibility of the Project Explorer item objects in a module when the module is changed.
    • Synchronize active dataset and Z elevations for TINs, 2D Meshes, 2D Grids, and 2D Scatter Sets
    • Simulation right-click menu options – Select Edit... to open the Simulation Menu Preferences dialog. This allows for adjusting options that will appear when right-clicking a simulation in the Project Explorer. Not all options are compatible with every model.
      The Simulation Menu Preferences dialog.
  • Contouring – Allows entering a filled contour tolerance.
  • North arrow path – Specify the path to the folder containing the North Arrows.
  • Model Run – Options for processes that can run in conjunction with the model run.
    • Run checks before adding to Run Queue – When turned on, the model check will run before the model is added to the run queue. If errors are found, a prompt will appear and the model will not be added to the Run Queue.
    • Prompt before unloading solution datasets – When turned on, a warning will appear if the solution datasets need to be removed from the project before the model can run, for example when running the same simulation again. When turned off, the solution datasets will be removed without any warning.

Buttons at the bottom:

  • Help... – Opens xmswiki.com to this page (GMS:Preferences).
  • Restore Factory Preferences – Reverts all settings to the factory defaults.
  • OK – Accepts the settings as selected and entered. Closes the Preferences dialog.
  • Cancel – Close the Preferences dialog without saving any changes to the settings.


2D Mesh

The 2D Mesh tab has the following options:

  • Interpolate for default z on interior
Default z (ft)
  • Assign default z-value
  • Prompt for z-value
  • Insert nodes into triangulated mesh
  • Check for coincident nodes
  • Retriangulate voids when deleting
  • Thin triangle aspect ratio
  • Min interior angel for merging triangles

For more information, see 2D Mesh Settings.

Boreholes

The Prefences dialog showing the Borehole tab.
  • Auto-assign Horizons – Options for settings related to the Boreholes | Auto-assign Horizons… command.
    • Rows per lift
    • Row overlapped between lifts
    • Sets retained between lifts
    • Measure slope from borehole tips
    • Average horizon slope
    • Horizon slope weight
    • Gap weight
  • Auto-Fill cross sections
    • Prompt for vertex spacing – Option for GMS to open a dialog to prompt for the desired vertex spacing. It prompts for the desired spacing in the units set for the project.
    • Do not redistribute vertices – Option for GMS to not redistribute the vertices.
    • Use default spacing – GMS will redistribute vertices without prompting using a default ratio defined in the Default spacing/length ratio option.
      • Default spacing/length ratio – The default ratio used by GMS to calculate vertices placement when Use default spacing is selected.
    • Max. lense thickness ratio


Graphics

  • Multisampling level – Bigger numbers result in smoother, antialiased graphics. 0 = no multisampling, 16 = maximum multisampling. If this option is changed, GMS must be restarted before the change will take effect.
  • Use smooth fonts – anti-alias fonts

Obsolete Options

The following options are not in use in current versions of GMS, but apply to older versions.

  • Ask which library to use if system does not support all functionality
  • Autoselect the software library if system does support all functionality
  • Always use system library like a dedicated GPU (may not support all features)
  • Always use software library on the CPU (may be slower)
The Preferences dialog showing the Graphics tab


Images / CAD

  • Draw Order
Allows determining the vertical location of objects when being drawn.
  • Bitmap Scale Factor
When the copy command is selected, a bitmap image of the screen is placed on the clipboard. The scale factor can be used to increase or decrease the resolution of the bitmap. This scale factor also applies when saving the image as a bitmap.
  • Confirm scale factor before copying
Select this for GMS to confirm the scale factor each time the Edit | Screen Capture… command is used.
  • Draw points and symbols as points
CAD points and symbols will be drawn as points in the GMS Graphics Window. Note that these are sometimes very difficult to see.
  • Draw points and symbols as shapes
CAD points and symbols will be drawn as shapes in the GMS Graphics Window.
  • Specify CAD symbol size
The size of the CAD symbol shape display can be specified. May require clicking on Draw points and symbols as shapes button to activate (even if Draw points and symbols as shapes is already selected). Option not available when CAD points and symbols are drawn as points.
The Preferences dialog showing the Images / CAD tab


Map

  • Snap feature objects to displayed nodes and vertices
Select for arcs to align (snap) to displayed nodes and vertices from other displayed coverages while the arcs are being drawn. When using the Create Arc tool, getting close to nodes or vertices from a displayed coverage causes a red box to appear. Place the arc node or vertex inside the red box, and it aligns the feature just created to the feature from the other coverage. If a coverage is not displayed, then the arc will not align to features from that coverage. If unselected, the red boxes will not appear for any nodes or vertices inside any coverage. Snapping will still occur with nodes and vertices of the same coverage, but not with those of other coverages.
  • Automatically perform the Map→SEEP2D command after editing attributes.
Gives the option to automatically perform the Map→SEEP2D command.
The Preferences dialog showing the Map tab.


Model Executables

The Preferences dialog showing the Models options

The Models page allows specifying the location of model executables, as well as the option to use the Model Wrapper.

  • Model Wrapper
GMS is a pre- and post-processor for Numerical Models. Most of these numerical models are run externally in the DOS environment. The default option is to use the Model Wrapper. The Model Wrapper "wraps" itself around the same DOS executables and gives more model feedback including graphs and tables. The Model Wrapper includes the option to tell GMS to automatically read in the results of the solution upon exiting the Model Wrapper. The box to select this options is in the bottom left of the Model Wrapper. This box will only be checked by default if the model converged. The option to use the Model Wrapper or the old DOS view is included in the Preferences dialog. Certain models, including Stochastic and inverse modeling, can only be run using the Model Wrapper.

Parallel versions of MODFLOW-2000, MODFLOW-2005, and SEAWAT are shipped with GMS to run simulations. Beginning with version 8, GMS ships parallel versions where the SAMG solver has been parallelized. Even when this option is on, when running Parallel PEST with MODFLOW the serial (non-parallel) version of MODFLOW will be used since the Parallel PEST will use all of the available cores on the computer with the serial version. Also see MODFLOW preferences for an option to turn on or off the parallel version.

Note: the default directory location for most model executables is: C:\Program Files\GMS **.* 64-bit\python\Lib\site-packages


MODFLOW

The Preferences dialog showing the MODFLOW tab.

The MODFLOW page has options related to the MODFLOW interface in GMS.

  • Reverse mini-grid increment
The default functionality of the arrows next to the edit field on the mini-grid tool bar is for the up arrow to increase the layer number and for the down arrow to decrease the layer number. This option changes direction of the arrows so that down will increase the layer number and up will decrease the layer number.
  • Compress MODFLOW h5 files
This option will force the h5 files saved with MODFLOW to be compressed. Generally this option should be turned on.
  • Create h5 copy of head solution
Turning on this option can speed up reading the MODFLOW head solution especially when there are a large number of stress periods. When this option is on, GMS writes an HDF5 copy of the MODFLOW head solution upon reading it the first time. The following times GMS reads the head solution, it doesn't take as much time.
  • Create cell summary text file
A text file is created when reading the MODFLOW head file that provides a summary of the the number of active, inactive, dry, and flooded cells at each output time of the simulation. The text file is added to the MODFLOW solution and can be opened from the Project Explorer.
  • Save copy of MODFLOW simulation in native text format
This option sets the default for the Save native text copy option in the MODFLOW Global/Basic Package dialog. New models will be set to create an additional MODFLOW directory that contains native MODFLOW text files of the MODFLOW simulation. GMS will create the new directory when the GMS project is saved and will be named as follows myProject_MODFLOW_text. This option does not change the settings for the current MODFLOW model. Settings for the current model must be adjusted in the MODFLOW Global/Basic Package dialog. There are three additional preferences with this option: all arrays be written internally in the MODFLOW files (default option), all arrays are external from the MODFLOW files, or all arrays are external and are placed in a directory named arrays.
External arrays are placed in their own text files and are named as follows myProject_array_PACKAGE_VARIABLE_LAYERorSP. For example the ibound array for layer 1 would have the following name myProject_array_BAS_IBOUND_1.txt. The recharge array for stress period 3 would have the following name myProject_array_RCH_RECH_3.txt.
  • Save copy of MODFLOW simulation in MODFLOW 6 format
This option sets the default for the Save MODFLOW 6 copy option in the MODFLOW Global/Basic Package dialog. New models will be set to create an additional MODFLOW directory that contains MODFLOW 6 files of the MODFLOW simulation. GMS will create the new directory when the GMS project is saved and will be named as follows myProject_MODFLOW_mf6. This option does not change the settings for the current MODFLOW model. Settings for the current model must be adjusted in the MODFLOW Global/Basic Package dialog.
  • Use custom Run dialog when running MODFLOW
This option sets the default for the Use custom Run dialog option in the MODFLOW Global/Basic Package dialog. New models will be set for the Custom Run MODFLOW dialog to appear when running MODFLOW. This default will apply to all new models. This does not change the preferences for the current model, which must be changed in the MODFLOW Global/Basic Package dialog
  • Warn when switching to USG-Transport that it is one way
Select for GMS to warn when switching to USG-Transport that the model cannot be changed back to other MODFLOW versions. This warning will appear when USG-Transport is selected in the MODFLOW Global/Basic Package dialog after OK is clicked to close the dialog. It's on by default.
  • Default version of MODFLOW to run
Allows selecting the version of MODFLOW to be used as a default when GMS is started.
  • Double precision
When this option is on, GMS will use the double precision version of MODFLOW to run simulations. By default this option is off and GMS uses the single precision version of MODFLOW.
  • Parallel (not used by Parallel PEST)
When this option is on, GMS will use the parallel version of MODFLOW to run simulations. Beginning with version 8, GMS ships parallel versions of MODFLOW where the SAMG solver has been parallelized. Even when this option is on, Parallel PEST will use the serial (non-parallel) version of MODFLOW since the Parallel PEST will use all of the available cores on the computer.


Printing

Specifies scaling points, lines, and fonts while printing.

The Preferences dialog showing the Printing tab


Program Mode

The Preferences dialog showing the Program Mode tab.

GMS has the option of changing the "mode" or "skin" that GMS is running. The purpose of the mode is to simplify the items available in the interface.

Available Modes

  • GMS
This is the default mode.
  • GMS 2D
GMS 2D is for only using GMS to do seepage and slope stability. In GMS 2D mode, the only tools that are available are the 2D mesh and the Map. There are several changes to the GMS interface when in this mode, including:
  1. Hiding of tools and modules not in use
  2. SEEP2D model automatically initialized from conceptual model
  3. SEEP2D boundary conditions automatically mapped from conceptual model (no need to run Map → SEEP2D)
  4. Easily create all coverage types in one step
  5. Feature object types automatically assigned based on coverage attributes
  6. Allows only one conceptual model

When starting up in GMS 2D mode, a New Project dialog will appear. The following errors may also appear when opening some project files. These errors may state any of the following:

  • Your project file contained more than one conceptual model. This version of GMS only supports one SEEP2D/UTEXAS conceptual model. The first encountered SEEP2D/UTEXAS conceptual model has been preserved and all other conceptual models have been removed from the project.
  • Error. This requires the "MODFLOW" component. Your GMS license does not include this component. Contact your vendor if you would like to enable this feature.
  • The project that you are reading does not have a SEEP2D/UTEXAS conceptual model. The project can not be loaded into this version of GMS.
  • GMS Site
GMS Site is for only using tools for site characterization. As such the tools available in this mode are TINs, Boreholes, Solids, 2D Scatter, and Map. These tools can be used to construct solid models of stratigraphy.
  • TPROGS
T-PROGS is used to perform transition probability geostatistics on borehole data.

Caveats

When GMS is running in a particular mode then only data associated with the available tools will be read into GMS. For example, attempting to read in a GMS project that contains a 3D Grid while in "GMS 2D" mode will produce an error message. The message will state that GMS is not enabled to read in 3D Grid data. The only data that will read into GMS in "GMS 2D" mode is data associated with the 2D Mesh and the Map.

Scatter sets

2D scatter

  • Default dataset value
Sets default value for new points created in dataset.
  • Confirm dataset value
Select for option to set value of each new point created in a dataset. When selected, a Scatter Point Dataset Value dialog will open each time a new point is created. It will automatically populate with the current value from the Default dataset value field but can be edited.

3D scatter

  • Default dataset value
Sets default value for new points created in dataset.
  • Default Z value
Sets default Z value for new points created in dataset.
  • Confirm dataset value
Select for option to set value of each new point created in a dataset. When selected, a Scatter Point Dataset Value dialog will open each time a new point is created.
The Preferences dialog showing the Scatter Sets tab.


SEAWAT

Default version of SEAWAT to run

Parallel (only SAMG solver parallelized) – Option to run some parts of the SEAWAT process in parallel to speed up computation time.
The SEAWAT tab of the Preferences dialog.


TINs

The TINs tab has the following options:

  • Vertex options
    • Retriangulate after deleting
      • Default z-value
    • Confirm z-value
    • Interpolate for default z on interior
    • Extrapolate for default z on exterior
    • Breakline options
      • Add supplementary points
      • Swap edges
  • Minimum length ratio

For more detailed information, see TIN Settings.

Licensing

This tab shows information about the application license.

  • Use Legacy Licensing – Turning on will revert to using older licenses.
  • Information – Shows information about the license being used.
The Preferences dialog showing the Licensing tab


Related Topics