Module 0, Install GeoDMS GUI and setup a configuration

learning objective: Install a GeoDMS version and work with a configuration on your local machine

install GeoDMS

1. Download a version of the GeoDMS, we usually advise the most recent version.
2. Install the software, see Installation Instructions up to and including part I.

load configuration

1. Download your first configuration here
2. Unzip it in a project-specific folder, which we call the ProjDir-folder, for example "C:/ProjDir/FirstConfig".
3. The root configuration file to be opened is usually located in the cfg subfolder of the ProjDir, also called the ConfigDir, and often called something like stam.dms. In this example, the file is called: basics_my_first_geodms_project.dms. So the file to be opened is something like: "C:/ProjDir/FirstConfig/cfg/basics_my_first_geodms_project.dms". For a broader overview of the suggested folder structures see Folders and Placeholders.

open configuration

1. Start the installed GeoDMS GUI
2. Go to the menu option: File > Open Configuration File, navigate to and open the basics_my_first_geodms_project.dms file.
3. Select the my_first_param parameter in the treeview (at the left) and double-click on this item to see the contents in a table. Move your mouse to the right border of the table, keep the mouse pressed to adjust the column width, to make the text fit in the table.

Your GeoDMS GUI should now look like this:

set options

In the GeoDMS GUI, with the menu option: Settings, relevant options can be set.

Most default settings are fine, but some settings are regularly overruled.

1) Your machine-specific drives/folders

In the GeoDMS we often refer to a SourceData folder (for read-only source files) and a LocalDatafolder (for (intermediary) results.

In configurations %SourceDataDir% and %LocalDataDir% are Placeholders.

The machine-specific drives/folders for SourceDataDir and LocalDataDir can be set with the Settings > Local machine Options:

By default, GeoDMS looks for SourceData in C:/SourceData and LocalData in C:/LocalData. You can configure your machine-specific folders here.

We advise to configure the LocalDataDir not to a network drive, as the CalcCache will be stored in this folder.

2) setup a configuration file editor

From the GeoDMS GUI treeview, you can activate the corresponding line in a configuration file for a selected item. Use the CTRL + e keyboard combination, or the pop-up menu option (mouse right-clicking) > Edit Config Source.

We recommend using the [text editor]: (https://github.com/ObjectVision/GeoDMS/wiki/Configuration_File_Editor) Notepad++,. A language file for each software release is available in the same folder as the installed GeoDMS software (%programfiles%/ObjectVision/GeoDmsVersion).

For instructions on how to import the language file into Notepad++ see Setup GeoDMS language file in Notepad++.

To make sure GeoDMS understands where Notepad++ is installed, make your the reference is correct in the Advanced options, External programs section, for example:

C:\Program Files\Notepad++\Notepad++.exe "%F" -n%L

To test this, select the item: my_first_param in the treeview and activate from the pop-up menu (right mouse click) the option: Edit Config Source (you can also use the Crtl - E key combination). The file editor should now be opened with the cursor on the line of the selected item. If you installed the GeoDMS language files, your editor should look like this

Edit the text: Welcome in the GeoDMS world, save the changes and reopen the configuration.

This is a common way of working with GeoDMS configuration files.

---

Go to next module: Module 1, Learning the basic concepts of GeoDMS