GMS:Project Explorer: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
No edit summary
 
(19 intermediate revisions by 3 users not shown)
Line 1: Line 1:
[[Image:Tree_General.jpg|thumb|240 px|Example of the Project Explorer]]
[[Image:Tree_General.jpg|thumb|240 px|Example of the Project Explorer]]
The Project Explorer is located at the left side of the GMS window by default. It can be moved to anywhere on the window since it is a "dockable" toolbar.  The Project Explorer contains a hierarchical representation of the data associated with a modeling project.  Previously only the data form the active module was displayed in the Project Explorer, but now all of the data in GMS is always displayed  independent of the active module. The new Project Explorer can also be resized by clicking on the window borders and dragging them to a new location.
The Project Explorer is located at the left side of the GMS window by default. It can be moved to anywhere on the window since it is a "dockable" toolbar.  The Project Explorer contains a hierarchical representation of the data associated with a modeling project.  Previously only the data from the active module was displayed in the Project Explorer, but now all of the data in GMS is always displayed  independent of the active module. The new Project Explorer can also be resized by clicking on the window borders and dragging them to a new location.


All of the modules have root items corresponding to them.  Each root item may be right-clicked on to accomplish certain actions.  Data for each module is grouped into folders.  The modules and items can also be expanded and collapsed to show sub folders.  Each item may also be turned on or off by clicking the check box next to the item.  Many items in the Project Explorer can be dragged to different locations to be used with different modules.  Items may also be duplicated.
All of the modules have root items corresponding to them.  Each root item may be right-clicked on to accomplish certain actions.  Data for each module is grouped into folders.  The modules and items can also be expanded and collapsed to show sub folders.  Each item may also be turned on or off by clicking the check box next to the item.  Many items in the Project Explorer can be dragged to different locations to be used with different modules.  Items may also be duplicated.
Line 12: Line 12:
{|
{|
|-valign="top"
|-valign="top"
|width="170"|
|width="140"|
*[[GMS:Display Theme|Display Theme]]
*[[GMS:Display Theme|Display Theme]]
*[[GMS:TIN Module|TIN]]
*[[GMS:TIN Module|TIN]]
Line 20: Line 20:
*[[GMS:2D_Grid_Module|2D Grid]]
*[[GMS:2D_Grid_Module|2D Grid]]
|width="170"|
|width="170"|
*[[GMS:2D Scatter Point Module|2D Scatter Point]]
*[[GMS:2D Scatter Point Module|2D Scatter Point Set]]
*[[GMS:3D_Mesh_Module|3D Mesh]]
*[[GMS:3D_Mesh_Module|3D Mesh]]
*[[GMS:3D_Grid_Module|3D Grid]]
*[[GMS:3D_Grid_Module|3D Grid]]
Line 28: Line 28:
|
|
*[[GMS:Grid Frame|Grid Frame]]
*[[GMS:Grid Frame|Grid Frame]]
*[[Annotations|Annotation Layer – Screen Space]]
*[[GMS:Annotations|Annotation Layer – Screen Space]]
*[[Annotations|Annotation Layer – World Space]]
*[[GMS:Annotations|Annotation Layer – World Space]]
*[[GMS:T-PROGS|TProgs]]
*[[GMS:T-PROGS|TProgs]]
*[[GMS:UGrid Module|2D UGrid]]
*[[GMS:UGrid Module|2D UGrid]]
Line 35: Line 35:
|}
|}
</blockquote>
</blockquote>
; ''New Simulation'' : This submenu will bring up a list of simulations that can be created. Selecting a simulation type in the list will create a simulation of that type in Project Explorer. Currently, the only option is for [[GMS:MODFLOW 6|MODFLOW 6]].
; Collapse All : Collapses any data objects in the Project Explorer so they are hidden in the data object's parent object. Only data objects that are not contained in other data objects will be visible.
; Collapse All : Collapses any data objects in the Project Explorer so they are hidden in the data object's parent object. Only data objects that are not contained in other data objects will be visible.
; Expand All : Expands all data objects in the Project Explorer to show any data objects that are child objects inside a parent object.
; Expand All : Expands all data objects in the Project Explorer to show any data objects that are child objects inside a parent object.
; Check All : Makes all data visible in the Graphics Window. This includes data that is currently hidden in the Project Explorer.
; Check All : Makes all data visible in the Graphics Window. This includes data that is currently hidden in the Project Explorer.
; Uncheck All : Hides all data in the Graphic Window.
; Uncheck All : Hides all data in the Graphic Window.
; [[GMS:CAD_Options#Convert_To_CAD|Convert to CAD]] [[File:ConvertToCAD icon.png]] :  Converts any visible geometric data into CAD format internally within GMS.
; [[GMS:CAD_Options#Convert_To_CAD|Convert to CAD]] [[File:Convert to CAD Icon.svg|16 px]] :  Converts any visible geometric data into CAD format internally within GMS.


==Standard Project Explorer Folder Right-Click Commands==
==Standard Project Explorer Folder Right-Click Commands==
Right-clicking on a folder object in the Project Explorer produces a menu. The menu will have commands specific to the type of folder object, but the following standard menu commands are available:
Right-clicking on a folder object in the Project Explorer produces a menu. The menu will have commands specific to the type of folder object, but the following standard menu commands are available:
; New Folder [[File:New folder icon.png]] : Creates a new folder [[File:Generic Project Explorer folder icon.png]] under the selected folder object.
; New Folder [[File:New folder icon.png]] : Creates a new folder [[File:Generic Folder.svg|16 px]] under the selected folder object.
; Delete [[File:Delete Icon.png]] : Removes the selected object folder along with all data objects contained in that folder.
; Delete [[File:GMS Delete Icon.svg|14 px]] : Removes the selected object folder along with all data objects contained in that folder.
; Collapse All : Collapses any data objects under the selected folder object so they are hidden.
; Collapse All : Collapses any data objects under the selected folder object so they are hidden.
; Expand All : Expands all data objects under the selected folder object so they are visible.
; Expand All : Expands all data objects under the selected folder object so they are visible.
Line 50: Line 51:
The following commands are included in most folder object right-click menus:
The following commands are included in most folder object right-click menus:
; Display Options [[File:Display Options Macro.svg|16 px]] : Opens the [[GMS:Display Options|''Display Options'']] dialog showing the options for the folder object type.
; Display Options [[File:Display Options Macro.svg|16 px]] : Opens the [[GMS:Display Options|''Display Options'']] dialog showing the options for the folder object type.
; Export [[File:Save macro icon.png]] : Saves all data objects under the selected folder object. The file type generated from this action will correspond to the folder object type.
; Export [[File:Save Macro.svg|16 px]] : Saves all data objects under the selected folder object. The file type generated from this action will correspond to the folder object type.


==Standard Project Explorer Data Object Right-Click Commands==
==Standard Project Explorer Data Object Right-Click Commands==
Right-clicking on a data object in the Project Explorer produces a menu. The menu will have commands specific to the type of data object, but the following standard menu commands are available:
Right-clicking on a data object in the Project Explorer produces a menu. The menu will have commands specific to the type of data object, but the following standard menu commands are available:
; Delete [[File:Delete Icon.png]] : Removes the selected data object from the GMS project.
; Delete [[File:GMS Delete Icon.svg|14 px]] : Removes the selected data object from the GMS project.
; Duplicate [[File:Duplicate Icon.png]] : Creates a copy of the selected data object in the Project Explorer. The duplicate data object will have the word "Copy of..." affixed to the name of the copied data object. Additional duplicates will have a number affixed to the name if the copied data object is not renamed.
; Duplicate [[File:DuplicateIcon.svg|16 px]] : Creates a copy of the selected data object in the Project Explorer. The duplicate data object will have the word "Copy of..." affixed to the name of the copied data object. Additional duplicates will have a number affixed to the name if the copied data object is not renamed.
; Rename : Allows assigning a new name to the selected data object.
; Rename : Allows assigning a new name to the selected data object.


Line 61: Line 62:
The following commands are included in the right-click menus for most data objects:
The following commands are included in the right-click menus for most data objects:
; [[Projections|''Projection'']] : Submenu that has commands for setting the data objects projection. The following commands are available:
; [[Projections|''Projection'']] : Submenu that has commands for setting the data objects projection. The following commands are available:
<blockquote style="margin-top:0px; margin-bottom:0px;">
:; Projection : Brings up a [[Projections#Object_Projection|''Projection'']] dialog to set the projection for the select data object.
; Projection : Brings up a [[Projections#Object_Projection|''Projection'']] dialog to set the projection for the select data object.
:; Set as Display Projection : Assigns the selected data object's projection as the [[Projections#Display_Projection|display projection]].
; Set as Display Projection : Assigns the selected data object's projection as the [[Projections#Display_Projection|display projection]].
:; Reproject : Brings up the [[Projections#Reproject_object|''Reproject Object'']] dialog. This command does not work if no projection has been assigned to the selected data object.
; Reproject : Brings up the [[Projections#Reproject_object|''Reproject Object'']] dialog. This command does not work if no projection has been assigned to the selected data object.
:; Transform : Brings up the [[GMS:Transform|''Transform'']] dialog.
; Transform : Brings up the [[GMS:Transform|''Transform'']] dialog.
; Export [[File:Save Macro.svg|16 px]] : Saves the selected data object as a file that corresponds to the data object type.
</blockquote>
; Properties [[File:GMS Properties Macro.svg|16 px]] : Brings up the ''Properties'' dialog that corresponds to the selected data object type.
; Export [[File:Save macro icon.png]] : Saves the selected data object as a file that corresponds to the data object type.
; Zoom to Extants [[File:Frame Macro.svg|16 px]]: Brings all the data extents within the boundaries of the Graphics Window that is associated with the selected data object.
; Properties [[File:GMS Properties macro icon.png]] : Brings up the ''Properties'' dialog that corresponds to the selected data object type.
; Zoom to Extants [[File:Frame macro in SMS.png]]: Brings all the data extents within the boundaries of the Graphics Window that is associated with the selected data object.


==Functionality Notes==
==Functionality Notes==
Line 84: Line 83:
[[Category:Project Explorer|GMS]]
[[Category:Project Explorer|GMS]]
[[Category:GMS Menus|Project]]
[[Category:GMS Menus|Project]]
[[Category:GMS Layout]]

Latest revision as of 18:50, 5 May 2022

Example of the Project Explorer

The Project Explorer is located at the left side of the GMS window by default. It can be moved to anywhere on the window since it is a "dockable" toolbar. The Project Explorer contains a hierarchical representation of the data associated with a modeling project. Previously only the data from the active module was displayed in the Project Explorer, but now all of the data in GMS is always displayed independent of the active module. The new Project Explorer can also be resized by clicking on the window borders and dragging them to a new location.

All of the modules have root items corresponding to them. Each root item may be right-clicked on to accomplish certain actions. Data for each module is grouped into folders. The modules and items can also be expanded and collapsed to show sub folders. Each item may also be turned on or off by clicking the check box next to the item. Many items in the Project Explorer can be dragged to different locations to be used with different modules. Items may also be duplicated.

Many commands on the data in GMS can be executed by right-click menus in the Project Explorer. For general commands or to create new data objects, right-click on the empty space in the Project Explorer and a pop-up menu becomes available. Right-click commands can also be used to export or transform items. The visibility of items in the Graphics Window can also be controlled by selecting the toggle next to each item in the Project Explorer.

Project Explorer Right-Click Commands

The following commands are available when right-clicking on an empty space in the Project Explorer.

New
This submenu will bring up a list of data objects. Selecting a data object in the list will create it in Project Explorer. Options include:
New Simulation
This submenu will bring up a list of simulations that can be created. Selecting a simulation type in the list will create a simulation of that type in Project Explorer. Currently, the only option is for MODFLOW 6.
Collapse All
Collapses any data objects in the Project Explorer so they are hidden in the data object's parent object. Only data objects that are not contained in other data objects will be visible.
Expand All
Expands all data objects in the Project Explorer to show any data objects that are child objects inside a parent object.
Check All
Makes all data visible in the Graphics Window. This includes data that is currently hidden in the Project Explorer.
Uncheck All
Hides all data in the Graphic Window.
Convert to CAD Convert to CAD Icon.svg
Converts any visible geometric data into CAD format internally within GMS.

Standard Project Explorer Folder Right-Click Commands

Right-clicking on a folder object in the Project Explorer produces a menu. The menu will have commands specific to the type of folder object, but the following standard menu commands are available:

New Folder New folder icon.png
Creates a new folder Generic Folder.svg under the selected folder object.
Delete GMS Delete Icon.svg
Removes the selected object folder along with all data objects contained in that folder.
Collapse All
Collapses any data objects under the selected folder object so they are hidden.
Expand All
Expands all data objects under the selected folder object so they are visible.

Common Project Explorer Folder Right-Click Commands

The following commands are included in most folder object right-click menus:

Display Options Display Options Macro.svg
Opens the Display Options dialog showing the options for the folder object type.
Export Save Macro.svg
Saves all data objects under the selected folder object. The file type generated from this action will correspond to the folder object type.

Standard Project Explorer Data Object Right-Click Commands

Right-clicking on a data object in the Project Explorer produces a menu. The menu will have commands specific to the type of data object, but the following standard menu commands are available:

Delete GMS Delete Icon.svg
Removes the selected data object from the GMS project.
Duplicate DuplicateIcon.svg
Creates a copy of the selected data object in the Project Explorer. The duplicate data object will have the word "Copy of..." affixed to the name of the copied data object. Additional duplicates will have a number affixed to the name if the copied data object is not renamed.
Rename
Allows assigning a new name to the selected data object.

Common Project Explorer Data Object Right-Click Commands

The following commands are included in the right-click menus for most data objects:

Projection
Submenu that has commands for setting the data objects projection. The following commands are available:
Projection
Brings up a Projection dialog to set the projection for the select data object.
Set as Display Projection
Assigns the selected data object's projection as the display projection.
Reproject
Brings up the Reproject Object dialog. This command does not work if no projection has been assigned to the selected data object.
Transform
Brings up the Transform dialog.
Export Save Macro.svg
Saves the selected data object as a file that corresponds to the data object type.
Properties GMS Properties Macro.svg
Brings up the Properties dialog that corresponds to the selected data object type.
Zoom to Extants Frame Macro.svg
Brings all the data extents within the boundaries of the Graphics Window that is associated with the selected data object.

Functionality Notes

Due to a Windows design limitation, the right-click menu may not appear when right-clicking on unselected items that bring up the Time Steps window at the bottom of the Project Explorer. This happens in cases where the Project Explorer item being right-clicked overlaps the location where the Time Step window will appear. In these cases, the Time Step window appearing causes the right-click menu to not appear. To work around this problem, simply select the item first, and then right-click on it.

See also