pictures/imod_logo.png

iMOD User Manual version 4.4 (html)


7.6GeoConnect Tool

WHY?
The GeoConnect Tool is an instrument that can be used to aggregate geological formations to model layers and vice versa.

WHAT?
With the GeoConnect Tool it is possible to aggregate geological formations to a dataset with different model layers containing combined formation information. It is now possible to go from model results with multiple geological formations per layer to a geological formations dataset. Besides, with this tool it is possible to use geological formations to come up with a new model parameterization. This functionality is also available as a batch-function (see Section 8.7.7).

HOW?
Before starting the GeoConnect Tool, the user needs to create a textfile with the general settings to be used in the tool. This file needs to be placed in the "IMOD_USER\SETTINGS\" subfolder with the name "GeoConnect.txt".

The textfile with general settings needs to contain the following keywords:

ACTLAYERS=
(optional)

Enter a string of values to include or exclude a specific model layer from the computation; 0=inactive, 1=active, on default all layers are used in de computation (similar to e.g.: ACTLAYERS=1111111111). E.g. in case of the amount of model layers is 10 and it is preferred to only take the first 6 layers into account: ACTLAYERS=1111110000.

REGISFOLDER=

Give the directory and name of the folder where all REGIS-files are stored. Note: subdirectories are not allowed and the filenames need to be of the following format: abbreviation formation name-t/b/ks/kv-ck/sk.idf (’t’ and ’b’ need to be combined with ’ck’, and ’ks’ and ’kv’ with ’sk’), e.g. d:\Model\REGIS\bez1-b-ck.idf.

TOPFOLDER=

Give the directory and name of the folder of the model TOP-files, e.g. d:\Model\TOP\TOP.

BOTFOLDER=

Give the directory and name of the folder of the model BOT-files, e.g. d:\Model\BOT\BOT.

NLAY=

Enter the amount of model layers, e.g. NLAY=10.

These settings are automatically placed on the Settings tab on the GeoConnect window whenever the tool is started. The aggregation process is described in the example below.

Example 1
ACTLAYERS=1111110000000000000
REGISFOLDER=d:\Model_Ibrahym\REGIS\
TOPFOLDER=d:\Model_Ibrahym\TOP\VERSION_1\
BOTFOLDER=d:\Model_Ibrahym\BOT\VERSION_1\
NLAY=19

Geostratigraphy textfile
The geostratigraphy.txt file contains the order of the formations (from surface layer to base) and needs to be located in the Settings-folder in the iMOD user environment (in case of using the GUI), contains all formation abbrevations as used in the geological dataset and corresponding factors. This file can be loaded into the Postprocessing-tab on the GeoConnect window in the iMOD-GUI.

Example of the first 11 and last 4 lines of a geostratigraphy.txt:
HLC
BXSCK1
BXZ1
BXLMK1
BXK1
BXZ2
BXK2
BXZ3
BEROK1
BEZ1
BEK1

MTQ
GUQ
VAC
AKC

Calculation/Aggregation of formations:
This example shows the mathematical theory behind the aggregation of formation characteristics within one model layer. The formulas in the table are used to calculate the new transmissivity, groundwater head vertical resistance and flux. The choice of the formula depends on the variable that needs to be aggregated. In case, it is preferred to calculate the transmissivity (see figure) of the first and second model layer based on the formations given in the formation dataset, the first formula in the table is used to achieve this. In example: \(T1=(d_{1}^{f}\times k_{1}^{h}\times f_{1})\)
\(T2=(d_{2}^{f}\times k_{2}^{h}\times f_{2})+(d_{3}^{f}\times k_{3}^{h}\times f_{3})+(d_{4}^{f}\times k_{4}^{h}\times f_{4})\)

pictures/h72-end/preprocessing_explanation.png

pictures/h72-end/formulas_description.png

Start the Tool
To start the GeoConnect Tool select Toolbox from the main menu, choose GeoConnect Tool. This tool allows the user to continue working in the same iMOD session and using the GeoConnect tool at the same time. Included are a preprocessing, a postprocessing and an identify functionality. The tool opens with the Settings tab up front. The general settings on the tool-window are:

pictures/h72-end/geoconnect_generalbuttons.png

Apply…

Click this button to start the preprocessing or postprocessing computation.


pictures/h1-h3/image16.png

Save as…
Click this button to save the settings in a GeoConnect.txt file in case of Settings tab, or alternatively in an iMODBATCH *.ini file in case the Preprocessing tab or Postprocessing tab is selected.


pictures/h1-h3/image14.png

Open
Click this button to get the settings from a GeoConnect.txt file in case of Settings tab, or alternatively from an iMODBATCH *.ini file in case the Preprocessing tab or Postprocessing tab is selected.

Help…

Click this button to start the Help functionality.

Close

Click this button to close the window.

Example of the GeoConnect window; Settings tab

pictures/h72-end/geoconnect_settings.png

Form.-
folder:

Give the name of the folder where all geological formation files are stored. Note: subdirectories are not allowed and the filenames need to be of the following format: abbreviation formation name-t/b/ks/kv-ck/sk.idf (’t’ and ’b’ need to be combined with ’ck’, and ’ks’ and ’kv’ with ’sk’), e.g. d:\MODEL_Ibrahym\Formations\bez1-b-ck.idf.


pictures/h1-h3/image14.png

Open
Click on this button to search for the name of the folder containing geological formation data.

Top-folder:

Give the name of the folder of the model TOP-files; e.g. d:\MODEL_Ibrahym\TOP. The tool searches for "d:\MODEL_Ibrahym\TOP\TOP_L1.IDF" in the given folder. This is repeated for each layer.


pictures/h1-h3/image14.png

Open
Click on this button to search for the name of the folder containing the Top elevation of the model.

Bot-folder:

Give the name of the folder of the model BOT-files, e.g. d:\MODEL_Ibrahym\BOT. The tool searches for "d:\MODEL_Ibrahym\BOT\BOT_L1.IDF" in the given folder. This is repeated for each layer.


pictures/h1-h3/image14.png

Open
Click on this button to search for the name of the folder containing the Bottom elevation of the model.

Number
of layers

Represents the amount of model layers as defined in settings file that you can read into the GUI on the Postprocessing-tab, e.g. NLAY=10.

Active
layers

Check a checkbox for a particular layer to include a specific model layer in the Identify routine (see Identify-tab).

Identify
The Identify option can be found on the first tab of the GeoConnect window. With this option it is possible to analyze, "on-the-fly", the model composition per individual location by making use of the Identify button. The functionality shows the content of the geological formations in the model at mouse position. Aquitard layers (e.g. clayey formations) are identified as connected to the Aquifer layers (sandy formations), the clayey layers are so called "interbed" layers. When a model layer contains a clayey layer the fraction shown in the Identify table is always 100%. See for example Layer 2 in the figure below (Identify-tab). This layer consists for 0.211% of BXZ3, 26.538% of BEZ1, 73.140% of BEZ2 and for 100% of BEK2.

Example of the GeoConnect window; Identify tab

pictures/h72-end/geoconnect_identify.png

Identify…

Click this button to be able to hover over the map in the main iMOD window.

Table description

Lith.:

Lithology class of the specific formation shown in the first column of the table.

Layer}{i}:

i’th model layer

"100.0":

Fraction of specific geological formation in given model layer, e.g. Layer 2, row 3: "26.538" means that layer 2 consists of 26.538% BEZ1 formation. The darker the color green the higher the fraction.

Current location (…m, …m)

Gives the current location (in meters) of the model composition at the mouse position.

Preprocessing
The preprocessing functionality in the GeoConnect tool can be used to compute a renewed model parameterization out of the geological formation related top-, bot- and k-values.

Example of the GeoConnect window; preprocessing tab

pictures/h72-end/geoconnect_preprocessing.png

Entire Zoom
Extent…

Select this option to use the complete model extent as described by the IDF-files in the TOP-folder (as defined on the Settings tab).

Window

Select this option to compute only for the given window extent. Click on "Window" to refresh the extent accordingly to the current extent in the main iMOD window.

X-minimal

Give a minimum X-coordinate value in meters.

Y-minimal

Give a minimum Y-coordinate value in meters.

X-maximal

Give a maximum X-coordinate value in meters.

Y-maximal

Give a maximum Y-coordinate value in meters.

CellSize (m)

Give the cell size in meters of the new model to be computed.

Adjustments

Adjustable grid with factors sorted per formation.

Table description:

Lith.:

In this column the lithology class is shown related to a specific geological formation, e.g. "K" means Clay, "Z" means Sand. The cells are colored accordingly to the individual lithology class.

Formation:

In this column the geological formations are displayed.

Factor:

In this column the factors per formation are given and can be adjusted, either by loading in an file with factors (on default factors.txt is read from the IMOD_USER\SETTINGS folder, see for an example Section 8.7.7) or by changing the factors manually.


pictures/h1-h3/image14.png

Open
Click this button to read a file with factors into the Adjustments grid.

Refresh

Click this button to refresh the factors in the grid to 1.0.

Output Folder

Give the directory and name of the folder to store the results of the preprocessing computation.


pictures/h1-h3/image14.png

Open
Click on this button to search for the name of the folder to store the results of the preprocessing computation.

Save KHV-,…

Check this option to calculate new parameter files for KHV, KVV and KVA.

Save KDW-,…

Check this option to calculate new parameter files for KDW and VCW.

Postprocessing
The postprocessing functionality in the GeoConnect tool can be used to perform model layer aggregation for variables to be chosen based on the formation settings.

Example of the GeoConnect window; postprocessing tab

pictures/h72-end/geoconnect_postprocessing.png

Current Zoom
Extent…

Select this option to use the complete model extent as described by the IDF-files in the TOP-folder (as defined on the Settings tab).

Window

Select this option to compute only for the given window extent. Click on "Window" to refresh the extent accordingly to the current extent in the main iMOD window.

DBASE map:

Give the directory and name of the folder containing DBASE model information.


pictures/h1-h3/image14.png

Open
Click this button to search for the specific DBASE model folder.


pictures/h72-end/pipet.png

Pipet
Click this button to fill the aggregated grid with all available geological formations at the current window extent.

Aggregate

Grid with geological formations, arranged by the order given in GEOSTRATIGRAPHY.TXT (see Section 8.7.7). Changing the numbers in the 4th column makes aggregation of geological layers possible, e.g. to aggregate all the BX* formations give them all the same number for example 2 or 5.

Table description:

Lith.:

In this column the lithology class is shown related to the specific geological formation, e.g. "K" means Clay, "Z" means Sand. The cells are colored accordingly to the individual lithology class.

Formation:

In this column the geological formations are displayed.

Number:

In this column each unique number represents one geological formation. To combine different geological formations change the number, e.g. if you want to consider the Boxtel Sands/Clays (BX*) as one model layer, enter the same number (e.g. 2) for each Boxtel formation related geological layer in this column.

Model Folder:

Give the directory and name of the folder containing the preferred model output information. Choose the favored variable in the related dropdown menu to apply the aggregation to. Options in dropdown menu are: "HEAD", "BDGWEL", "BDGRIV", "BDGDRN".

Input Folder:

Choose the preferred variable from the dropdown menu to apply the aggregation to. Options are: "KDW", "VCW", "KHV", "KVV".

IPF-File:

Give the name of the IPF-file to select points in the IPF that coincides with the aggregated formations.


pictures/h1-h3/image14.png

Open
Click on this button to search for the directory and name of the IPF-file to apply the aggregation to.

Aggregate

Select the aggregation method to be used. The aggregation can be based on the values minimum (=Min), maximum (=Max), Average or Sum.

Output Folder:

Enter the name of the folder to store the results of the postprocessing computation, e.g. (OUTPUTFOLDER)\BEZ1_BEZ2_BEZ_KDW.IDF, (OUTPUTFOLDER)\BEZ1_BEZ2_BEZ_TOP.IDF, (OUTPUTFOLDER)\BEZ1_BEZ2_BEZ_THK.IDF.


pictures/h1-h3/image14.png

Open
Click on this button to search for the name of the folder to store the results of the postprocessing computation.

Include TOP-,…

Select this option to include TOP- and BOT elevation and thickness IDF-files in the aggregation and save these files in the given Output folder.