Main menu - ObjectVision/GeoDMS GitHub Wiki

User Guide GeoDMS GUI - main menu

Introduction

The main menu is used for generic functions like opening a configuration or tiling the viewer windows or to activate viewers for active tree items. In this page all the menu options are briefly described.

File

• Open Configuration (Ctrl-O): Open a file dialog to select a new configuration. The current configuration is closed.
• Reopen current Configuration (Alt-R): Reopen the current configuration with the same items expanded.
• Reopen last Configuration (Alt-R): with no configuration loaded -- the state the GeoDMS GUI starts in since GeoDMS 20.16.0 -- the same menu option and shortcut open the configuration that was open last, i.e. the first entry of the Recent configurations list below. The option is disabled when that list is empty. See Desktop components, section starting the application.
• Quit: Exit the application.
• Recent configurations: The recently opened configurations are presented as separate menu items. Select a configuration with the mouse or by pressing the number on the keyboard. The number of configurations in this list is not limited. With the right mouse click a pop-up menu can be activated with the following two options:
  • pin (in the future it will become possible to pin a configuration, not yet implemented)
  • remove: removes the configuration from the Recent configurations menu options.

Edit

• Open in Editor: Open the current item in the Configuration File Editor as configured in the Settings > Local machine options dialog, section Configuration File Editor. This option is also available from the pop-up menu of the TreeView.

View

Since GeoDMS 20.18.0 the icons in this menu, in the Window menu below and on the title bar of every view window come from the same font as the TreeView icons, so a view and the item it shows are recognisable as the same thing. What they say differs: a tree icon says what an item is, a menu icon says which view the entry opens. The entries are named after that view in the same release: Default View, Table View and Map View (they were Default, Table and Map), and the four chart entries lost their leading Create.

The TreeView offers these same entries in its pop-up menu, where they act on the tree item you right-click.

• Default View: Activate the default viewer for the active data item (the option is only enabled for data items). The default viewer for all data that can be visualized in a map is the map view. For all other data items, the default viewer is the Table view. Since GeoDMS 20.18.0 it carries the icon of the viewer it is going to open on the active item, so it shows the same icon as the Map View or the Table View entry below it. For data items and containers the icon in the TreeView also tells you which of the two it will be; since GeoDMS 20.17.0 that icon says what an item is rather than which viewer opens on it, so a unit's icon does not indicate a viewer.

• Table View: Activate the Table View for the active data item. The option becomes enabled if the tree item can be visualized in a table.

• Map View: Activate the Map View for the active data item. The option becomes enabled if the tree item can be visualized in a map.

• Statistics: Activate a Window with general statistics for the active data item. The option becomes enabled for data items. The results in the Statistics view can differ slightly from calculated aggregated values. The Statistics view calculates all present values in a float64 format. If an aggregation is performed on a float32 data item, the results are rounded off after the calculations to a float32 format. Each of the four chart entries carries an icon of its own, and so does the window it opens. Up to and including GeoDMS 20.17.x all four wore the icon of the Statistics view. What tells the two bar icons apart is what tells the two charts apart: the bins of a histogram touch, the bars of a bar chart stand apart.

• Histogram Chart: Activate a chart with a histogram of the active data item's (classified) values.

• Scatter Chart: Activate a chart that plots the active data item's values against their row number.

• Line Chart: Activate a chart that connects the active data item's values, in row order, with a line.

• Bar Chart: Activate a chart that draws the active data item's values as vertical bars.

• Calculation times: Activate a Window with the calculation times and memory usage of the last task that took more than 1 second to complete. This option becomes enabled if such tasks are available.

• List of loaded Configuration Files: Activate a Window with the currently loaded configuration files, including their read date & time.

• Toggle component: Toggles the component on or off.

Tools

• Code analysis: Four options to find out if the item configured is used in calculating results (This option is also available from the pop-up menu of the TreeView):
  • set source: set the item as source item to be analysed
  • set target: set the item as target item for the calculation process
  • add target: add the item as target item for the calculation process
  • clear target: clear the item as target item for the calculation process
• Eventlog filter: Activate the filter to select the Eventlog messages.
• Open the root configuration file: Opens the root item in the Configuration File Editor as configured in the Settings > Local machine options dialog, section Configuration File Editor. This option is available here, as the root item can not be activated in the TreeView.
• Expand all items in the treeview: This option expands a full configuration in the TreeView (can be time consuming). The option is mainly relevant for debugging purposes.

Settings

• GUI Options: Activate a dialog to set options for the GUI.
• Local machine Options: Activate a dialog to set options for the Local machine.
• Config Options: Activate a dialog to override placeholder folders on the Local machine, in case such options are configured.

Window

• Tile Windows: Tile the currently opened data viewers. The tab presentation is changed to the standard Windows visualization. The area for the primary data views is fully used by the viewers.
• Cascade: Cascade the currently opened data viewers. The tab presentation is changed to the standard Windows visualization.
• Close: Close the active view.
• Close All: Close all currently opened data views.
• Close All But This: Close all opened data viewers except the currently active data view
• Views: All opened data views are presented as separate menu items, each with the icon of the kind of view it is. The active view is marked with a check mark. Each view can be selected from this list.

Help

• About GeoDms: Open the About GeoDms box for information on the GeoDMS version and the used components.
• About Qt: Opens the About Qt box for information on the Qt version used to develop the GUI
• Wiki : Opens the Wiki page of the GeoDms with documentation on how to use the GeoDMS