diff --git a/figures/tutorial/Button_CloseWindow.png b/figures/tutorial/Button_CloseWindow.png new file mode 100644 index 0000000..c350c36 Binary files /dev/null and b/figures/tutorial/Button_CloseWindow.png differ diff --git a/figures/tutorial/Panel-QGIS-Tim_v02.png b/figures/tutorial/Panel-QGIS-Tim_v02.png new file mode 100644 index 0000000..3892303 Binary files /dev/null and b/figures/tutorial/Panel-QGIS-Tim_v02.png differ diff --git a/figures/tutorial/Panel-Timml AquiferAttrTable_v01.png b/figures/tutorial/Panel-Timml AquiferAttrTable_v01.png new file mode 100644 index 0000000..99d1f03 Binary files /dev/null and b/figures/tutorial/Panel-Timml AquiferAttrTable_v01.png differ diff --git a/figures/tutorial/button-Qgis-AttributeTable-AddFeature.png b/figures/tutorial/button-Qgis-AttributeTable-AddFeature.png new file mode 100644 index 0000000..e922c2b Binary files /dev/null and b/figures/tutorial/button-Qgis-AttributeTable-AddFeature.png differ diff --git a/figures/tutorial/button-Qgis-AttributeTable-StartEditingMode.png b/figures/tutorial/button-Qgis-AttributeTable-StartEditingMode.png index 8746c57..aeae674 100644 Binary files a/figures/tutorial/button-Qgis-AttributeTable-StartEditingMode.png and b/figures/tutorial/button-Qgis-AttributeTable-StartEditingMode.png differ diff --git a/figures/tutorial/button-pencil.png b/figures/tutorial/button-pencil.png new file mode 100644 index 0000000..30eb13e Binary files /dev/null and b/figures/tutorial/button-pencil.png differ diff --git a/figures/tutorial/button_Copy_Selected_Row.png b/figures/tutorial/button_Copy_Selected_Row.png new file mode 100644 index 0000000..d1c47c3 Binary files /dev/null and b/figures/tutorial/button_Copy_Selected_Row.png differ diff --git a/figures/tutorial/button_Mesh.png b/figures/tutorial/button_Mesh.png new file mode 100644 index 0000000..fb26b24 Binary files /dev/null and b/figures/tutorial/button_Mesh.png differ diff --git a/figures/tutorial/button_Paste_Feature.png b/figures/tutorial/button_Paste_Feature.png new file mode 100644 index 0000000..1a38f9b Binary files /dev/null and b/figures/tutorial/button_Paste_Feature.png differ diff --git a/figures/tutorial/button_ToolbarSnappingSettings.png b/figures/tutorial/button_ToolbarSnappingSettings.png new file mode 100644 index 0000000..fd6fd95 Binary files /dev/null and b/figures/tutorial/button_ToolbarSnappingSettings.png differ diff --git a/figures/tutorial/button_iMOD-Toolbar.png b/figures/tutorial/button_iMOD-Toolbar.png index fc28825..2be08de 100644 Binary files a/figures/tutorial/button_iMOD-Toolbar.png and b/figures/tutorial/button_iMOD-Toolbar.png differ diff --git a/figures/tutorial/figure-CPT01.png b/figures/tutorial/figure-CPT01.png new file mode 100644 index 0000000..aa198e2 Binary files /dev/null and b/figures/tutorial/figure-CPT01.png differ diff --git a/figures/tutorial/figure-PTK-graph01.png b/figures/tutorial/figure-PTK-graph01.png new file mode 100644 index 0000000..b83dbc8 Binary files /dev/null and b/figures/tutorial/figure-PTK-graph01.png differ diff --git a/figures/tutorial/figure-PTK-graph02.png b/figures/tutorial/figure-PTK-graph02.png new file mode 100644 index 0000000..e4253f2 Binary files /dev/null and b/figures/tutorial/figure-PTK-graph02.png differ diff --git a/figures/tutorial/figure-PTK-graph03.png b/figures/tutorial/figure-PTK-graph03.png new file mode 100644 index 0000000..d377e95 Binary files /dev/null and b/figures/tutorial/figure-PTK-graph03.png differ diff --git a/figures/tutorial/figure-PTK-graph04.png b/figures/tutorial/figure-PTK-graph04.png new file mode 100644 index 0000000..9bee214 Binary files /dev/null and b/figures/tutorial/figure-PTK-graph04.png differ diff --git a/figures/tutorial/figure-PTK01.png b/figures/tutorial/figure-PTK01.png new file mode 100644 index 0000000..d5d9d64 Binary files /dev/null and b/figures/tutorial/figure-PTK01.png differ diff --git a/figures/tutorial/figure-PTK02.png b/figures/tutorial/figure-PTK02.png new file mode 100644 index 0000000..050b9c2 Binary files /dev/null and b/figures/tutorial/figure-PTK02.png differ diff --git a/figures/tutorial/figure-PTK03.png b/figures/tutorial/figure-PTK03.png new file mode 100644 index 0000000..32b3583 Binary files /dev/null and b/figures/tutorial/figure-PTK03.png differ diff --git a/figures/tutorial/figure-PTK04.png b/figures/tutorial/figure-PTK04.png new file mode 100644 index 0000000..cdaffd5 Binary files /dev/null and b/figures/tutorial/figure-PTK04.png differ diff --git a/figures/tutorial/figure-PTK05.png b/figures/tutorial/figure-PTK05.png new file mode 100644 index 0000000..3679de4 Binary files /dev/null and b/figures/tutorial/figure-PTK05.png differ diff --git a/figures/tutorial/figure_DrawdownConstructionPit_v01.png b/figures/tutorial/figure_DrawdownConstructionPit_v01.png new file mode 100644 index 0000000..c976589 Binary files /dev/null and b/figures/tutorial/figure_DrawdownConstructionPit_v01.png differ diff --git a/figures/tutorial/figure_ExtractionError.png b/figures/tutorial/figure_ExtractionError.png new file mode 100644 index 0000000..067f7ec Binary files /dev/null and b/figures/tutorial/figure_ExtractionError.png differ diff --git a/figures/tutorial/figure_HeadsInCrosssection03.png b/figures/tutorial/figure_HeadsInCrosssection03.png new file mode 100644 index 0000000..444deac Binary files /dev/null and b/figures/tutorial/figure_HeadsInCrosssection03.png differ diff --git a/figures/tutorial/figure_HeadsInCrosssection04.png b/figures/tutorial/figure_HeadsInCrosssection04.png new file mode 100644 index 0000000..ad73a7f Binary files /dev/null and b/figures/tutorial/figure_HeadsInCrosssection04.png differ diff --git a/figures/tutorial/figure_LeakageEffectCorner.png b/figures/tutorial/figure_LeakageEffectCorner.png new file mode 100644 index 0000000..0824b41 Binary files /dev/null and b/figures/tutorial/figure_LeakageEffectCorner.png differ diff --git a/figures/tutorial/figure_LeakylinedoubletFeatureAttributes.png b/figures/tutorial/figure_LeakylinedoubletFeatureAttributes.png new file mode 100644 index 0000000..645ba43 Binary files /dev/null and b/figures/tutorial/figure_LeakylinedoubletFeatureAttributes.png differ diff --git a/figures/tutorial/figure_Leakylinedoublet_copy.png b/figures/tutorial/figure_Leakylinedoublet_copy.png new file mode 100644 index 0000000..072f5e0 Binary files /dev/null and b/figures/tutorial/figure_Leakylinedoublet_copy.png differ diff --git a/figures/tutorial/figure_Leakylinedoublet_icon.png b/figures/tutorial/figure_Leakylinedoublet_icon.png new file mode 100644 index 0000000..79959ff Binary files /dev/null and b/figures/tutorial/figure_Leakylinedoublet_icon.png differ diff --git a/figures/tutorial/figure_Observation_icon.png b/figures/tutorial/figure_Observation_icon.png new file mode 100644 index 0000000..0795a8f Binary files /dev/null and b/figures/tutorial/figure_Observation_icon.png differ diff --git a/figures/tutorial/figure_PythonExport01.png b/figures/tutorial/figure_PythonExport01.png new file mode 100644 index 0000000..dbf9ffd Binary files /dev/null and b/figures/tutorial/figure_PythonExport01.png differ diff --git a/figures/tutorial/figure_PythonExport02.png b/figures/tutorial/figure_PythonExport02.png new file mode 100644 index 0000000..b69f303 Binary files /dev/null and b/figures/tutorial/figure_PythonExport02.png differ diff --git a/figures/tutorial/figure_SchematizationTheHague.png b/figures/tutorial/figure_SchematizationTheHague.png new file mode 100644 index 0000000..fa928f4 Binary files /dev/null and b/figures/tutorial/figure_SchematizationTheHague.png differ diff --git a/figures/tutorial/figure_SheetPileExtraPoints.png b/figures/tutorial/figure_SheetPileExtraPoints.png new file mode 100644 index 0000000..375e714 Binary files /dev/null and b/figures/tutorial/figure_SheetPileExtraPoints.png differ diff --git a/figures/tutorial/figure_WellAttributeTable.png b/figures/tutorial/figure_WellAttributeTable.png new file mode 100644 index 0000000..b7366f0 Binary files /dev/null and b/figures/tutorial/figure_WellAttributeTable.png differ diff --git a/figures/tutorial/icon-probabiliticToolKit.png b/figures/tutorial/icon-probabiliticToolKit.png new file mode 100644 index 0000000..3f474e2 Binary files /dev/null and b/figures/tutorial/icon-probabiliticToolKit.png differ diff --git a/figures/tutorial/photo-TheHagueCityCentre.png b/figures/tutorial/photo-TheHagueCityCentre.png new file mode 100644 index 0000000..2354082 Binary files /dev/null and b/figures/tutorial/photo-TheHagueCityCentre.png differ diff --git a/figures/tutorial/photo-TheMonumentalEnvironment.png b/figures/tutorial/photo-TheMonumentalEnvironment.png new file mode 100644 index 0000000..a889814 Binary files /dev/null and b/figures/tutorial/photo-TheMonumentalEnvironment.png differ diff --git a/index.html b/index.html index dcad407..eed3e77 100644 --- a/index.html +++ b/index.html @@ -2,7 +2,7 @@ - + diff --git a/install.html b/install.html index c209063..94e26f5 100644 --- a/install.html +++ b/install.html @@ -2,7 +2,7 @@ - + diff --git a/search.json b/search.json index d030a48..c414b93 100644 --- a/search.json +++ b/search.json @@ -1,156 +1,254 @@ [ - { - "objectID": "index.html", - "href": "index.html", - "title": "QGIS-Tim", - "section": "", - "text": "QGIS-Tim is an open source project for multi-layer groundwater flow simulations. QGIS-Tim provides a link between QGIS and the open source analytic element method software: TimML (steady-state) and TTim (transient).\nThe benefit of the analytic element method (AEM) is that no grid or time-stepping is required. Geohydrological features are represented by points, lines, and polygons. QGIS-Tim stores these features in a GeoPackage.\nQGIS-Tim consists of a “front-end” and a “back-end”. The front-end is a QGIS plugin that provides a limited graphical interface to setup model input, visualize, and analyze model input. The back-end is a Python package. It reads the contents of the GeoPackage and transforms it into a TimML or TTim model, computes a result, and writes it to a file that the QGIS plugin loads." - }, - { - "objectID": "install.html", - "href": "install.html", - "title": "Install", - "section": "", - "text": "QGIS-Tim consists of two parts: A QGIS plugin and the gistim Python package, which runs in a separate Python environment. The installation of QGIS-Tim therfore consists of three steps:" - }, - { - "objectID": "install.html#install-qgis", - "href": "install.html#install-qgis", - "title": "Install", - "section": "1. Install QGIS", - "text": "1. Install QGIS\nDownload and install a recent version of QGIS (>3.22): https://www.qgis.org/en/site/forusers/download.html" - }, - { - "objectID": "install.html#install-gistim-in-a-seperate-python-environment", - "href": "install.html#install-gistim-in-a-seperate-python-environment", - "title": "Install", - "section": "2. Install gistim in a seperate Python environment", - "text": "2. Install gistim in a seperate Python environment\ngistim requires a seperate Python environment, because it depends on packages incompatible with the packages in QGIS’ own Python environment. There are two approaches: either using the fully-fletched Deltaforge distribution (Recommended) or the leaner Miniforge distribution.\n\nMethod 1: with Deltaforge (recommended)\n\nDownload and install Deltaforge. Make sure you use Deltaforge version 0.3.0 or higher!\nOpen the Deltaforge prompt (search in Windows Start for \"Deltaforge Prompt\").\nConfigure the gistim installation, so that the QGIS plugin is able to find it. Run: python -m gistim configure\n\n\n\nMethod 2: with Miniforge\n\nDownload and install a miniforge Python installation\nOpen the miniforge prompt (search in Windows Start for \"Miniforge Prompt\").\nCreate a new conda environment, run: conda create \\--name tim python=3.9\nActivate the environment: conda activate tim\nRun: conda install -c conda-forge gistim\nConfigure the gistim installation, so that the QGIS plugin is able to find it. Run: python -m gistim configure" - }, - { - "objectID": "install.html#install-the-qgis-plugin", - "href": "install.html#install-the-qgis-plugin", - "title": "Install", - "section": "3. Install the QGIS plugin", - "text": "3. Install the QGIS plugin\n\nMethod 1: From the GQIS plugin database\nNB Due to ongoing developments new features and bug fixes might not be part of this release. Consider installation method 2.\n\nOpen QGIS.\nAt the top, find the Plugins menu (~sixth object in the menubar).\nFind \"Manage and Install plugins\" (~first object in drop-down).\nFind \"All\" (~first in left section).\nSearch for \"Qgis-Tim\".\nClick \"Install Plugin\".\n\n\n\nMethod 2: From Zip (recommended)\n\nDownload the \"QGIS-TIM-plugin.zip\" (do not unzip!) from the iMOD-Suite download portal.\nOpen QGIS.\nAt the top, find the Plugins menu (~sixth object in the menubar).\nFind \"Manage and Install plugins\" (~first object in drop-down).\nFind \"Install from ZIP\" (~fourth in left section).\nEnter the path to the file \"QGIS-TIM-plugin.zip\".\nClick \"Install Plugin\".\n\nThis will add an icon to the toolbar(s). By clicking the icon, the plugin is started. The QGIS plugin automatically starts an extra window for the background calculation of a TIM model. This black window is called Python.exe and can be minimized or even closed after the calculation." - }, { "objectID": "tutorial-QGIS-Tim.html", "href": "tutorial-QGIS-Tim.html", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "", "text": "Be sure QGIS version 3.22.00 or higher is installed.\nBe sure the gistim Python package is installed (see installation for instructions).\nDownload the tutorial material. Follow this link.\nInstallation of the QGIS-Tim plugin and the MOD plugin is part of this Tutorial. The necessary ZIP files are included in the tutorial material.\nInternet connections is optional during this Tutorial. It is only required for installation of additional plugins and the use of an online topographic background map." }, { "objectID": "tutorial-QGIS-Tim.html#requirements", "href": "tutorial-QGIS-Tim.html#requirements", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "", "text": "Be sure QGIS version 3.22.00 or higher is installed.\nBe sure the gistim Python package is installed (see installation for instructions).\nDownload the tutorial material. Follow this link.\nInstallation of the QGIS-Tim plugin and the MOD plugin is part of this Tutorial. The necessary ZIP files are included in the tutorial material.\nInternet connections is optional during this Tutorial. It is only required for installation of additional plugins and the use of an online topographic background map." }, { "objectID": "tutorial-QGIS-Tim.html#description", "href": "tutorial-QGIS-Tim.html#description", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Description", - "text": "Description\nIn this tutorial, you will learn how to:\n\ninstall and use the QGIS-Tim plugin;\nuse the basic of QGIS for pre- and postprocessing of Tim;\ncreate several steady state models (TimML) and a transient model (TTim);\nanalyse the results;\nexport your model to a Python script." + "text": "Description\nIn this tutorial, you will learn how to:\n\ninstall and use the QGIS-Tim plugin;\nuse the basic of QGIS for pre- and postprocessing of TIM;\ncreate several steady state models (TimML) and a transient model (TTim);\nanalyse the results;\nexport your model to a Python script." }, { "objectID": "tutorial-QGIS-Tim.html#objective", "href": "tutorial-QGIS-Tim.html#objective", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Objective", - "text": "Objective\nWith the basic experience from this tutorial and the online documentation on Tim you are able to use Tim in your daily work." + "text": "Objective\nCalculation of a pumping well extraction." }, { "objectID": "tutorial-QGIS-Tim.html#introduction-case-rijsenhout", "href": "tutorial-QGIS-Tim.html#introduction-case-rijsenhout", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Introduction case Rijsenhout", "text": "Introduction case Rijsenhout\nIn one of the fields west of Rijsenhout industrial activities are planned, the construction of green houses. From historical sources it is known that some bombs from World War 2 are still in the surface. Before building starts, these bombs are removed for safety reasons. The question is: what dewatering is necessary to be able to remove the bombs in dry conditions? The contractor plans to drill sheet piles to prevent the excavation from collapsing. The groundwater level inside the building pit is lowered with a set of wells just in the top of the aquifer within the building pit. All pumped water is infiltrated over a stretch of wells near the existing buildings. At the project location, the top layer is 12 m thick and consists of a low permeable combination of clay and peat. Below this top layer we find an aquifer of 50 m. The Westeinderplassen, a lake system with a depth of 3 m., is located East of the project area.\n\n\n\nFigure 1: Geological cross section near Rijssenhout [source: BRO GeoTOP v1.4.1]" }, { "objectID": "tutorial-QGIS-Tim.html#getting-started", "href": "tutorial-QGIS-Tim.html#getting-started", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Getting Started", - "text": "Getting Started\nLet’s first configure the gistim python installation again, to be sure that QGIS can find the gistim software.\n\nOpen the Deltaforge prompt (search in Windows Start for “Deltaforge Prompt”). A black window pops up.\nIn this window type python -m gistim configure and press ENTER.\nYou can close this window now.\nLaunch QGIS from your START menu, from your desktop or click on …\\QGIS3.28.0\\bin\\qgis-bin.exe.\n\n\nIntermezzo: QGIS language settings\nPerhaps your QGIS was installed in another language than English. Because the Tutorial refers to the English version, let’s change to English.\n\nFrom the main menu click on Settings and select Options (e.g. in Dutch Extra and Opties).\nIn the new window go to the General section (Dutch: Algemeen) on the left.\nCheck the box to allow Override System Locale (Dutch: Landinstellingen negeren) and expand this sub menu.\nFrom the drop-down menu “User interface translation” (Dutch: Vertaling gebruikers-interface) select American English and click OK.\nClose QGIS and open it again to activate your language change.\n\n\nWe start with the creation of a new QGIS project.\n\nFrom the main menu click on Project and select New.\n\nThe case in this tutorial is located in The Netherlands, so next we select the appropriate projection.\n\nFrom the main menu click on Project and select Properties.\nIn the Properties window select the category CRS, search for “EPSG:28992” and you find “Amersfoort / RD New”. Select this option and click the Apply button, followed by the OK button to close the window.\n\n\nIn case your work is mostly in The Netherlands and in the “Amersfoort / RD New” projection, consider making this your default projection.\n\nFrom the main menu click on Settings and select Options….\nIn the section CRS and Transforms select CRS (handling), pick the radio button Use a default CRS and select “EPSG:28992 -Amersfoort / RD New”.\nClick OK.\nClose this window.\n\n\n\nInstall plugins\nThis is the moment to download/import four plugins needed for this tutorial:\n\nthe QGIS-Tim plugin. The development version imported from ZIP file.\nthe iMOD plugin. The development version imported from ZIP file.\nthe Value Tool. The official version installed via QGIS (internet connection required).\nthe PDOK plugin. The official version installed via QGIS (internet connection required). This plugin gives access to a large database from which we will load the topographic maps and use the navigation option.\n\n\nGo to Plugins from the main menu and select Manage and Install Plugins… to open the plugin window.\nOn the left section select Install from ZIP.\nClick the Browse button () and from the tutorial dataset select the ZIP file “QGIS-Tim_Tutorial\\QGIS-iMOD-plugin.zip”.\nClick Install Plugin.\nIn the same way, install the QGIS-Tim plugin using the ZIP file “QGIS-Tim_Tutorial\\QGIS-Tim-plugin.zip”.\n\nIf you have an internet connection continue with the installation of the next two plugins from the QGIS plugin library.\n\nFrom the left section, select the group All to see all available plugins.\nSearch for “Value Tool” and install it.\nSearch for “PDOK services plugin” and install it.\nMake sure that under Plugins > Manage and Install Plugins > Installed now the 4 added plugins are checked.\nClose the Plugins window.\n\nSee in the toolbar section of QGIS that the plugins are installed:\n\niMOD Toolbar \nQGIS-Tim \nValue Tool \nPDOK Services Plugin \n\nFurther in this Tutorial we will use some default toolbars that might be hidden at the moment. Let’s check that and unhide if necessary.\n\nSelect View from the main menu and choose Toolbars.\nBe sure the “Advanced Digitizing Toolbar”, the “Snapping Toolbar” and the “Attributes Toolbar” are checked.\n\n\n\nPrepare your project\nFor navigation purposes, let’s load a topographic map for The Netherlands from the online PDOK database.\n\nNo internet connection? Follow the next steps to import a simple PNG file as a background.\n\nGo to Layer in the main menu, go to Add layer and select Add Raster layer.\nUse the browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\TopographicMapRijssenhout.png”.\nClick on Add and Close the window.\nIf you do not see the map, select the layer “TopographicMapRijssenhout”, click your right mouse button and select “Zoom to Layer(s)”.\nContinue after step 26.\n\n\n\nIf you do have an internet connection click on the PDOK plugin button () to open the “PDOK Services Plugin” window.\nFrom the tab PDOK Services search for “pastel” and you will find a WMTS type layer called “brtachtergrondkaart”.\nSelect the layer.\nIn the section “laag toevoegen” click the button Onder.\nClose the PDOK window.\n\nOur project area is near the town of Rijsenhout so let’s navigate to that town using the PDOK plugin.\n\nType “Rijsenhout” in the PDOK search field, near the PDOK button ()\nPDOK will find “Rijsenhout, Haarlemmermeer, Noord-Holland”. Click on it and QGIS will fly you to the project location.\n\nLet’s now open a shape file containing the locations and depths of the bombs.\n\nGo to Layer in the main menu, go to Add layer and select Add Vector layer.\nUse the browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\bombs.shp”.\nClick on Add and Close the window.\n\n Tip: a fast alternative for adding layers: from the menu View > Toolbar add the Manage Layers Toolbar and use the button .\n\nIn the Layers panel on the left, select the layer “bombs”.\nClick your right mouse button and from the menu select Show Labels.\nYou can zoom in and out with the scroll button on your mouse or navigate with the buttons in the main menu: \nUse to pan the map with your left mouse button and use to zoom to the extend of the layers/groups selected in the Layers panel.\n\nLet’s save this project to be able to return to it later or in case of a crash of QGIS.\n\nGo to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\\QGIS-Tim_Tutorial\\Rijsenhout.qgz”" + "text": "Getting Started\nLet’s first configure the gistim python installation again, to be sure that QGIS can find the gistim software.\n\nOpen the Deltaforge prompt (search in Windows Start for “Deltaforge Prompt”). A black window pops up.\nIn this window type python -m gistim configure and press ENTER.\nYou can close this window now.\nLaunch QGIS from your START menu, from your desktop or click on …\\QGIS3.28.0\\bin\\qgis-bin.exe.\n\n\nIntermezzo: QGIS language settings\nPerhaps your QGIS was installed in another language than English. Because the Tutorial refers to the English version, let’s change to English.\n\nFrom the main menu click on Settings and select Options (e.g. in Dutch Extra and Opties).\nIn the new window go to the General section (Dutch: Algemeen) on the left.\nCheck the box to allow Override System Locale (Dutch: Landinstellingen negeren) and expand this sub menu.\nFrom the drop-down menu “User interface translation” (Dutch: Vertaling gebruikers-interface) select American English and click OK.\nClose QGIS and open it again to activate your language change.\n\n\nWe start with the creation of a new QGIS project.\n\nFrom the main menu click on Project and select New.\n\nThe case in this tutorial is located in The Netherlands, so next we select the appropriate projection.\n\nFrom the main menu click on Project and select Properties.\nIn the Properties window select the category CRS, search for “EPSG:28992” and you find “Amersfoort / RD New”. Select this option and click the Apply button, followed by the OK button to close the window.\n\n\nIn case your work is mostly in The Netherlands and in the “Amersfoort / RD New” projection, consider making this your default projection.\n\nFrom the main menu click on Settings and select Options….\nIn the section CRS and Transforms select CRS (handling), pick the radio button Use a default CRS and select “EPSG:28992 -Amersfoort / RD New”.\nClick OK.\nClose this window.\n\n\n\nInstall plugins\nThis is the moment to download/import four plugins needed for this tutorial:\n\nthe QGIS-Tim plugin. The development version imported from ZIP file.\nthe iMOD plugin. The development version imported from ZIP file.\nthe Value Tool. The official version installed via QGIS (internet connection required).\nthe PDOK plugin. The official version installed via QGIS (internet connection required). This plugin gives access to a large database from which we will load the topographic maps and use the navigation option.\n\n\nGo to Plugins from the main menu and select Manage and Install Plugins… to open the plugin window.\nOn the left section select Install from ZIP.\nClick the Browse button () and from the tutorial dataset select the ZIP file “QGIS-Tim_Tutorial\\QGIS-iMOD-plugin.zip”.\nClick Install Plugin.\nIn the same way, install the QGIS-Tim plugin using the ZIP file “QGIS-Tim_Tutorial\\QGIS-Tim-plugin.zip”.\n\nIf you have an internet connection continue with the installation of the next two plugins from the QGIS plugin library.\n\nFrom the left section, select the group All to see all available plugins.\nSearch for “Value Tool” and install it.\nSearch for “PDOK services plugin” and install it.\nMake sure that under Plugins > Manage and Install Plugins > Installed now the 4 added plugins are checked.\nClose the Plugins window.\n\nSee in the toolbar section of QGIS that the plugins are installed:\n\niMOD Toolbar \nQGIS-Tim \nValue Tool \nPDOK Services Plugin \n\nFurther in this Tutorial we will use some default toolbars that might be hidden at the moment. Let’s check that and unhide if necessary.\n\nSelect View from the main menu and choose Toolbars.\nBe sure the “Advanced Digitizing Toolbar”, the “Snapping Toolbar” and the “Attributes Toolbar” are checked.\n\n\n\nPrepare your project\nFor navigation purposes, let’s load a topographic map for The Netherlands from the online PDOK database.\n\nNo internet connection? Follow the next steps to import a simple PNG file as a background.\n\nGo to Layer in the main menu, go to Add layer and select Add Raster layer.\nUse the browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\TopographicMapRijssenhout.png”.\nClick on Add and Close the window.\nIf you do not see the map, select the layer “TopographicMapRijssenhout”, click your right mouse button and select “Zoom to Layer(s)”.\nContinue after step 26.\n\n\n\nIf you do have an internet connection click on the PDOK plugin button () to open the “PDOK Services Plugin” window.\nFrom the tab PDOK Services search for “pastel” and you will find a WMTS type layer called “BTRM Achtergrondkaart WMTS”.\nSelect the layer.\nIn the section “laag toevoegen” click the button Onder.\nClose the PDOK window.\n\nOur project area is near the town of Rijsenhout so let’s navigate to that town using the PDOK plugin.\n\nType “Rijsenhout” in the PDOK search field, near the PDOK button ()\nPDOK will find “Rijsenhout, Haarlemmermeer, Noord-Holland”. Click on it and QGIS will fly you to the project location.\n\nLet’s now open a shape file containing the locations and depths of the bombs.\n\nGo to Layer in the main menu, go to Add layer and select Add Vector layer.\nUse the browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\bombs.shp”.\nClick on Add and Close the window.\n\n Tip: a fast alternative for adding layers: from the menu View > Toolbar add the Manage Layers Toolbar and use the button .\n\nIn the Layers panel on the left, select the layer “bombs”.\nClick your right mouse button and from the menu select Show Labels.\nYou can zoom in and out with the scroll button on your mouse or navigate with the buttons in the main menu: \nUse to pan the map with your left mouse button and use to zoom to the extend of the layers/groups selected in the Layers panel.\n\nLet’s save this project to be able to return to it later or in case of a crash of QGIS.\n\nGo to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\\QGIS-Tim_Tutorial\\Rijsenhout.qgz”" }, { "objectID": "tutorial-QGIS-Tim.html#start-your-tim-model", "href": "tutorial-QGIS-Tim.html#start-your-tim-model", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Start your Tim model", "text": "Start your Tim model\nNow we are ready to activate the QGIS-Tim plugin.\n\nClick on the QGIS-Tim plugin button () and the QGIS-Tim panel appears.\nGo to the tab GeoPackage. Here we will create an empty database (geopackage) to store all elements and parameters for the model.\nClick the New button to create the GeoPackage and save it for instance in the folder with your tutorial data, e.g. “..\\QGIS-Tim_Tutorial\\dbase\\case-Rijsenhout.gpkg”.\n\nYour window looks like in Figure 2.\n\n\n\nFigure 2: QGIS-Tim panel\n\n\n\nCheck in the Layers panel on the left that your new geopackage is added as a group. A sub group timml for the steady state model input, the sub group ttim for the transient model input and a series of output formats (vector/mesh/raster).\n\nIf you had no introduction to the Tim plugin, read the Intermezzo below for a general explanation of the components.\n\nIntermezzo: introduction Tabs on the Tim panel\n\nGeoPackage: an overview of the elements in your geopackage. In case you switch to transient modelling, an extra column with ttim elements is added.\nElements: a list of 14 Tim elements from which you can build your model.\nCompute: here you can define your domain and cell size, decide if your model is transient or not and change the output name.\nExtract: open an existing 3d geohydrological model (NC file) and extract the data for your project area.\n\n\nNow we are ready to define our first steady state model by parameterizing our Aquifer." }, { "objectID": "tutorial-QGIS-Tim.html#model-1-single-aquifer", "href": "tutorial-QGIS-Tim.html#model-1-single-aquifer", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 1: single aquifer", "text": "Model 1: single aquifer\nWe start with a very simple ‘model’, only the parameters of a single aquifer. Important message: all editing of model parameters and model elements you do in the Layers panel on the left!\n\nSo select the layer “timml Aquifer:Aquifer” on the left.\nClick your right mouse button and from the menu select Attribute Table to open the table in a new window. NB Alternative is to press F6 or use the button Open Attribute Table ().\nStart the editing mode with a click on the Toggle Editing Mode button ().\nHover with your mouse over the buttons and find the Add Feature button (). Perhaps number 5 from left.\nAdd a new feature with this Add Feature button. In this case a feature is a hydrological layer.\nFill the feature with the values from the table below:\n\n\n\n\n\nparameter\nvalue\nunit\ncomment\n\n\n\n\nfid\nAutogenerate\n[-]\nID is autogenerated by QGIS\n\n\nLayer\n0\n[-]\n(see remark below)\n\n\naquifer_top\n+2\n[m MSL]\n\n\n\naquifer_bottom\n-10\n[m MSL]\n\n\n\naquifer_c\nNULL\n[d]\n\n\n\naquifer_k\n5\n[m/d]\n\n\n\nsemiconfined_top\nNULL\n[m MSL]\n\n\n\nsemiconfined_head\nNULL\n[m MSL]\n\n\n\n\nNB! In the real world counting starts with 1. However, Tim is programmed in Python and in Python counting starts with 0. You will get used to it. Also be aware that the Aquifer element you just edited is just a table. This is indicated with the icon () just before the layer name in the left panel. For Tim this means that the properties in this table apply for the full model domain. We will introduce some inhomogeneities later as polygons within that domain.\n\nSave all changes with the Save Edits button ().\nStop the Editing Mode with a click on the button ().\nClose the Attribute Table window with a click on the X in the upper right corner.\nGo to the tab Compute in QGIS-Tim.\nClick the button Set to current extent.\nStart the calculation with a click on Compute.\n\nA black Python.exe window pops up indicating that the TIM calculation started on the background. You can ignore this window but keep it open. Of course you van minimize it. If the calculation was completed successful, you will see this echo in QGIS.\n.\nAfter the calculation you see that the result is automatically added to a new geopackage, probably called “case-Rijsenhout output”. Results are saved both as mesh and raster. For each format a separate sub group is created. Although these layers / groups are checked, the data is not visible. That is because the geopackage was added last, and QGIS adds layers at the end of the list. Let’s move the layer “pastel” to the background.\n\nSelect the layer “pastel” and drag it with your left mouse button to the bottom of the list of layers.\n\nThe calculation result is now visible and we see a raster with just the value 0, not a very exciting result because no other elements are present yet. Let’s now add a well element.\n\nIntermezzo: Mesh and Raster format explained\n\nMesh: an unstructured grid usually with temporal and other components. Preferred format in QGIS-Tim to animate temporal data, to create cross sections or evaluate values at your mouse position.\nRaster: is made up of pixels (also referred to as grid cells). They are regularly spaced and square. Preferred format in QGIS-Tim to perform calculations with the Raster Calculator tool." }, { "objectID": "tutorial-QGIS-Tim.html#model-2-single-well", "href": "tutorial-QGIS-Tim.html#model-2-single-well", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 2: single well", "text": "Model 2: single well\n\nFirst hide the output layers by deselecting both the rasters (case-Rijsenhout-output:raster) and meshes (case-Rijsenhout-output:mesh).\nGo to the tab Elements in QGIS-Tim.\nClick on the element “Well” and a window opens to create a new (vector) layer in QGIS.\nGive the layer a name, e.g. “DewateringWell”.\n\nSee that layer “timml Well:DewateringWell” is added to the timml sub group in your geopackage with ‘point’ as geometry. Also in the ttim sub group an element with the same name is added. This is a table that can store transient well data while referring to the x/y locations in the timml layer. Next step is to add the actual well, both the location and its parameters.\n\nSelect the layer “timml Well:DewateringWell”.\nClick your right mouse button and select the Toggle Editing Mode ().\nTo add a new well (feature) to the layer click the Add Point Feature button ().\nWith your mouse, click on a location in the centre of the group of bombs.\nFill the feature with the values from the example below.\n\n\n\nClick OK.\nClick the Toggle Editing button () and if you are asked to save changes and select Save. An alternative way to save your edits is to click the Save Layer Edits button () and then stop editing with the Toggle Editing button ().\n\nNext step is to rerun the model including the new well.\n\nIn QGIS-Tim go to the tab GeoPackage and see that the Well is added.\nGo to the tab Compute and click on Compute.\n\nThe output in your ouput group “case-Rijsenhout output” is directly overwritten with the new results.\n\nOpen the sub group raster and see the created raster “case-Rijsenhout-head_layer_0”.\n\nDo you like to see the values of the calculated Head under you mouse?\n\nDeselect the output sub group mesh.\nSelect the Value Tool button ().\nHover over the area and in the “Value Tool” panel you see the value within the raster file at your mouse location.\n\n\n\n\nFigure 3: Example panel Value Tool\n\n\nDo you like to see the values in a cross section? Deltares developed the Cross Section Tool, available in the iMOD Plugin.\n\nOn the iMOD Toolbar select the Cross section button () to start the iMOD Cross Section tool. In the empty cross-section we can add a selection of (geological) layers. For now, we only select the calculated heads.\nOn the iMOD Cross Section Plot click on the button Select location and draw your cross-section line from north to south (right mouse button to close the line).\nFrom the dropdown menu on the left of this toolbar, select the raster () named “case-Rijsenhout-head_layer_0”.\nClick the button Add to add this layer to the cross-section manager below.\nClick the button Plot to draw this layer in the cross section.\n\nYour screen might look like Figure 4.\nTIP: If you do not see any line, perhaps the axes are not defined well. To view all data, click you right mouse button in the figure and select the option “View All”. The alternative is to click on the small A symbol () in the lower left of the chart.\n\n\n\nFigure 4: Cross section with calculated Head" }, { "objectID": "tutorial-QGIS-Tim.html#model-3-multiple-layers", "href": "tutorial-QGIS-Tim.html#model-3-multiple-layers", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 3: multiple layers", "text": "Model 3: multiple layers\nA single aquifer is of course not enough to describe the geology of our project area. A simplification of the geology is given in the cross section in Figure 5. In this low lying polder, there is a Holocene top layer of 12 m thickness on top of an aquifer. The surface level of the top layer is 5 m below see level, it has a resistance of 1500 days and the water level within this polder is 1 meter below surface level. The aquifer has a horizontal permeability of 30 m/d and a thickness of 50 m. The anisotropy factor is 3 resulting in a vertical resistance of 0.1 day per meter. Tim can handle multiple layers so the next step is to bring these parameters into the model.\n\n\n\nFigure 5: Project area cross section (left) lifting the World War II bomb (right)\n\n\n\nIn your geopackage select the layer “timml Aquifer:Aquifer” and click your right mouse button.\nFrom the menu select Open Attribute Table and the table opens in a new window. Once again, press F6 for a quick open of the Attribute Table.\nStart the editing mode with a click on the Toggle Editing Mode button ().\nAdd three extra aquifers / features; click three times on the Add Feature button ().\n\nThe Holocene top layer is not a distinguished layer but a resistance on top of layer 0.\n\nFill the features with the values from the table below:\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nfid\nlayer\naquifer_top\naquifer_bottom\naquitard_c\naquifer_k\nsemiconf_top\nsemiconf_head\n\n\n\n\n1\n0\n-17\n-22\n1500\n30\n-5\n-6\n\n\n2\n1\n-22\n-27\n0.5\n30\nNULL\nNULL\n\n\n3\n2\n-27\n-47\n1.25\n30\nNULL\nNULL\n\n\n4\n3\n-47\n-67\n2\n30\nNULL\nNULL\n\n\n\n\nSave your changes and close the window.\nGo to the tab Compute and run the new model with a click on the button Compute.\n\nLet’s now check the calculated heads for the 4 layers, first with the Value Tool and then with the Cross section tool.\n\nFrom the layers select the layer “case-Rijsenhout-output:raster” and deselect the “case-Rijsenhout-output:mesh”.\nActivate the Value Tool ().\nIn the Value Tool panel go to the tab Options.\nFor Show Layers choose “Visible layers” and for Show bands choose “Active bands”.\nReturn to the tab Table and hoover over the calculated values, especially near your well.\nActivate the iMOD Cross section widget () to create your cross section with the four layers (Need instructions? Go back to step 69 for support). NB You don’t need to ‘add’ all four layers separately. Just use the raster file “case-Rijsenhout-head_layer_0” and from the dropdown menu Variable: select the four bands/layers." }, { "objectID": "tutorial-QGIS-Tim.html#model-4-add-a-set-of-sheet-piles", "href": "tutorial-QGIS-Tim.html#model-4-add-a-set-of-sheet-piles", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 4: add a set of sheet piles", "text": "Model 4: add a set of sheet piles\nNow we introduce a new but frequently used element: the sheet pile.\n\nReturn to the QGIS-Tim panel and go to the tab Elements.\nClick on the element “Leaky Line Doublet”.\nGive the layer a name, e.g. “sheetpile”.\nIn your geopackage select the layer “timml Leaky Line Doublet:sheetpile” and start editing using the Toggle Editing Mode button ().\nIn the editing mode, the Add Line Feature button () is available. Click the button and draw a box around the 5 bombs (click left to start, click right to close).\nIn the Feature Attributes window make resistance = 1500 and layer = 0.\nClick OK.\n\nYou probably tried to close the building pit but either your lines cross or do not close actually when zooming in. To close the pit, let’s snap both start and end point together.\n\nFirst enable the snapping mode with a click on the button ().\nThen activate the Vertex Tool with a click on the button .\nMove your mouse to the start point location and when it shows a small circle, click your left mouse button.\nNext, move your mouse towards the end point and you see the snapping active: the end point gets a small fuchsia box.\nClick your left mouse and you see that both vertices now connect.\n\nPerhaps you are not satisfied with your created building pit.\n\nYou can play around with other nice options in QGIS to move (), rotate () or scale () your pit.\nEnd the Toggle Editing Mode with and save your changes.\nIn the QGIS-Tim panel go to Compute.\nRerun your model and check the calculated heads.\n\nDisappointed in the effect of the sheet piles on the calculated head? You are right if you expected no major effect because of the shallow penetration in this high permeable thick aquifer. If we would increase the aquitard_c between layers 0 and 1, perhaps we would see more effect of the sheet piles. \n\nIf you dare… try to rerun the model yourself with aquitard_c = 800 (layer 1) and see that the drawdown is limited to the building pit (Figure 6.)\nDon’t forget to undo this side path and make aquitard_c = 0.5 again for layer 1.\n\n\n\n\nFigure 6: Drawdown within the building pit" }, { "objectID": "tutorial-QGIS-Tim.html#how-to-reopen-tim-after-closing-qgis.", "href": "tutorial-QGIS-Tim.html#how-to-reopen-tim-after-closing-qgis.", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": " How to reopen Tim after closing QGIS.", "text": "How to reopen Tim after closing QGIS.\nBefore we introduce you another new Tim element we must explain you how to reopen your Tim project after a closure of QGIS. A crash might close QGIS or just a long day of work is a reason to shut down your laptop. Always remember two things:\n\nyour geopackage (*.gpkg) contains the complete set of model features and parameter values. Every time you change a model element, you will remember, you had to save the changes. So the GPKG file is always up to date.\nyour QGIS project is saved in the *.qgz file and contains all the added layers and their format (legend, line color, labels etc.).\n\nNow let’s experience what it is to close and open QGIS including your QGIS-Tim project.\n\nSave your QGIS session (Ctrl+S).\nSelect Project from the main menu and choose New.\nAgain select Project but now choose Open Recent and find your own project in the list.\nOpen the QGIS-Tim plugin with a click on .\n\nThe Tim panel is empty but why? It is not possible for the plugin to read your geopackage as it is loaded in the layer list. To load your Tim project you must open the geopackage from the Tim panel. This will add the geopackage to the Layers panel next to the existing one with the same name, which makes it at least confusing. We better remove the original Geopackage first before opening it with Tim. Disadvantage is that we also remove the calculated results including all your formatting efforts. The developers try to fix that in the next version. The following steps are the right way to go for now:\n\nSelect layer case-Rijsenhout input in the panel on the left in order to remove it.\nClick your right mouse button and select Remove Group… and click OK.\nIn the same way remove layer case-Rijsenhout output.\nIn the QGIS-Tim panel on the tab GeoPackage click Open and open the GPKG file containing your model.\nYour geopackage is now added to the Tim panel and the Layers list. Don’t forget to move down the background layer “pastel”." }, { "objectID": "tutorial-QGIS-Tim.html#model-5-add-infiltration-of-drainwater", "href": "tutorial-QGIS-Tim.html#model-5-add-infiltration-of-drainwater", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 5: add infiltration of drainwater", "text": "Model 5: add infiltration of drainwater\nTo prevent damage on the private properties caused by the dewatering, the authorities demand 50% of the drained flux to be infiltrated. For the infiltration a horizontal well of 400 m is used. In Tim this element is called “Line Sink Ditch”. Let’s add this element just along the Aalsmeerderweg southeast of the project area.\n\nOn the tab Elements in QGIS-Tim click on the element “Line Sink Ditch”.\nGive the layer a name, e.g. “InfiltrationWell”.\n\nSee that layer “timml Line Sink Ditch:InfiltrationWell” is added to the timml sub group in your geopackage with ‘line’ as geometry. For the transient sum a table with the same name is added to the ttim sub group. Next step is to add the location of the well and its capacity.\n\nClick the *Measure Line” button () from the “Attributes Toolbar”.\nWith your left mouse button try to get an idea what a distance of 400 m. looks like. Close the window.\nSelect the layer “timml Line Sink Ditch:InfiltrationWell”.\nStart editing with the Toggle Editing Mode.\nUse the Add Line Feature button () to draw a 400 m line (click left to start, click right to close).\nFill these feature within the table: discharge = -1000 (negative abstraction is into the model), resistance = 1, width = 1, layer = 0! not NULL ;-). By default order = 4.\nClick OK.\nStop editing the layer, save your changes.\nRerun the model.\nAnalyse the results with the iMOD Cross Section widget. Your graph may look like Figure 7.\n\n\n\n\nFigure 7: Calculated head from the abstraction (left) to the infiltration (right)" }, { "objectID": "tutorial-QGIS-Tim.html#model-6-add-observation-points", "href": "tutorial-QGIS-Tim.html#model-6-add-observation-points", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 6: add observation points", "text": "Model 6: add observation points\nWe have the Value Tool and the Cross section tool to check for calculated values in the rasters. Besides that, Tim has the opportunity to add observation points automatically providing you with the calculated heads.\n\nOn the tab Elements in QGIS-Tim click on the element “Observation”.\nGive the layer a name, e.g. “Piezometers”.\nStart editing with the Toggle Editing Mode and use Add Point Feature button () to add 5 points in line with 1 really close to the dewatering well (see Figure 8).\nSave your changes and rerun the model.\n\n\n\n\nFigure 8: Observation locations (A-E) together with other Tim elements\n\n\nThe observed values are saved in a new layer under the existing group “case-Rijsenhout output” and sub group “vector”.\n\nIn this sub group select the layer “case-Rijsenhout-timml Observation:Piezometers” and check the calculated values within this layer by opening the Attribute Table (F6).\nClose the Attribute Table.\n\nOne way of displaying the calculated results is still missing: contour lines.\n\nIn QGIS-Tim go to the tab Compute.\nIn the section Contour select layer “case-Rijsenhout-head_layer_0”.\nDefine the contours from -9 to -5 with an increment of 0.10 and click Export contours.\n\nA layer with your contours is saved in the group “case-Rijsenhout-output:vector”. Your map hopefully looks like Figure 9. If not, try to change the contour settings and create a better contour map.\n\n\n\nFigure 9: Calculated heads, displayed as contour lines" }, { "objectID": "tutorial-QGIS-Tim.html#model-7-determine-the-influence-of-the-nearby-lake", "href": "tutorial-QGIS-Tim.html#model-7-determine-the-influence-of-the-nearby-lake", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 7: determine the influence of the nearby lake", "text": "Model 7: determine the influence of the nearby lake\nEast of the project area there is a large lake. What will be the influence of this lake? Let’s find out. In Tim a lake is added as an inhomogeneity within the total model domain. This domain is described in table “timml Aquifer:Aquifer” we filled in with the first model.\n\nOn the tab Elements in QGIS-Tim click on the element “Polygon Semi-Confined Top”.\nGive the layer a name, e.g. “Lake” and find out that layer “timml Polygon Semi-Confined Top:Lake” is added to the geopackage.\nStart editing with the Toggle Editing Mode and use Add Polygon Feature button () to add the Lake contour. NB Try to minimize the number of segments because each segment slows down the calculations. With QGIS it is tempting to use detail but the influence of detail on the outcome is small.\nFill the Lake feature with the following parameters: aquitard_c = 500, semiconf_top = -7 (bottom of the Lake) and semiconf_head = -2 (water level).\nSave your changes and rerun the model.\nAnalyse the results and perhaps create contour lines from the tab “Compute”.\n\n\n\n\nFigure 10: Contour lines after adding the Lake element in the east\n\n\nYou can not miss the effect of the Lake in this calculation. In many cases you like to analyse or even save this difference. Let’s see how we can use Tim and QGIS to isolate the effect. Therefor we rerun the model without the Lake and rename the output.\n\nIn QGIS-Tim go to the tab Geopackage.\nIn the list of Steady State elements switch off “timml Polygon Semi-Confined Top:Lake”.\nGo to the tab Compute.\nClick the button Set path as … and change the name of the output, e.g. “case-Rijsenhout-NoLake”.\nClick Compute to run the model without the Lake.\n\nThe new results are added as new layer to the project. Check for instance sub group “raster” under the group “case-Rijsenhout output”. Now we use QGIS to calculate the head difference for layer 0. For raster calculations we prefer Raster Calculator over the Mesh Calculator in QGIS.\n\nFrom the QGIS main menu Raster select the tool Raster Calculator and the tool window opens.\nIn the section Raster Calculator Expression you can create an expression using the elements from Raster Bands and Operators. Create this expression: “case-Rijsenhout-head_layer_001 - case-Rijsenhout-NoLake-head_layer_001”.\nIn Output layer give a new name for this new GeoTIFF file, e.g. “head-effect-lake”.\nClick OK to start the calculation and see that the GeoTIFF file is added as a layer.\nIn the properties of layer “head-effect-lake” go to the section Symbology and set the Render type to “Singelband pseudocolor”.\nSee that the difference in head is maximum 3 meter.\nIn Geopackage check again the Lake element.\nIn Compute reset the path to the old name." }, { "objectID": "tutorial-QGIS-Tim.html#model-8-abstraction-effect-over-time", "href": "tutorial-QGIS-Tim.html#model-8-abstraction-effect-over-time", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Model 8: abstraction effect over time", "text": "Model 8: abstraction effect over time\nNow you are ready for the last step: make your model transient. We keep it simple: we run the model for 30 days and see the increasing effect of the well.\n\nIn Compute within the output section change “steady state” into “transient”.\nGo to Geopackage and see that only 5 elements have a transient component.\n\nBy selecting the “transient” option, columns containing extra parameters necessary for a transient model have been unhidden now. First of all we see it in the layer “timml Aquifer:Aquifer” where columns “storage” and “porosity are visible now.\n\nIn your geopackage select the layer “timml Aquifer:Aquifer”.\nOpen its table, start the editing mode and for every layer set both acquifer_s and acquitard_s to 0.001. Acquitard_s (layer 0) = 0.25. You can use copy and paste to do it quickly.\n\nNB! In transient mode, Tim can not handle aquitard with zero thickness so let’s set the aquitard thickness to 0.1 m\n\nChange the values in the column “aquifer_top” to -17.0, -22.1, -27.1 and -47.1 m.\nIn your geopackage select the layer “ttim Temporal Settings:Aquifer” to define the temporal properties of the model.\nOpen its table, start the editing mode and add a new feature.\nMake sure that tmin=0.01, tmax=30, tstart=0, reference_date=2023-03-23 00:00:00.\nIn your geopackage select the layer “ttim Computation Times:Domain” in order to define the moments in time for which raster output is saved.\n\nOpen its table, start the editing mode and add 7 features / periods (click 7 times “Add feature”).\nIn the column “time” add the moments 1,2,5,10, 15, 20 and 30.\nSave and Close the table.\n\nFor the observations we can define a different set of output moments.\n\nIn your geopackage select the layer “ttim Observation:Piezometers”.\n\nOpen its table, start the editing mode and add 10 features / periods (click 10 times “Add feature”).\nIn the column “time” add the moments 1,2,3,4,5,10,15,20,25 and 30.\nSave and Close the table.\n\nSpecial attention for the Well package while it has 2 options to make it transient:\n\nSimple: a well can be switched on and off only once. Parameters are set in the stationary part of the model, so in “timml Well:DewateringWell”.\nDetailed: a well can be switched on and off multiple times within the modelled period. Parameters are set in the transient part of the model, so in “ttim Well:DewateringWell”.\n\nIn this tutorial we show you the simple version.\n\nIn your geopackage select the layer “timml Well:DewateringWell”.\n\nOpen its table, start the editing mode and see that columns with time dependent parameters are visible now.\nSwitch off the Steady State abstraction, make discharge = 0.\nSwitch on the Transient abstraction: time_start = 2, time_end = 30, discharge_transient = 2000, caisson_radius = 1.\nSave your changes.\nCompute your transient model in the tab Compute.\n\nIn case of a successful calculation a new layer is added to your Vector output: case-Rijsenhout-ttim Observation:Piezometers. This layer contains transient data which is indicated with the clock icon right from the layer name. There are 2 ways to visualize these calculated heads in the observations point a) animation over time and b) timeseries at location.\n\nFor the animation over time, activate the Temporal Control Panel with the button on the Map Navigation Toolbar.\nFor timeseries at location activate the Timeseries panel with the Timeseries button () on the iMOD Toolbar.\nBe sure that “case-Rijsenhout-ttim Observation:Piezometers” is checked and “case-Rijsenhout-timml Observation:Piezometers” is unchecked.\nIn the Temporal Controller panel click the green play button (). Navigation buttons appear.\nIncrease the Step to 16 hours and start the animation with a click on the Play button ().\n\nOnly the first few days you see most prominent drawdown. Let’s now display the timeseries at the point of your mouse with data from the mesh.\n\nGo to the iMOD Time Series panel.\nBe sure the layer “case-Rijsenhout-head_layer_0” is selected.\nFor “variable:” select head and for “layers:” select 0.\n\nClick the button Select Points, your mouse changes into a . Be sure Update on Selection is checked and hover over the mesh. The graph shows the timeseries at the location of your mouse.\nDeselect the checkbox Update on Selection.\nClick the button Select Points (your mouse becomes a and with the left mouse button select 3 points ad random.\nFinally click the Plot button and the 3 timeseries are added to the chart.\n\nIn the same way you can display the time series from the Observations.\n\nIn the iMOD time series panel select the layer “case-Rijsenhout-ttim Observation:Piezometers”.\nFor “ID column:” select label and for “Variable:” select head_layer0. Don’t forget to deselect fid.\n\nClick the button Select Points and draw a box with your mouse to select one or more observation points.\nClick the Plot button and the selected timeseries are added to the chart.\n\n\n\n\nFigure 11: Calculated time series at observations locations\n\n\nBefore closing the display we change the line properties and save the graph as a PNG file.\n\nSelect the single time series for the observation point closest to your dewatering well. The color of the line is now visible in the field next to the button Line Color.\nChange the color to red.\nSelect the timeseries with the most shallow timeseries and change the color to green.\nCheck the box Draw markers.\nMove your mouse to the display and click your right mouse button. Explore the different options.\nFrom this menu (or from the display) select the function Export….\nSet the export format to PNG and export the file and don’t forget to close the Export window." }, { "objectID": "tutorial-QGIS-Tim.html#export-your-tim-model-to-python", "href": "tutorial-QGIS-Tim.html#export-your-tim-model-to-python", - "title": "Tutorial QGIS-Tim", + "title": "Tutorial Building Pit", "section": "Export your Tim model to Python", "text": "Export your Tim model to Python\nFor scenario calculation or sensitivity analysis you probably want to switch from QGIS to Python for efficiency reasons. In this tutorial we only show you the first step: export your model to a Python file (*.py). Your Tim model is just a set of elements (points, lines, polygons) and its parameters so the Python file is not very large.\n\nIn QGIS-Tim go to the tab GeoPackage.\nClick the button Convert GeoPackage to Python script and you can save the *.py file wherever you like.\nCheck the content of the file with you text editor (e.g. Notepad).\n\nThe tutorial ends here. You can save your QGIS project if you like. Thank you!" + }, + { + "objectID": "tutorial-TheHague.html", + "href": "tutorial-TheHague.html", + "title": "Tutorial The Hague building pit", + "section": "", + "text": "Be sure QGIS version 3.22.00 or higher is installed.\nBe sure the gistim Python package is installed (see installation for instructions).\nDownload the tutorial material. Follow this link.\nInstallation of the QGIS-Tim plugin and the MOD plugin is part of this Tutorial. The necessary ZIP files are included in the tutorial material.\nInternet connections is optional during this Tutorial. It is only required for installation of additional plugins and the use of an online topographic background map." + }, + { + "objectID": "tutorial-TheHague.html#requirements", + "href": "tutorial-TheHague.html#requirements", + "title": "Tutorial The Hague building pit", + "section": "", + "text": "Be sure QGIS version 3.22.00 or higher is installed.\nBe sure the gistim Python package is installed (see installation for instructions).\nDownload the tutorial material. Follow this link.\nInstallation of the QGIS-Tim plugin and the MOD plugin is part of this Tutorial. The necessary ZIP files are included in the tutorial material.\nInternet connections is optional during this Tutorial. It is only required for installation of additional plugins and the use of an online topographic background map." + }, + { + "objectID": "tutorial-TheHague.html#description", + "href": "tutorial-TheHague.html#description", + "title": "Tutorial The Hague building pit", + "section": "Description", + "text": "Description\nIn this tutorial, you will learn how to:\n\ninstall and use the QGIS-Tim plugin;\nuse the basic of QGIS for pre- and postprocessing of Tim;\ncreate several steady state models (TimML) and a transient model (TTim);\nanalyse the results;\nexport your model to a Python script." + }, + { + "objectID": "tutorial-TheHague.html#objective", + "href": "tutorial-TheHague.html#objective", + "title": "Tutorial The Hague building pit", + "section": "Objective", + "text": "Objective\nCalculation of a pumping well extraction." + }, + { + "objectID": "tutorial-TheHague.html#introduction-case-the-hague", + "href": "tutorial-TheHague.html#introduction-case-the-hague", + "title": "Tutorial The Hague building pit", + "section": "Introduction case The Hague", + "text": "Introduction case The Hague\nIn the old city centre of The Hague a building plan with a parking basement is constructed. The dimensions of the building pit are 34.2 m * 83.2 m. The area is shown in Figure 1.\n\n\n\nFigure 1: Schematization of the building area in The Hague city centre (orange: building pit)\n\n\nTo carry out the construction in dry conditions, the groundwater level needs to be lowered by 3.5 m. The required drainage time is 4 months. The environment is vulnerable with valuable buildings and monuments (see Figure 2) that have a shallow foundation. The subsoil consists of sandy layers which locally contain shallow peat/clay/silt layers and deeper layers of clay/silt. The builder contractor must use a sheet pile wall that needs to be installed in a water-retarding layer (aquitard).\n\n\n\nFigure 2: The monumental environment\n\n\nThe questions to be elaborated in the hydrogeological advice is: “How deep should a sheet pile wall be placed to prevent damage? Can risks arise from a leak?”\nApplications of a sheet pile wall (with a hydraulic resistance of 100 days) and a concrete cut off wall (with a hydraulic resistance of 1000 days) need to be studied.\nThe soil profile has been investigated with borings and CPTs. An example of a CPT is shown in Figure 3.\n\n\n\nFigure 3: CPT to a depth of NAP -20 m\n\n\nThe interpretation of the CPT and borings gives the following soil layer scheme:\n\nThe soil mainly consist of fine sand in Holocene layers (max depth NAP -15 m) and coarse sand in deeper Pleistocene layers.\nJust below the groundwater level (NAP -0.5 m), there is an approximately 1.5 m thick peat/clay/silt layer (not in CPT).\nThe layer between NAP –5.5 m and –8.5 m consists of clay lenses. There is little certainty about the resistance of that layer.\nBetween NAP –13 m and –15 m there is a clay/silt layer.\n\nBased on experience in this region, the following geohydrological schematization is known (Table 1). The layer depth is indicated relative to the groundwater level of NAP-0.5m:\n\n\n\n\nTable 1: Geohydrological model of the subsoil\n\n\nCluster\nLayer type\nLayer Bottom\nc\nK\nE-oed\n\n\n\n\n\n\n[m]\n[days]\n[m/day]\n[kPa]\n\n\n1\nAquitard\n-1\n3000\n\n33\n\n\n\nAquifer\n-5\n\n10\n160\n\n\n2\nAquitard\n-8\n40\n\n10000\n\n\n\nAquifer\n-13\n\n10\n170000\n\n\n3\nAquitard\n-15\n100\n\n6000\n\n\n\nAquifer\n-60\n\n25\n200000\n\n\n\n\nAccording to DINOloket the average groundwater level on site is NAP -0.5 m. There are strict demands from authorities for allowable groundwater lowering. The maximum allowed drawdown outside the construction pit is 0.1 m. To perform the calculation, dewatering is schematized to 8 wells.\nTip: Don’t place the wells in the model too close to the sheet piles. Tasks:\n\nWhich element from the Tim package would you use to place the wells and sheet piles?\nDo you need to install sheet piles deep (in sand layers of aquifer 1 and 2) or shallow (only in the first sand layer of aquifer 1)?\nInvestigate the effect of the presence of a lower or higher hydraulic resistance in the layer between NAP -5.5 m and -8.5 m.\nEstimate the extraction rate to keep the building pit dry.\nWhat are the risks? Look at the groundwater drawdown outside the construction pit in situations with different sheet pile depth.\nAlso check for point leaks. Model these leaks with a hole in the sheet pile in the southwest corner of the area." + }, + { + "objectID": "tutorial-TheHague.html#getting-started", + "href": "tutorial-TheHague.html#getting-started", + "title": "Tutorial The Hague building pit", + "section": "Getting Started", + "text": "Getting Started\nLet’s first configure the gistim python installation again, to be sure that QGIS can find the gistim software.\n\nOpen the Deltaforge prompt (search in Windows Start for “Deltaforge Prompt”). A black window pops up.\nIn this window type python -m gistim configure and press ENTER.\nYou can close this window now.\nLaunch QGIS from your START menu, from your desktop or click on …\\QGIS3.28.0\\bin\\qgis-bin.exe.\n\n\nIntermezzo: QGIS language settings\nPerhaps your QGIS was installed in another language than English. Because the Tutorial refers to the English version, let’s change to English.\n\nFrom the main menu click on Settings and select Options (e.g. in Dutch Extra and Opties).\nIn the new window go to the General section (Dutch: Algemeen) on the left.\nCheck the box to allow Override System Locale (Dutch: Landinstellingen negeren) and expand this sub menu.\nFrom the drop-down menu “User interface translation” (Dutch: Vertaling gebruikers-interface) select American English and click OK.\nClose QGIS and open it again to activate your language change.\n\n\nWe start with the creation of a new QGIS project.\n\nFrom the main menu click on Project and select New.\n\nThe case in this tutorial is located in The Netherlands, so next we select the appropriate projection.\n\nFrom the main menu click on Project and select Properties.\nIn the Properties window select the category CRS, search for “EPSG:28992” and you find “Amersfoort / RD New”. Select this option and click the Apply button, followed by the OK button to close the window.\n\n\nIn case your work is mostly in The Netherlands and in the “Amersfoort / RD New” projection, consider making this your default projection.\n\nFrom the main menu click on Settings and select Options….\nIn the section CRS and Transforms select CRS (handling), pick the radio button Use a default CRS and select “EPSG:28992 -Amersfoort / RD New”.\nClick OK.\nClose this window.\n\n\n\nInstall plugins\nThis is the moment to download/import four plugins needed for this tutorial. This is the list:\n\nthe QGIS-Tim plugin. The development version, imported from a ZIP file.\nthe iMOD plugin. The development version, imported from a ZIP file.\nthe Value Tool. The official version, installed via the Plugin Manager of QGIS (internet connection required).\nthe PDOK plugin. The official version, installed via the Plugin Manager of QGIS (internet connection required). This plugin gives access to a large database from which we will load the topographic maps and use the navigation option.\n\n\nGo to Plugins from the main menu and select Manage and Install Plugins… to open the plugin window.\nOn the left section select Install from ZIP.\nClick the Browse button () and from the tutorial dataset select the ZIP file “QGIS-Tim_Tutorial\\QGIS-iMOD-plugin.zip”.\nClick Install Plugin.\nIn the same way, install the QGIS-Tim plugin using the ZIP file “QGIS-Tim_Tutorial\\QGIS-Tim-plugin.zip”.\n\nIf you have an internet connection continue with the installation of the next two plugins from the QGIS plugin library.\n\nFrom the left section, select the group All to see all available plugins.\nSearch for “Value Tool” and install it.\nSearch for “PDOK services plugin” and install it.\nMake sure that under Plugins > Manage and Install Plugins > Installed now the 4 added plugins are checked.\nClose the Plugins window.\n\nSee in the toolbar section of QGIS that the plugins are installed:\n\niMOD Toolbar \nQGIS-Tim \nValue Tool \nPDOK Services Plugin \n\nFurther in this Tutorial we will use some default toolbars that might be hidden at the moment. Let’s check that and unhide if necessary.\n\nSelect View from the main menu and choose Panels and be sure these two toolbars are checked: - Layers - Browser.\nSelect View from the main menu and choose Toolbars and be sure these three toolbars are checked: - Advanced Digitizing Toolbar - Snapping Toolbar - Attributes Toolbar.\n\n\n\nPrepare your project\nFor navigation purposes, let’s load a topographic map for The Netherlands from the online PDOK database.\n\nNo internet connection? Follow the next steps to import a simple PNG file as a background.\n\nGo to Layer in the main menu, go to Add layer and select Add Raster layer.\nUse the Browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\TopographicMapTheHague.png”.\nClick on Add and Close the window.\nIf you do not see the map, select the layer “TopographicMapTheHague”, click your right mouse button and select “Zoom to Layer(s)”.\nContinue after step 26.\n\n\n\nIf you do have an internet connection click on the PDOK plugin button () to open the “PDOK Services Plugin” window.\nFrom the tab PDOK Services search for “pastel” and you will find a WMTS type layer called “BTRM Achtergrondkaart WMTS”.\nSelect the layer.\nIn the section “laag toevoegen” click the button Onder.\nClose the PDOK window.\n\nOur project area is in the centre of the city of The Hague so let’s navigate to that city using the PDOK plugin.\n\nType “Parkstraat” in the PDOK search field, near the PDOK button ()\nOne of the locations PDOK will find is “Parkstraat, ’s-Gravenhage”. Click on it and QGIS will fly you to the project location.\n\nLet’s now open a shape file containing the circumference of the building location.\n\nGo to Layer in the main menu, go to Add layer and select Add Vector layer.\nUse the Browse button () and from the tutorial material select “…\\QGIS-Tim_Tutorial\\dbase\\building_pit.shp”.\nClick on Add and Close the window.\n\n Tip: a fast alternative for adding layers: from the menu View > Toolbar add the Manage Layers Toolbar and use the button .\n\nIn the Layers panel on the left, select the layer “building_pit”.\nClick your right mouse button and from the menu select Properties.\nIn the new window go to the section Symbology on the left and try to pick a polygon style with only a contour color.\nClick on OK a to save and close the window.\n\nLet’s save this project to be able to return to it later or in case of a crash of QGIS.\n\nGo to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\\QGIS-Tim_Tutorial\\Rijsenhout.qgz”\n\n\n\nOpen the QGIS-Tim panel\nNow we are ready to activate the QGIS-Tim plugin.\n\nClick on the QGIS-Tim plugin button () and the QGIS-Tim panel appears.\nGo to the tab GeoPackage. Here we will create an empty database (geopackage) to store all elements and parameters for the model.\nClick the New button to create the GeoPackage and save it for instance in the folder with your tutorial data, e.g. “..\\QGIS-Tim_Tutorial\\dbase\\case-TheHague.gpkg”.\n\nYour window looks like in Figure 4.\n\n\n\nFigure 4: QGIS-Tim panel\n\n\n\nCheck in the Layers panel on the left that your new geopackage is added as a group. A sub group timml for the steady state model input, the sub group ttim for the transient model input and a series of output formats (vector/mesh/raster).\n\nIf you had no introduction to the Tim plugin, read the Intermezzo below for a general explanation of the components.\n\nIntermezzo: introduction Tabs on the Tim panel\n\nGeoPackage: an overview of the elements in your geopackage. In case you switch to transient modelling, an extra column with ttim elements is added.\nElements: a list of 14 Tim elements from which you can build your model.\nCompute: here you can define your domain and cell size, decide if your model is transient or not and change the output name.\nExtract: open an existing 3d geohydrological model (NC file) and extract the data for your project area.\n\n\nLet’s save this project to be able to return to it later or in case of a crash of QGIS.\n\nGo to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\\QGIS-Tim_Tutorial\\TheHague.qgz”" + }, + { + "objectID": "tutorial-TheHague.html#checking-available-data-from-lhm", + "href": "tutorial-TheHague.html#checking-available-data-from-lhm", + "title": "Tutorial The Hague building pit", + "section": "Checking available data from LHM", + "text": "Checking available data from LHM\nWe will now research what possible layer info is available from the LHM database (Landelijk hydrologisch model). Information from LHM is made available in the provided file “…\\QGIS-Tim_Tutorial\\LHM4.1-ondergrondmodel.nc”. The file contains rasterdata of both the 3D geological layering within The Netherlands and the corresponding geological parameterization (permeability, resistance, thickness).\n\nIn the QGIS-Tim panel go to the Extract tab.\nOpen the file “..\\QGIS-Tim_Tutorial\\dbase\\LHM4.1-ondergrondmodel.nc” (this may take a minute because the file is 350 MB).\nClick the button Select by Polygon and draw a large polygon (> 250x250m) to select the area around the building location between Parkstraat and Oranjestraat (see Figure 1). Left-click several times and close the polygon with a right click.\n\nThen click the Extract button and save the extracted subsoil data to a CSV file, e.g. “Ex2DH.csv”. A separate python window is opened and the selection is performed. You can follow the progress in your tool bar.\n\n\n QGIS displays this error message in case your polygon is too small. In that case redraw your polygon for a larger area.\n\nAutomatically 2 CSV files will be created. One with average values for bottom and top of layers and aquifer permeabilities and aquitard resistances. The other contains statistics on the data.\n\nFrom a file manager on your laptop (e.g. Explorer) open the CVS files.\n\nAn example of values from the first CSV are presented in Table 2. In each LHM layer the Aquitard information is positioned on top of Aquifer.\n\n\nTable 2: The characteristics of the subsoil based on LHM data (example, your values may differ)\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\n\nfid -\nlayer -\naquitard c\naquitard npor\naquitard s\naquifer k\naquifer npor\naquifer s\naquifer top\naquifer bottom\nsemiconf top\nsemiconf head\n\n\n\n\n0\n0\n\n\n\n\n\n\n\n\n\n\n\n\n1\n1\n287\n\n\n62.37\n\n\n-18.97\n-38.30\n\n\n\n\n2\n2\n1\n\n\n37.94\n\n\n-38.30\n-60.54\n\n\n\n\n3\n3\n3056\n\n\n13.21\n\n\n-66.62\n-77.50\n\n\n\n\n4\n4\n708\n\n\n9.25\n\n\n-84.59\n-88.38\n\n\n\n\n5\n5\n3143\n\n\n10.94\n\n\n-106.06\n-120.63\n\n\n\n\n6\n6\n8092\n\n\n5.68\n\n\n-151.11\n-254.94\n\n\n\n\n7\n7\n17752\n\n\n3.10\n\n\n-307.82\n-390.71\n\n\n\n\n\n\nA choice should be made at which depth the hydrogeological base is chosen for this project. Where high aquifer k is followed by a large aquifer c the base is chosen. For this case the base is chosen at -60.5 m (all depth data in m NAP). As you can see, values for Holocene layers are not available here and thus not displayed in LHM results. Aquitard resistance in the city is quite high, so a value of 750 days is best guess from experience. For marine deposits at -12 a value of 50 to 100 days per meter layer thickness is a proper choice. The permeability of fine Holocene sand is chosen at 10 m/d." + }, + { + "objectID": "tutorial-TheHague.html#start-your-tim-model", + "href": "tutorial-TheHague.html#start-your-tim-model", + "title": "Tutorial The Hague building pit", + "section": "Start your Tim model", + "text": "Start your Tim model\nWe are now ready to define our first steady state model by parameterizing our Aquifer.\n\nFrom the Layers panel, select the layer timml Aquifer:Aquifer.\nClick your right mouse button and from the menu select Open Attribute table (). Search for the same icon somewhere on the Attributes Toolbar.\nSwitch to the editing mode in the table with a click on () Toggle Editing.\nThen by clicking 3 times on () Add feature you will see new rows are added.\nNow you are able to fill in the desired values shown in Figure 5. NB do not fill in column FID. ‘Autogenerate’ will takes care.\n\n\n\n\nFigure 5: The characteristics of the aquifer\n\n\nClosing this table window with the will not save the filled in data or stop the editing mode!\n\nClick on the Save-Edits button () to save you data during the process or click on the Toggle Editing Mode button () to stop edditing and QGIS askes you if your changes should be saved.\nNow you can close the Attribute Table window.\n\nIn the QGIS-Tim Window we now introduce the following elements for ground water modelling in the QGIS-Tim tab Element:\n\nLeaky Line Doublet\nWell\n\n\nAdding a Leaky Line Doublet\n\nIn the QGIS-Tim window go to tab Elements and select the button Leaky Line Doublet.\nFill in the name of the layer in the pop-up panel, e.g. ‘sheet_pile’, and click OK and this new Layer is added to the Layers panel.\n\nFirst, we will draw the location of the sheet pile before adding the parameter values.\n\nIn the Layers panel right click on the layer timml Leaky Line Doublet:sheet_pile and start the editing mode by clicking the Toggle Editing button ().\n\nTwo important remarks before drawing the sheet pile:\n\nStart drawing at the most southern corner of the building pit to make a variation for an extra purpose later on in this tutorial.\nIn order to make a closed area surrounded with the sheet piles, the first and last point must have the same coordinate and intersect. For this we must activate the Snapping option in QGIS.\n\n\nIn the main menu go to Project and select Snapping Options...\n\nFrom the new toolbar (see Figure 6), click on the Enable Snapping button ().\n\n\n\n\nFigure 6: Switching on snapping options\n\n\n\nThen select the Add line feature icon () to start the drawing of the sheet pile.\nDraw the sheet pile around the building pit (start south corner) with your left mouse button and close the feature on the first point.\nIn the pop-up window fill in the resistance (1000 d, see * below) and layer number (layer=0, see ** below) as in Figure 7 and click OK to close the window.\n\n\n\n\nFigure 7: The characteristics of the Leaky line doublet\n\n\n\nRemarks to the provided values: * Because of a known issue in the TimML software, until this issue is resolved, the value of the resistance must be multiplied by the permeability. For normal sheet pile walls a resistance value of 100 d for interlock leakage is a good choice. In this case the chosen value needs to be increased by multiplying with the applicable aquifer permeability in the effected layer (R=100 d becomes R=10*100 d). ** In the real-world counting starts with 1. However, Tim is programmed in Python and in Python counting starts with 0. You will get used to it.\n\n\nClose the editing mode with a click on () and you are asked to save your changes.\n\nOpen the attribute table for Leaky Line Doublet (click or press F6) to check hydraulic resistance values for the sheet pile walls.\n\n\n\nAdding a Well\n\nIn GIS-Tim go to the tab Elements and select the Well element.\nA name for the element can be given in the pop-up panel, e.g. pumping_wells.\nIn the Layers panel right click on the layer timml Well:pumping_wells and start the editing mode by clicking the Toggle Editing button ().\nNext click on Add point feature ().\nWith you left mouse button add the first well location similar to point 1 in Figure 8.\nIn the pop-uped window, fill in the well parameters discharge (50 m3/d), radius (0.1 m), resistance (1 d) and layer (0).\nNow add the other 7 wells locations in a fast way: do not import parameters with every single point. We will do that later. Just click OK on each Feature Attribute window.\n\n\n\n\nFigure 8: Schematization of the pumping wells, sheet piles and observation locations\n\n\n\nIn the Layers panel right select layer timml Well:pumping_wells and open the Attribute Table (F6).\nStart the editing mode and fill in the values shown in Figure 9. Don’t forget the column ‘Label’. The discharge value in the table is a first guess to be adjusted later to desired level of -3.5 m groundwater lowering in the building pit.\nStop the editing mode, save your work and close the window.\nSelect layer timml Well:pumping_wells again, click right and from the menu select Show labels.\n\n\n\n\nFigure 9: Well properties\n\n\nWhen you finished the input of the wells and their parameters, you have to look back to the combination of wells and sheet pile wall. The reason is that near a well the flow is strong and therefore the flow through the wall is increased. This may lead to extremities in the calculation if wall segments are chosen too large. Tim uses control points but they are set at regular distances on the doublet (the number of control points is 1+order). It is necessary to divide the wall in smaller sections near well locations. The length of each section should be chosen equal to approximately the distance of the wall to the nearest well.\n\nSelect the Leaky Line Doublet in the Layers panel and start the editing mode.\nActivate the Vertex Tool () and then hoover along the sheet pile line in your drawing. The line element near your pointer lights up.\nWith the combination of Shift + double left click, you can add a new vertex to the line. Repeat that for the number of points you want to add.\n\nFigure 10 shows the result of positioned extra points in the line.\n\n\n\nFigure 10: Extra points for segmentation of the sheet pile element" + }, + { + "objectID": "tutorial-TheHague.html#computing-the-groundwater-head-drawdown", + "href": "tutorial-TheHague.html#computing-the-groundwater-head-drawdown", + "title": "Tutorial The Hague building pit", + "section": "Computing the groundwater head drawdown", + "text": "Computing the groundwater head drawdown\n\nZoom in or out to desired domain for which you want to see the model results.\nIn the QGIS-Tim panel select the tab Compute.\nSelect the button Set to current extent to define the Domain.\nGrid spacing will follow automatically but for now make the results mesh more dense by changing “Grid spacing” to 3.00 m.\nIn the “Output” section give the name of the file where you want to store the results.\nFor contouring, select the check box “Auto-generate contours”.\nSet the increment for contouring to a proper value: 0.5, 0.25 or 0.1 as applicable for your study.\nPress the Compute button to have the program perform the calculations.\n\nA black Python.exe window pops up indicating that the TIM calculation started on the background. You can ignore this window but keep it open. Of course you van minimize it. If the calculation was completed successful, you will see this echo in QGIS.\n." + }, + { + "objectID": "tutorial-TheHague.html#studying-output-results", + "href": "tutorial-TheHague.html#studying-output-results", + "title": "Tutorial The Hague building pit", + "section": "Studying output results", + "text": "Studying output results\nAfter the calculation you see that the result is automatically added to the Layers panel, probably called “case-TheHague output”. Results are presented as Mesh, Raster and Vector data. Contours are saved as vector. Although these layers / groups are checked, the data is not visible. That is because the geopackage was added last, and QGIS adds layers at the end of the list. Let’s move the layer “pastel” to the background.\n\nSelect the layer “pastel” and drag it with your left mouse button to the bottom of the list of layers.\nUncheck mesh and raster to only visualize contours on the base map.\nUncheck contour lines of layer 1 and 2 to get only the result for layer 0 on screen as in Figure 11.\n\n\n\n\nFigure 11: Updated results of groundwater head lowering contours due to 8 wells 50 m3/d and a sheet pile wall with 100 d wall resistance.\n\n\nThe lowering in the building pit is shown to be around -6.20 m. To get it around -3.50 m as demanded the well discharge should be decreased accordingly. An extra calculation with half the flow per well will be sufficient.\n\nGo to the well attribute table, adjust the flow to 60% (30 m3/d per well) and compute the model again.\n\n\nAdding observations wells\nThe city authorities that perform quality checks on the effect of construction projects insisted on the installation of some piezometers to assure reduction of risks for surrounding old monumental structures.\n\nIn the QGIS-Tim panel go to the Elements tab and select the element Observation.\nGive a name in the pop-up panel, e.g. “observations”.\nThen go to the Layers panel and select the layer timml Observation:observations.\nGo to the toolbar with drawing options and activate Toggle editing ().\nGo right to the Add point feature () and drop some piezometers in the drawing. We propose to use 5 points (see Figure 8): 1 point in the centre of the building pit, 1 near the lower corner outside, 1 outside near the middle of the eastern sheet pile section and just 2 near street corners.\nCompute the model again.\n\nResults of calculations at the observation locations are presented as Vector data in the Layers panel.\n\nUncheck/check layers in order to display observation results only.\n\nBy default, the label at each observation location is the calculated head for layer 0. Perhaps you see a second number near the location. For your information: this is the “location number” label belonging to the model input in layer timml Observation:observations.\nWe can observe that the lowering of groundwater around the building pit is quite high due to leakage of the sheet piles or leakage through the bottom clay layer with small resistance. Therefore, it is needed to improve the wall quality or the length. First we check the effect of the clay layer by studying a cross section.\n\n\nCreating a cross section\n\nTo make a cross section, use the iMOD plugin toolbar and click on the Cross Section widget ()\nFrom the dropdown menu on the left of this panel, select the mesh () with *_layer_0.\nPress Add.\nStart to define you cross section with a click on the button Select location.\nDraw your cross section by left clicking on the map. Stop drawing with a right click. You can redraw this line anytime you like.\nSatisfied with your line? Click the button Plot to draw this layer in the cross section. Your screen might look like Figure 12.\nBy using the Export button you can store results from the cross section in a CSV file.\n\n\n\n\nFigure 12: Cross section of groundwater heads per layer, sheet pile wall R=100d and 8 wells at 30 m3/d each in layer0" + }, + { + "objectID": "tutorial-TheHague.html#making-calculations-with-parameter-variations-or-checking-bandwidth", + "href": "tutorial-TheHague.html#making-calculations-with-parameter-variations-or-checking-bandwidth", + "title": "Tutorial The Hague building pit", + "section": "Making calculations with parameter variations or checking bandwidth", + "text": "Making calculations with parameter variations or checking bandwidth\nThe authorities demand a drawdown effect of dewatering at a maximum of 0.10 m at surrounding buildings. This means that improvements for leakage control are needed but first we need to discover what parameter to focus on.\nTo check whether the wall resistance or the bottom resistance of the layer 1 (below the building pit) is more important we can make 2 variations; one with C-clay=200 d and one with R-wall=500 d.  Of course you can change your model input, rerun the model and overwrite your model results. The next steps show you how to change the model input and save the results in separate .gpkg and .nc files.\n\nIn the input group select layer timml Aquifer:…\nOpen the Attrribute Table (F6) and change the value for “aquitard_c” in layer 1 into 200 d. \nIn the QGIS-Tim panel go to the tab Compute and change the name of the output, e.g. case-TheHague_v1.\nClick Compute to run variant 1.\n\nCheck in the Layers panel and see that the results are not overwritten but added to the groups, e.g. layer case-TheHague_v1-timml Observation:observations is added to the group Vector.\n\nFill in your calculated heads at the observation locations in Table 4 or use Excel.\n\n\n\nTable 3: Table: calculated heads [m] in observation points for 2 variants compared to the initial situations. Your values will differ.\n\n\n\n\n\n\n\n\n\n\n\nObservation location\nDefault:Cc=40dRw=100d*\n your value:\nVariant 1:Cc=200dRw=100d*\nyour value:\nVariant 2:Cc=40dRw=500d*\nyour value:\n\n\n\n\nPb1 centre pit\n-3.95\n…\n-10.44\n…\n-4.00\n…\n\n\nPb2 south corner\n-0.43\n…\n-0.54\n…\n-0.35\n…\n\n\nPb3 street corner\n-0.35\n…\n-0.43\n…\n-0.31\n…\n\n\nPb4 south point\n-0.29\n…\n-0.32\n…\n-0.25\n…\n\n\nPb5 east wall\n-0.51\n…\n-0.70\n…\n-0.41\n…\n\n\n\n\n* Known issue in TimML: you have to multiply Rw by layer permeability (Rw*10).\nLet’s now run Variant 2.\n\nIn layer timml Aquifer:… reset the value for “aquitard_c” in layer 1 to the default of 40 d. \nIn layer timml Leaky Line Doublet:… change the value for “resistance” into 5000 d (500x10).\nIn the QGIS-Tim panel go to the tab Compute and change the name of the output, e.g. case-TheHague_v2.\nClick Compute to run variant 2.\nFill in your calculated heads at the observation locations in the table above.\n\nTo get the same lowering in the building pit, in the second variation the well flow might be reduced to 33% (10m3/d per well). For the sheet pile wall, increasing the wall quality or decreasing interlock leakage doesn’t make a big difference. We can conclude that the best investment during the phase of design would be to perform extra hydrogeological research, e.g. by making more cpt’s, borings or performing a pumping test." + }, + { + "objectID": "tutorial-TheHague.html#sheet-piles-with-extra-depth", + "href": "tutorial-TheHague.html#sheet-piles-with-extra-depth", + "title": "Tutorial The Hague building pit", + "section": "Sheet piles with extra depth", + "text": "Sheet piles with extra depth\nSuppose the best guess value of the clay layer resistance was right, then a mitigation measure for the effect of dewatering in the construction phase could be the installation of the wall to a deeper level where additional hydraulic resistance of 100d can be found at a depth of -13 m to -15 m NAP.\nIf we want to create extra depth of the sheet pile we will have to introduce it in a deeper layer. There are 2 options to implement it in your model:\n\nAdd a copy of the geometry of the sheet pile wall to the existing Leaky Line Doublet shape and assign it to layer 1.\nWe recommend to create an extra Leaky Line Doublet element. In this case it is more easy to switch on/off this additional element in your sensitivity analysis.\n\nHow to copy the sheet pile wall to an extra Leaky Line Doublet element?\n\nIn the QGIS-Tim panel go to the tab Elements and add a second Leaky Line Doublet and give it a name, e.g. “sheet_pile_L1”\nGo to the tab GeoPackage and see that the element separately is added to the list. Here is can switch this element on / off for a calculation.\n\nIn the Layers panel select the new layer timml Leaky Line Doublet:sheet_pile_l1.\nOpen its Attribute Table (F6) and start the editing mode. The table is empty.\nAlso open the Attribute Table of the first Leaky Line Doublet and select the existing element.\n\nClick on the Copy button () in the source table to copy the selected row to the clipboard.\n\n\n\nIn the target table, paste it with the Paste button () as a new layer.\nAssign this new sheet pile to layer=1.\nStop editing and save the new element.\nClick Compute to start the computation again.\n\nThe results are directly visible in the contours and cross-section again. We can conclude that the drawdown in the building pit increases with a factor of almost 2 (-7.48 m at the centre of the building pit). Therefore, we adjust the well flow to 3.95/7.48*30=15.54 m3/d per well.\n\nImplement this change in the timm Well element and recalculate the model.\n\n\n\n\nFigure 13: Cross section of groundwater heads per layer, sheet pile wall R=100d in layers 0 and 1 and 8 wells at 15.25 m3/d each in layer0\n\n\nWe conclude that the lowering around the building pit with deep sheet piles improved significantly.\nNext also alternatives with a shallow concrete cut-off wall will be calculated for a shallow and a deep wall. In that case we have R=1000 d, but note that the input in the attribute than becomes k*R=10000 due to the error in Tim.\n\nAfter changing the value in attribute tables of wall elements, we can compute again, switching off and on the element for the deep wall section (tab Geopackage on the QGIS-Tim panel).\n\nAgain extra calculation is needed to adjust well extractions for drawdown in the building pit. Results of calculations are gathered in the following table, showing extractions and head outside the wall at South East monitoring position.\n\n\nTable 4: Effect of 4 Wall alternatives on extraction rate and drawdown South East.\n\n\n\n\n\n\n\n\nWall alternative at c1=40 d\nWall resistance [d]\nGroundwater extraction [m3/d]\nHead SE monitoring [dh in m]\n\n\n\n\nShallow sheet pile wall\n100\n240\n-0.39\n\n\nDeep sheet pile wall\n100\n122\n-0.16\n\n\nShallow cut-off wall\n1000\n208\n-0.30\n\n\nDeep cut-off wall\n1000\n80\n-0.04\n\n\n\n\nInstallation of 15 m deep sheet pile wall or cut-off wall can be elaborated in a geotechnical design. Still, probably some decrease of interlock leakage is needed when sheet piles are chosen. Interlock sealing or maybe irrigation of water in a shallow drain pipe around the building pit could lead to approval by authorities." + }, + { + "objectID": "tutorial-TheHague.html#effect-of-a-not-closed-wall-about-20-cm", + "href": "tutorial-TheHague.html#effect-of-a-not-closed-wall-about-20-cm", + "title": "Tutorial The Hague building pit", + "section": "Effect of a not closed wall (about 20 cm)", + "text": "Effect of a not closed wall (about 20 cm)\nAuthorities are afraid that leakage incidents could be harmful for surrounding monuments. The effect of leakage can be studied by creating a fictitious little opening in the wall. This can be done e.g. by changing the values of first and last coordinate of the leaky line doublet.\n\nSelect the Leaky Line Doublet in the Layers panel\nIn the editing toolbar go to the toggle editing option () and check the vertex option ().\nOn the drawing panel select a point in the line element of the wall and right click.\n\nThe list with coordinates appears in the vertex editor at the lower left corner of the screen. There you can edit the coordinates of all points in the line. Another option is to zoom in and select a point in the line element and drag it to a new position.\nWhen the coordinates differ a gap results, in the studied case we created a 0.2 m wide gap. It might be elaborate to perform but the result is shown in the next figure. The result is calculated by using a small grid spacing. At this created gap a large flow results in the corner of the building pit, leading to an insufficient drawdown in the building pit and a 0.1 – 0.2 m larger lowering outside the building pit at that location.\n\n\n\nFigure 14: Calculated effect of leakage at one corner in the building pit\n\n\nWhen the contractor wants to restore the dewatering level inside the building pit, the drawdown outside the gap will even grow further." + }, + { + "objectID": "tutorial-TheHague.html#using-python-for-sensitivity-analyses-with-a-qgis-tim-model", + "href": "tutorial-TheHague.html#using-python-for-sensitivity-analyses-with-a-qgis-tim-model", + "title": "Tutorial The Hague building pit", + "section": "Using Python for sensitivity analyses with a QGIS-Tim model", + "text": "Using Python for sensitivity analyses with a QGIS-Tim model\nQGIS-Tim offers the opportunity to export the geopackage of the created model to a Python script. This makes it possible to use the script for other ways of calculation, e.g.: - Calculation of model results in other Python environments, like Anaconda or Spyder or in a notebook. - Use in other python oriented programs, like the Probabilistic Toolkit.\n\nIf input of all elements is ready and the model has proved to run properly, go to the QGIS-Tim panel and the tab Geopackage.\nAt the bottom press the button Convert GeoPackage to Python script.\nAfter a short period for translation in Python the explorer panel appears where you can enter the name you want to give for the python file, e.g. “DHRVS.py” and store it in a directory you choose to save your work. The file looks like:\n\n\nAs can be seen the converted Python file contains a call on main necessary Python packages and all data coordinates and parameter values related to the elements that were selected in the model that was created in QGIS-Tim. At the end of the Python file the model.solve command is stated after which all head values in the domain with the desired mesh density are determined and also at demanded observation points.\n\nAs can be seen the Python script for TimML is written in a very dedicated and condensed manner.\nTo get the Python file running in a platform like Anaconda or Spyder, extra lines should be added at wish, to get the output that the user needs.\nAlso this file can be used for geostatistical and scenario-analysis. There are several ways of handling this kind of study, like writing an additional Python program to perform repeated calculations and statistical analysis on results. But another way is to use the Probabilistic Toolkit (PTK), a platform for statistical analysis to be used together with geotechnical design programs, developed by Deltares. The PTK can be used for study of model sensitivity for variation of parameter values or reliability analysis.\nThe PTK can be downloaded free of charge at Probabilistic Toolkit - download.\n\nOpen the Probabilistic Toolkit from your desktop () or Windows menu (Deltares folder).\n\nThe Toolkit opens at the first of 5 tabs: Model.\n\nIn the section Model Type check if the dropdown menu Type is set to Internal\nIn the section Model Type check if the dropdown menu Language is set to Python and a the field Version appears.\nSelect the ‘…’ in the field Version and give the path where PTK can find the Python interpreter, e.g. Spyder at .\nThan we copy the Python file we converted from QGIS-Tim into the Source code window. We handle the process in this way because we want to change some lines in the source code to get the program running in PTK.\n\nNext the specific parameters must be selected that are expected to be probably most relevant to variations in results. In the source code used in the PTK those parameters will not have input on a value but need to be mentioned with a name that the PTK can use for input selection in the calculations. The parameters that seem to be important are:\n\nThe hydraulic resistance of the sheet pile wall Rlld.\nThe resistance c1 of the first clay layer.\nThe permeability of the sand layer k01.\nThe resistance c2 of the second clay layer at -14 m NAP.\n\nThis is shown in the next figure.\n\nIn the Source code we have to change a few things:\n\nIn the PTK panel input we use the parameter names Rshp, czba, khol and cbasis, give them values (10000, 40, 10, 100)\nin the variables tab and in the source we assign these values to the parameters by statement lines in the source code.\n\n\nIn the source code we change the values in the element declaration of the aquifer, leaky line doublet Damw0_0, to the names of the parameters Rlld, c1, khol, c2.\nWe make this a simple analysis by using only the sheetpile in the upper layer (maybe eliminating the element statement lines for the sheetpile in the second layer). At the end of the source code we eliminate the following lines form the converted file:\nhead = model.headgrid(xg=np.arange(80940.0, 81166.0, 4), yg=np.arange(455554.0, 455360.0, -4) )\nAnd also we eliminate the lines\nobservation_peilbuis_2 = model.head(x=80970.16497991727, y=455495.54316352855) observation_peilbuis_3 = model.head(x=81004.86605597858, y=455389.68291883526) observation_peilbuis_4 = model.head(x=81049.06450220713, y=455485.0645022071)\nBecause we only are interested in 2 points we use the first two observation points and we add\npb0 = observation_peilbuis_0[0] pb1 = observation_peilbuis_1[0]\nIn the output screen of the PTK we add variables pb0 and pb1.\nWe check if the program works properly by performing the Run model in Single run mode (in toolbar of PTK). By pressing the arrow the calculation starts running. In the Run model tab we find the results of our calculation. Check if it complies with your earlier calculations in QGIS-Tim.\n\nIf results are as expected, we can step to a sensitivity analyses. For each selected parameter a distribution is defined with certain limits or characteristic values. Distribution formulas can be chosen based on knowhow of the user. Best guess of the parameter value distributions are given in the next table.\n\n\n\nBest guess of the parameter value distributions\n\n\nParameter value distributions of sheetpile resistance Rshp, silt layer resistance czba, basic peat layer resistance cbasis and permeability of Holocene sand khol are shown in graphs below.\nfiguur Pameter value distributions of sheetpile resistance Rshp (??)\n\n\n\nPameter value distributions of silt layer resistance czba (??)\n\n\n\n\n\nPameter value distributions of basic peat layer resistance (??)\n\n\n\n\n\nPameter value distributions of cbasis (??)\n\n\n\n\n\nPameter value distributions of permeability of Holocene sand khol (??)\n\n\nLow and high value of resistivity are set in the Calculation tab to 10 and 90%.\nIn the tab Sensitivity we can find in what extent parameter variations contribute to model results. In the next graph it is shown what parameter variation means for drawdown in the building pit. We conclude that for a situation with a sheet pile wall in only the first sand layer the variation of the resistance of the loamy layer determines the drawdown, and with that this factor determines the amount of extraction in that situation for the largest part. Translated to practical considerations, it is worthwhile to spend extra budget on determining the homogeneity of that layer and the vertical permeability of the loamy layer in more detail." + }, + { + "objectID": "index.html", + "href": "index.html", + "title": "QGIS-Tim", + "section": "", + "text": "QGIS-Tim is an open source project for multi-layer groundwater flow simulations. QGIS-Tim provides a link between QGIS and the open source analytic element method software: TimML (steady-state) and TTim (transient).\nThe benefit of the analytic element method (AEM) is that no grid or time-stepping is required. Geohydrological features are represented by points, lines, and polygons. QGIS-Tim stores these features in a GeoPackage.\nQGIS-Tim consists of a “front-end” and a “back-end”. The front-end is a QGIS plugin that provides a limited graphical interface to setup model input, visualize, and analyze model input. The back-end is a Python package. It reads the contents of the GeoPackage and transforms it into a TimML or TTim model, computes a result, and writes it to a file that the QGIS plugin loads." + }, + { + "objectID": "install.html", + "href": "install.html", + "title": "Install", + "section": "", + "text": "QGIS-Tim consists of two parts: A QGIS plugin and the gistim Python package, which runs in a separate Python environment. The installation of QGIS-Tim therfore consists of three steps:" + }, + { + "objectID": "install.html#install-qgis", + "href": "install.html#install-qgis", + "title": "Install", + "section": "1. Install QGIS", + "text": "1. Install QGIS\nDownload and install a recent version of QGIS (>3.22): https://www.qgis.org/en/site/forusers/download.html" + }, + { + "objectID": "install.html#install-gistim-in-a-seperate-python-environment", + "href": "install.html#install-gistim-in-a-seperate-python-environment", + "title": "Install", + "section": "2. Install gistim in a seperate Python environment", + "text": "2. Install gistim in a seperate Python environment\ngistim requires a seperate Python environment, because it depends on packages incompatible with the packages in QGIS’ own Python environment. There are two approaches: either using the fully-fletched Deltaforge distribution (Recommended) or the leaner Miniforge distribution.\n\nMethod 1: with Deltaforge (recommended)\n\nDownload and install Deltaforge. Make sure you use Deltaforge version 0.3.0 or higher!\nOpen the Deltaforge prompt (search in Windows Start for \"Deltaforge Prompt\").\nConfigure the gistim installation, so that the QGIS plugin is able to find it. Run: python -m gistim configure\n\n\n\nMethod 2: with Miniforge\n\nDownload and install a miniforge Python installation\nOpen the miniforge prompt (search in Windows Start for \"Miniforge Prompt\").\nCreate a new conda environment, run: conda create \\--name tim python=3.9\nActivate the environment: conda activate tim\nRun: conda install -c conda-forge gistim\nConfigure the gistim installation, so that the QGIS plugin is able to find it. Run: python -m gistim configure" + }, + { + "objectID": "install.html#install-the-qgis-plugin", + "href": "install.html#install-the-qgis-plugin", + "title": "Install", + "section": "3. Install the QGIS plugin", + "text": "3. Install the QGIS plugin\n\nMethod 1: From the GQIS plugin database\nNB Due to ongoing developments new features and bug fixes might not be part of this release. Consider installation method 2.\n\nOpen QGIS.\nAt the top, find the Plugins menu (~sixth object in the menubar).\nFind \"Manage and Install plugins\" (~first object in drop-down).\nFind \"All\" (~first in left section).\nSearch for \"Qgis-Tim\".\nClick \"Install Plugin\".\n\n\n\nMethod 2: From Zip (recommended)\n\nDownload the \"QGIS-TIM-plugin.zip\" (do not unzip!) from the iMOD-Suite download portal.\nOpen QGIS.\nAt the top, find the Plugins menu (~sixth object in the menubar).\nFind \"Manage and Install plugins\" (~first object in drop-down).\nFind \"Install from ZIP\" (~fourth in left section).\nEnter the path to the file \"QGIS-TIM-plugin.zip\".\nClick \"Install Plugin\".\n\nThis will add an icon to the toolbar(s). By clicking the icon, the plugin is started. The QGIS plugin automatically starts an extra window for the background calculation of a TIM model. This black window is called Python.exe and can be minimized or even closed after the calculation." } ] \ No newline at end of file diff --git a/tutorial-QGIS-Tim.html b/tutorial-QGIS-Tim.html index ed3bbb4..2e2b8d1 100644 --- a/tutorial-QGIS-Tim.html +++ b/tutorial-QGIS-Tim.html @@ -2,12 +2,12 @@ - + -QGIS-Tim - Tutorial QGIS-Tim +QGIS-Tim - Tutorial Building Pit + + + + + + + + + + + + + + + + + + + + + + + + + + +
+
+ +
+ +
+ + + + +
+ +
+
+

Tutorial The Hague building pit

+
+ + + +
+ + + + +
+ + +
+ + + + +
+

Requirements

+
    +
  • Be sure QGIS version 3.22.00 or higher is installed.
  • +
  • Be sure the gistim Python package is installed (see installation for instructions).
  • +
  • Download the tutorial material. Follow this link.
  • +
  • Installation of the QGIS-Tim plugin and the MOD plugin is part of this Tutorial. The necessary ZIP files are included in the tutorial material.
  • +
  • Internet connections is optional during this Tutorial. It is only required for installation of additional plugins and the use of an online topographic background map.
  • +
+
+
+

Description

+

In this tutorial, you will learn how to:

+
    +
  • install and use the QGIS-Tim plugin;
  • +
  • use the basic of QGIS for pre- and postprocessing of Tim;
  • +
  • create several steady state models (TimML) and a transient model (TTim);
  • +
  • analyse the results;
  • +
  • export your model to a Python script.
  • +
+
+
+

Objective

+

Calculation of a pumping well extraction.

+
+
+

Introduction case The Hague

+

In the old city centre of The Hague a building plan with a parking basement is constructed. The dimensions of the building pit are 34.2 m * 83.2 m. The area is shown in Figure 1.

+
+
+

+
Figure 1: Schematization of the building area in The Hague city centre (orange: building pit)
+
+
+

To carry out the construction in dry conditions, the groundwater level needs to be lowered by 3.5 m. The required drainage time is 4 months.
The environment is vulnerable with valuable buildings and monuments (see Figure 2) that have a shallow foundation. The subsoil consists of sandy layers which locally contain shallow peat/clay/silt layers and deeper layers of clay/silt. The builder contractor must use a sheet pile wall that needs to be installed in a water-retarding layer (aquitard).

+
+
+

+
Figure 2: The monumental environment
+
+
+

The questions to be elaborated in the hydrogeological advice is:
“How deep should a sheet pile wall be placed to prevent damage? Can risks arise from a leak?”

+

Applications of a sheet pile wall (with a hydraulic resistance of 100 days) and a concrete cut off wall (with a hydraulic resistance of 1000 days) need to be studied.

+

The soil profile has been investigated with borings and CPTs. An example of a CPT is shown in Figure 3.

+
+
+

+
Figure 3: CPT to a depth of NAP -20 m
+
+
+

The interpretation of the CPT and borings gives the following soil layer scheme:

+
    +
  • The soil mainly consist of fine sand in Holocene layers (max depth NAP -15 m) and coarse sand in deeper Pleistocene layers.
  • +
  • Just below the groundwater level (NAP -0.5 m), there is an approximately 1.5 m thick peat/clay/silt layer (not in CPT).
  • +
  • The layer between NAP –5.5 m and –8.5 m consists of clay lenses. There is little certainty about the resistance of that layer.
  • +
  • Between NAP –13 m and –15 m there is a clay/silt layer.
  • +
+

Based on experience in this region, the following geohydrological schematization is known (Table 1). The layer depth is indicated relative to the groundwater level of NAP-0.5m:

+ + +
+ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 1: Geohydrological model of the subsoil
ClusterLayer typeLayer BottomcKE-oed
[m][days][m/day][kPa]
1Aquitard-1300033
Aquifer-510160
2Aquitard-84010000
Aquifer-1310170000
3Aquitard-151006000
Aquifer-6025200000
+
+

According to DINOloket the average groundwater level on site is NAP -0.5 m. There are strict demands from authorities for allowable groundwater lowering. The maximum allowed drawdown outside the construction pit is 0.1 m.
To perform the calculation, dewatering is schematized to 8 wells.

+

Tip: Don’t place the wells in the model too close to the sheet piles. Tasks:

+
    +
  • Which element from the Tim package would you use to place the wells and sheet piles?
  • +
  • Do you need to install sheet piles deep (in sand layers of aquifer 1 and 2) or shallow (only in the first sand layer of aquifer 1)?
  • +
  • Investigate the effect of the presence of a lower or higher hydraulic resistance in the layer between NAP -5.5 m and -8.5 m.
  • +
  • Estimate the extraction rate to keep the building pit dry.
  • +
  • What are the risks? Look at the groundwater drawdown outside the construction pit in situations with different sheet pile depth.
  • +
  • Also check for point leaks. Model these leaks with a hole in the sheet pile in the southwest corner of the area.
  • +
+
+
+

Getting Started

+

Let’s first configure the gistim python installation again, to be sure that QGIS can find the gistim software.

+
    +
  1. Open the Deltaforge prompt (search in Windows Start for “Deltaforge Prompt”). A black window pops up.
  2. +
  3. In this window type python -m gistim configure and press ENTER.
  4. +
  5. You can close this window now.
  6. +
  7. Launch QGIS from your START menu, from your desktop or click on …\QGIS3.28.0\bin\qgis-bin.exe.
  8. +
+
+

Intermezzo: QGIS language settings

+

Perhaps your QGIS was installed in another language than English. Because the Tutorial refers to the English version, let’s change to English.

+
    +
  1. From the main menu click on Settings and select Options (e.g. in Dutch Extra and Opties).
  2. +
  3. In the new window go to the General section (Dutch: Algemeen) on the left.
  4. +
  5. Check the box to allow Override System Locale (Dutch: Landinstellingen negeren) and expand this sub menu.
  6. +
  7. From the drop-down menu “User interface translation” (Dutch: Vertaling gebruikers-interface) select American English and click OK.
  8. +
  9. Close QGIS and open it again to activate your language change.
  10. +
+
+

We start with the creation of a new QGIS project.

+
    +
  1. From the main menu click on Project and select New.
  2. +
+

The case in this tutorial is located in The Netherlands, so next we select the appropriate projection.

+
    +
  1. From the main menu click on Project and select Properties.
  2. +
  3. In the Properties window select the category CRS, search for “EPSG:28992” and you find “Amersfoort / RD New”. Select this option and click the Apply button, followed by the OK button to close the window.
  4. +
+
+

In case your work is mostly in The Netherlands and in the “Amersfoort / RD New” projection, consider making this your default projection.

+
    +
  • From the main menu click on Settings and select Options….
  • +
  • In the section CRS and Transforms select CRS (handling), pick the radio button Use a default CRS and select “EPSG:28992 -Amersfoort / RD New”.
  • +
  • Click OK.
  • +
  • Close this window.
  • +
+
+
+

Install plugins

+

This is the moment to download/import four plugins needed for this tutorial. This is the list:

+
    +
  • the QGIS-Tim plugin. The development version, imported from a ZIP file.
  • +
  • the iMOD plugin. The development version, imported from a ZIP file.
  • +
  • the Value Tool. The official version, installed via the Plugin Manager of QGIS (internet connection required).
  • +
  • the PDOK plugin. The official version, installed via the Plugin Manager of QGIS (internet connection required). This plugin gives access to a large database from which we will load the topographic maps and use the navigation option.
  • +
+
    +
  1. Go to Plugins from the main menu and select Manage and Install Plugins… to open the plugin window.
  2. +
  3. On the left section select Install from ZIP.
  4. +
  5. Click the Browse button () and from the tutorial dataset select the ZIP file “QGIS-Tim_Tutorial\QGIS-iMOD-plugin.zip”.
  6. +
  7. Click Install Plugin.
  8. +
  9. In the same way, install the QGIS-Tim plugin using the ZIP file “QGIS-Tim_Tutorial\QGIS-Tim-plugin.zip”.
  10. +
+

If you have an internet connection continue with the installation of the next two plugins from the QGIS plugin library.

+
    +
  1. From the left section, select the group All to see all available plugins.
  2. +
  3. Search for “Value Tool” and install it.
  4. +
  5. Search for “PDOK services plugin” and install it.
  6. +
  7. Make sure that under Plugins > Manage and Install Plugins > Installed now the 4 added plugins are checked.
  8. +
  9. Close the Plugins window.
  10. +
+

See in the toolbar section of QGIS that the plugins are installed:

+
    +
  • iMOD Toolbar
  • +
  • QGIS-Tim
  • +
  • Value Tool
  • +
  • PDOK Services Plugin
  • +
+

Further in this Tutorial we will use some default toolbars that might be hidden at the moment. Let’s check that and unhide if necessary.

+
    +
  1. Select View from the main menu and choose Panels and be sure these two toolbars are checked:
    - Layers
    - Browser.
  2. +
  3. Select View from the main menu and choose Toolbars and be sure these three toolbars are checked:
    - Advanced Digitizing Toolbar
    - Snapping Toolbar
    - Attributes Toolbar.
  4. +
+
+
+

Prepare your project

+

For navigation purposes, let’s load a topographic map for The Netherlands from the online PDOK database.

+
+

No internet connection? Follow the next steps to import a simple PNG file as a background.

+
    +
  • Go to Layer in the main menu, go to Add layer and select Add Raster layer.
  • +
  • Use the Browse button () and from the tutorial material select “…\QGIS-Tim_Tutorial\dbase\TopographicMapTheHague.png”.
  • +
  • Click on Add and Close the window.
  • +
  • If you do not see the map, select the layer “TopographicMapTheHague”, click your right mouse button and select “Zoom to Layer(s)”.
  • +
  • Continue after step 26.
  • +
+
+
    +
  1. If you do have an internet connection click on the PDOK plugin button () to open the “PDOK Services Plugin” window.
  2. +
  3. From the tab PDOK Services search for “pastel” and you will find a WMTS type layer called “BTRM Achtergrondkaart WMTS”.
  4. +
  5. Select the layer.
  6. +
  7. In the section “laag toevoegen” click the button Onder.
  8. +
  9. Close the PDOK window.
  10. +
+

Our project area is in the centre of the city of The Hague so let’s navigate to that city using the PDOK plugin.

+
    +
  1. Type “Parkstraat” in the PDOK search field, near the PDOK button ()
  2. +
  3. One of the locations PDOK will find is “Parkstraat, ’s-Gravenhage”. Click on it and QGIS will fly you to the project location.
  4. +
+

Let’s now open a shape file containing the circumference of the building location.

+
    +
  1. Go to Layer in the main menu, go to Add layer and select Add Vector layer.
  2. +
  3. Use the Browse button () and from the tutorial material select “…\QGIS-Tim_Tutorial\dbase\building_pit.shp”.
  4. +
  5. Click on Add and Close the window.
  6. +
+

Tip: a fast alternative for adding layers: from the menu View > Toolbar add the Manage Layers Toolbar and use the button .

+
    +
  1. In the Layers panel on the left, select the layer “building_pit”.
  2. +
  3. Click your right mouse button and from the menu select Properties.
  4. +
  5. In the new window go to the section Symbology on the left and try to pick a polygon style with only a contour color.
  6. +
  7. Click on OK a to save and close the window.
  8. +
+

Let’s save this project to be able to return to it later or in case of a crash of QGIS.

+
    +
  1. Go to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\QGIS-Tim_Tutorial\Rijsenhout.qgz”
  2. +
+
+
+

Open the QGIS-Tim panel

+

Now we are ready to activate the QGIS-Tim plugin.

+
    +
  1. Click on the QGIS-Tim plugin button () and the QGIS-Tim panel appears.
  2. +
  3. Go to the tab GeoPackage.
    Here we will create an empty database (geopackage) to store all elements and parameters for the model.
  4. +
  5. Click the New button to create the GeoPackage and save it for instance in the folder with your tutorial data, e.g. “..\QGIS-Tim_Tutorial\dbase\case-TheHague.gpkg”.
  6. +
+

Your window looks like in Figure 4.

+
+
+

+
Figure 4: QGIS-Tim panel
+
+
+
    +
  1. Check in the Layers panel on the left that your new geopackage is added as a group.
    A sub group timml for the steady state model input, the sub group ttim for the transient model input and a series of output formats (vector/mesh/raster).
  2. +
+

If you had no introduction to the Tim plugin, read the Intermezzo below for a general explanation of the components.

+
+

Intermezzo: introduction Tabs on the Tim panel

+
    +
  1. GeoPackage: an overview of the elements in your geopackage. In case you switch to transient modelling, an extra column with ttim elements is added.
  2. +
  3. Elements: a list of 14 Tim elements from which you can build your model.
  4. +
  5. Compute: here you can define your domain and cell size, decide if your model is transient or not and change the output name.
  6. +
  7. Extract: open an existing 3d geohydrological model (NC file) and extract the data for your project area.
  8. +
+
+

Let’s save this project to be able to return to it later or in case of a crash of QGIS.

+
    +
  1. Go to Project in the main menu, select Save As and select a folder and a file name for your project, e.g. “…\QGIS-Tim_Tutorial\TheHague.qgz”
  2. +
+
+
+
+

Checking available data from LHM

+

We will now research what possible layer info is available from the LHM database (Landelijk hydrologisch model). Information from LHM is made available in the provided file “…\QGIS-Tim_Tutorial\LHM4.1-ondergrondmodel.nc”. The file contains rasterdata of both the 3D geological layering within The Netherlands and the corresponding geological parameterization (permeability, resistance, thickness).

+
    +
  1. In the QGIS-Tim panel go to the Extract tab.
  2. +
  3. Open the file “..\QGIS-Tim_Tutorial\dbase\LHM4.1-ondergrondmodel.nc” (this may take a minute because the file is 350 MB).
  4. +
  5. Click the button Select by Polygon and draw a large polygon (> 250x250m) to select the area around the building location between Parkstraat and Oranjestraat (see Figure 1). Left-click several times and close the polygon with a right click.
    +
  6. +
  7. Then click the Extract button and save the extracted subsoil data to a CSV file, e.g. “Ex2DH.csv”.
    A separate python window is opened and the selection is performed. You can follow the progress in your tool bar.
  8. +
+
+


QGIS displays this error message in case your polygon is too small. In that case redraw your polygon for a larger area.

+
+

Automatically 2 CSV files will be created. One with average values for bottom and top of layers and aquifer permeabilities and aquitard resistances. The other contains statistics on the data.

+
    +
  1. From a file manager on your laptop (e.g. Explorer) open the CVS files.
  2. +
+

An example of values from the first CSV are presented in Table 2. In each LHM layer the Aquitard information is positioned on top of Aquifer.

+
+ + ++++++++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 2: The characteristics of the subsoil based on LHM data (example, your values may differ)
fid
-
layer
-
aquitard
c
aquitard
npor
aquitard
s
aquifer
k
aquifer
npor
aquifer
s
aquifer
top
aquifer
bottom
semiconf
top
semiconf
head
00
1128762.37-18.97-38.30
22137.94-38.30-60.54
33305613.21-66.62-77.50
447089.25-84.59-88.38
55314310.94-106.06-120.63
6680925.68-151.11-254.94
77177523.10-307.82-390.71
+
+

A choice should be made at which depth the hydrogeological base is chosen for this project. Where high aquifer k is followed by a large aquifer c the base is chosen. For this case the base is chosen at -60.5 m (all depth data in m NAP). As you can see, values for Holocene layers are not available here and thus not displayed in LHM results.

Aquitard resistance in the city is quite high, so a value of 750 days is best guess from experience.

For marine deposits at -12 a value of 50 to 100 days per meter layer thickness is a proper choice. The permeability of fine Holocene sand is chosen at 10 m/d.

+
+
+

Start your Tim model

+

We are now ready to define our first steady state model by parameterizing our Aquifer.

+
    +
  1. From the Layers panel, select the layer timml Aquifer:Aquifer.
  2. +
  3. Click your right mouse button and from the menu select Open Attribute table (). Search for the same icon somewhere on the Attributes Toolbar.
  4. +
  5. Switch to the editing mode in the table with a click on () Toggle Editing.
  6. +
  7. Then by clicking 3 times on () Add feature you will see new rows are added.
  8. +
  9. Now you are able to fill in the desired values shown in Figure 5.
    NB do not fill in column FID. ‘Autogenerate’ will takes care.
  10. +
+
+
+

+
Figure 5: The characteristics of the aquifer
+
+
+

Closing this table window with the will not save the filled in data or stop the editing mode!

+
    +
  1. Click on the Save-Edits button () to save you data during the process or click on the Toggle Editing Mode button () to stop edditing and QGIS askes you if your changes should be saved.
  2. +
  3. Now you can close the Attribute Table window.
  4. +
+

In the QGIS-Tim Window we now introduce the following elements for ground water modelling in the QGIS-Tim tab Element:

+
    +
  • Leaky Line Doublet
  • +
  • Well
  • +
+
+

Adding a Leaky Line Doublet

+
    +
  1. In the QGIS-Tim window go to tab Elements and select the button Leaky Line Doublet.
  2. +
  3. Fill in the name of the layer in the pop-up panel, e.g. ‘sheet_pile’, and click OK and this new Layer is added to the Layers panel.
  4. +
+

First, we will draw the location of the sheet pile before adding the parameter values.

+
    +
  1. In the Layers panel right click on the layer timml Leaky Line Doublet:sheet_pile and start the editing mode by clicking the Toggle Editing button ().
  2. +
+

Two important remarks before drawing the sheet pile:

+
    +
  • Start drawing at the most southern corner of the building pit to make a variation for an extra purpose later on in this tutorial.
  • +
  • In order to make a closed area surrounded with the sheet piles, the first and last point must have the same coordinate and intersect. For this we must activate the Snapping option in QGIS.
  • +
+
    +
  1. In the main menu go to Project and select Snapping Options...
    +
  2. +
  3. From the new toolbar (see Figure 6), click on the Enable Snapping button ().
  4. +
+
+
+

+
Figure 6: Switching on snapping options
+
+
+
    +
  1. Then select the Add line feature icon () to start the drawing of the sheet pile.
  2. +
  3. Draw the sheet pile around the building pit (start south corner) with your left mouse button and close the feature on the first point.
  4. +
  5. In the pop-up window fill in the resistance (1000 d, see * below) and layer number (layer=0, see ** below) as in Figure 7 and click OK to close the window.
  6. +
+
+
+

+
Figure 7: The characteristics of the Leaky line doublet
+
+
+
+

Remarks to the provided values:
* Because of a known issue in the TimML software, until this issue is resolved, the value of the resistance must be multiplied by the permeability. For normal sheet pile walls a resistance value of 100 d for interlock leakage is a good choice. In this case the chosen value needs to be increased by multiplying with the applicable aquifer permeability in the effected layer (R=100 d becomes R=10*100 d).
** In the real-world counting starts with 1. However, Tim is programmed in Python and in Python counting starts with 0. You will get used to it.

+
+
    +
  1. Close the editing mode with a click on () and you are asked to save your changes.
    +
  2. +
  3. Open the attribute table for Leaky Line Doublet (click or press F6) to check hydraulic resistance values for the sheet pile walls.
  4. +
+
+
+

Adding a Well

+
    +
  1. In GIS-Tim go to the tab Elements and select the Well element.
  2. +
  3. A name for the element can be given in the pop-up panel, e.g. pumping_wells.
  4. +
  5. In the Layers panel right click on the layer timml Well:pumping_wells and start the editing mode by clicking the Toggle Editing button ().
  6. +
  7. Next click on Add point feature ().
  8. +
  9. With you left mouse button add the first well location similar to point 1 in Figure 8.
  10. +
  11. In the pop-uped window, fill in the well parameters discharge (50 m3/d), radius (0.1 m), resistance (1 d) and layer (0).
  12. +
  13. Now add the other 7 wells locations in a fast way: do not import parameters with every single point. We will do that later. Just click OK on each Feature Attribute window.
  14. +
+
+
+

+
Figure 8: Schematization of the pumping wells, sheet piles and observation locations
+
+
+
    +
  1. In the Layers panel right select layer timml Well:pumping_wells and open the Attribute Table (F6).
  2. +
  3. Start the editing mode and fill in the values shown in Figure 9. Don’t forget the column ‘Label’.
    The discharge value in the table is a first guess to be adjusted later to desired level of -3.5 m groundwater lowering in the building pit.
  4. +
  5. Stop the editing mode, save your work and close the window.
  6. +
  7. Select layer timml Well:pumping_wells again, click right and from the menu select Show labels.
  8. +
+
+
+

+
Figure 9: Well properties
+
+
+

When you finished the input of the wells and their parameters, you have to look back to the combination of wells and sheet pile wall. The reason is that near a well the flow is strong and therefore the flow through the wall is increased. This may lead to extremities in the calculation if wall segments are chosen too large. Tim uses control points but they are set at regular distances on the doublet (the number of control points is 1+order). It is necessary to divide the wall in smaller sections near well locations. The length of each section should be chosen equal to approximately the distance of the wall to the nearest well.

+
    +
  1. Select the Leaky Line Doublet in the Layers panel and start the editing mode.
  2. +
  3. Activate the Vertex Tool () and then hoover along the sheet pile line in your drawing. The line element near your pointer lights up.
  4. +
  5. With the combination of Shift + double left click, you can add a new vertex to the line. Repeat that for the number of points you want to add.
  6. +
+

Figure 10 shows the result of positioned extra points in the line.

+
+
+

+
Figure 10: Extra points for segmentation of the sheet pile element
+
+
+
+
+
+

Computing the groundwater head drawdown

+
    +
  1. Zoom in or out to desired domain for which you want to see the model results.
  2. +
  3. In the QGIS-Tim panel select the tab Compute.
  4. +
  5. Select the button Set to current extent to define the Domain.
  6. +
  7. Grid spacing will follow automatically but for now make the results mesh more dense by changing “Grid spacing” to 3.00 m.
  8. +
  9. In the “Output” section give the name of the file where you want to store the results.
  10. +
  11. For contouring, select the check box “Auto-generate contours”.
  12. +
  13. Set the increment for contouring to a proper value: 0.5, 0.25 or 0.1 as applicable for your study.
  14. +
  15. Press the Compute button to have the program perform the calculations.
  16. +
+

A black Python.exe window pops up indicating that the TIM calculation started on the background. You can ignore this window but keep it open. Of course you van minimize it. If the calculation was completed successful, you will see this echo in QGIS.
+.

+
+
+

Studying output results

+

After the calculation you see that the result is automatically added to the Layers panel, probably called “case-TheHague output”. Results are presented as Mesh, Raster and Vector data. Contours are saved as vector.
Although these layers / groups are checked, the data is not visible. That is because the geopackage was added last, and QGIS adds layers at the end of the list.
Let’s move the layer “pastel” to the background.

+
    +
  1. Select the layer “pastel” and drag it with your left mouse button to the bottom of the list of layers.
  2. +
  3. Uncheck mesh and raster to only visualize contours on the base map.
  4. +
  5. Uncheck contour lines of layer 1 and 2 to get only the result for layer 0 on screen as in Figure 11.
  6. +
+
+
+

+
Figure 11: Updated results of groundwater head lowering contours due to 8 wells 50 m3/d and a sheet pile wall with 100 d wall resistance.
+
+
+

The lowering in the building pit is shown to be around -6.20 m. To get it around -3.50 m as demanded the well discharge should be decreased accordingly. An extra calculation with half the flow per well will be sufficient.

+
    +
  1. Go to the well attribute table, adjust the flow to 60% (30 m3/d per well) and compute the model again.
  2. +
+
+

Adding observations wells

+

The city authorities that perform quality checks on the effect of construction projects insisted on the installation of some piezometers to assure reduction of risks for surrounding old monumental structures.

+
    +
  1. In the QGIS-Tim panel go to the Elements tab and select the element Observation.
  2. +
  3. Give a name in the pop-up panel, e.g. “observations”.
  4. +
  5. Then go to the Layers panel and select the layer timml Observation:observations.
  6. +
  7. Go to the toolbar with drawing options and activate Toggle editing ().
  8. +
  9. Go right to the Add point feature () and drop some piezometers in the drawing.
    We propose to use 5 points (see Figure 8): 1 point in the centre of the building pit, 1 near the lower corner outside, 1 outside near the middle of the eastern sheet pile section and just 2 near street corners.
  10. +
  11. Compute the model again.
  12. +
+

Results of calculations at the observation locations are presented as Vector data in the Layers panel.

+
    +
  1. Uncheck/check layers in order to display observation results only.
  2. +
+

By default, the label at each observation location is the calculated head for layer 0. Perhaps you see a second number near the location. For your information: this is the “location number” label belonging to the model input in layer timml Observation:observations.

+

We can observe that the lowering of groundwater around the building pit is quite high due to leakage of the sheet piles or leakage through the bottom clay layer with small resistance. Therefore, it is needed to improve the wall quality or the length. First we check the effect of the clay layer by studying a cross section.

+
+
+

Creating a cross section

+
    +
  1. To make a cross section, use the iMOD plugin toolbar and click on the Cross Section widget ()
  2. +
  3. From the dropdown menu on the left of this panel, select the mesh () with *_layer_0.
  4. +
  5. Press Add.
  6. +
  7. Start to define you cross section with a click on the button Select location.
  8. +
  9. Draw your cross section by left clicking on the map. Stop drawing with a right click. You can redraw this line anytime you like.
  10. +
  11. Satisfied with your line? Click the button Plot to draw this layer in the cross section. Your screen might look like Figure 12.
  12. +
  13. By using the Export button you can store results from the cross section in a CSV file.
  14. +
+
+
+

+
Figure 12: Cross section of groundwater heads per layer, sheet pile wall R=100d and 8 wells at 30 m3/d each in layer0
+
+
+
+
+
+

Making calculations with parameter variations or checking bandwidth

+

The authorities demand a drawdown effect of dewatering at a maximum of 0.10 m at surrounding buildings. This means that improvements for leakage control are needed but first we need to discover what parameter to focus on.

+

To check whether the wall resistance or the bottom resistance of the layer 1 (below the building pit) is more important we can make 2 variations; one with C-clay=200 d and one with R-wall=500 d. 
Of course you can change your model input, rerun the model and overwrite your model results. The next steps show you how to change the model input and save the results in separate .gpkg and .nc files.

+
    +
  1. In the input group select layer timml Aquifer:…
  2. +
  3. Open the Attrribute Table (F6) and change the value for “aquitard_c” in layer 1 into 200 d. 
  4. +
  5. In the QGIS-Tim panel go to the tab Compute and change the name of the output, e.g. case-TheHague_v1.
  6. +
  7. Click Compute to run variant 1.
  8. +
+

Check in the Layers panel and see that the results are not overwritten but added to the groups, e.g. layer case-TheHague_v1-timml Observation:observations is added to the group Vector.

+
    +
  1. Fill in your calculated heads at the observation locations in Table 4 or use Excel.
  2. +
+
+ + +++++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 3: Table: calculated heads [m] in observation points for 2 variants compared to the initial situations. Your values will differ.
Observation
location
Default:
Cc=40d
Rw=100d*

your value:
Variant 1:
Cc=200d
Rw=100d*
your value:Variant 2:
Cc=40d
Rw=500d*
your value:
Pb1 centre pit-3.95-10.44-4.00
Pb2 south corner-0.43-0.54-0.35
Pb3 street corner-0.35-0.43-0.31
Pb4 south point-0.29-0.32-0.25
Pb5 east wall-0.51-0.70-0.41
+
+

* Known issue in TimML: you have to multiply Rw by layer permeability (Rw*10).

+

Let’s now run Variant 2.

+
    +
  1. In layer timml Aquifer:… reset the value for “aquitard_c” in layer 1 to the default of 40 d. 
  2. +
  3. In layer timml Leaky Line Doublet:… change the value for “resistance” into 5000 d (500x10).
  4. +
  5. In the QGIS-Tim panel go to the tab Compute and change the name of the output, e.g. case-TheHague_v2.
  6. +
  7. Click Compute to run variant 2.
  8. +
  9. Fill in your calculated heads at the observation locations in the table above.
  10. +
+

To get the same lowering in the building pit, in the second variation the well flow might be reduced to 33% (10m3/d per well). For the sheet pile wall, increasing the wall quality or decreasing interlock leakage doesn’t make a big difference.
We can conclude that the best investment during the phase of design would be to perform extra hydrogeological research, e.g. by making more cpt’s, borings or performing a pumping test.

+
+
+

Sheet piles with extra depth

+

Suppose the best guess value of the clay layer resistance was right, then a mitigation measure for the effect of dewatering in the construction phase could be the installation of the wall to a deeper level where additional hydraulic resistance of 100d can be found at a depth of -13 m to -15 m NAP.

+

If we want to create extra depth of the sheet pile we will have to introduce it in a deeper layer. There are 2 options to implement it in your model:

+
    +
  • Add a copy of the geometry of the sheet pile wall to the existing Leaky Line Doublet shape and assign it to layer 1.
  • +
  • We recommend to create an extra Leaky Line Doublet element. In this case it is more easy to switch on/off this additional element in your sensitivity analysis.
  • +
+

How to copy the sheet pile wall to an extra Leaky Line Doublet element?

+
    +
  1. In the QGIS-Tim panel go to the tab Elements and add a second Leaky Line Doublet and give it a name, e.g. “sheet_pile_L1”
  2. +
  3. Go to the tab GeoPackage and see that the element separately is added to the list. Here is can switch this element on / off for a calculation.
    +
  4. +
  5. In the Layers panel select the new layer timml Leaky Line Doublet:sheet_pile_l1.
  6. +
  7. Open its Attribute Table (F6) and start the editing mode. The table is empty.
  8. +
  9. Also open the Attribute Table of the first Leaky Line Doublet and select the existing element.
    +
  10. +
  11. Click on the Copy button () in the source table to copy the selected row to the clipboard.
  12. +
+

+
    +
  1. In the target table, paste it with the Paste button () as a new layer.
  2. +
  3. Assign this new sheet pile to layer=1.
  4. +
  5. Stop editing and save the new element.
  6. +
  7. Click Compute to start the computation again.
  8. +
+

The results are directly visible in the contours and cross-section again.
We can conclude that the drawdown in the building pit increases with a factor of almost 2 (-7.48 m at the centre of the building pit). Therefore, we adjust the well flow to 3.95/7.48*30=15.54 m3/d per well.

+
    +
  1. Implement this change in the timm Well element and recalculate the model.
  2. +
+
+
+

+
Figure 13: Cross section of groundwater heads per layer, sheet pile wall R=100d in layers 0 and 1 and 8 wells at 15.25 m3/d each in layer0
+
+
+

We conclude that the lowering around the building pit with deep sheet piles improved significantly.

+

Next also alternatives with a shallow concrete cut-off wall will be calculated for a shallow and a deep wall. In that case we have R=1000 d, but note that the input in the attribute than becomes k*R=10000 due to the error in Tim.

+
    +
  1. After changing the value in attribute tables of wall elements, we can compute again, switching off and on the element for the deep wall section (tab Geopackage on the QGIS-Tim panel).
  2. +
+

Again extra calculation is needed to adjust well extractions for drawdown in the building pit.
Results of calculations are gathered in the following table, showing extractions and head outside the wall at South East monitoring position.

+
+ + ++++++ + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + + +
Table 4: Effect of 4 Wall alternatives on extraction rate and drawdown South East.
Wall alternative
at c1=40 d
Wall resistance
[d]
Groundwater extraction
[m3/d]
Head SE monitoring
[dh in m]
Shallow sheet pile wall100240-0.39
Deep sheet pile wall100122-0.16
Shallow cut-off wall1000208-0.30
Deep cut-off wall100080-0.04
+
+

Installation of 15 m deep sheet pile wall or cut-off wall can be elaborated in a geotechnical design.
Still, probably some decrease of interlock leakage is needed when sheet piles are chosen. Interlock sealing or maybe irrigation of water in a shallow drain pipe around the building pit could lead to approval by authorities.

+
+
+

Effect of a not closed wall (about 20 cm)

+

Authorities are afraid that leakage incidents could be harmful for surrounding monuments. The effect of leakage can be studied by creating a fictitious little opening in the wall. This can be done e.g. by changing the values of first and last coordinate of the leaky line doublet.

+
    +
  1. Select the Leaky Line Doublet in the Layers panel
  2. +
  3. In the editing toolbar go to the toggle editing option () and check the vertex option ().
  4. +
  5. On the drawing panel select a point in the line element of the wall and right click.
  6. +
+

The list with coordinates appears in the vertex editor at the lower left corner of the screen. There you can edit the coordinates of all points in the line. Another option is to zoom in and select a point in the line element and drag it to a new position.

+

When the coordinates differ a gap results, in the studied case we created a 0.2 m wide gap. It might be elaborate to perform but the result is shown in the next figure. The result is calculated by using a small grid spacing. At this created gap a large flow results in the corner of the building pit, leading to an insufficient drawdown in the building pit and a 0.1 – 0.2 m larger lowering outside the building pit at that location.

+
+
+

+
Figure 14: Calculated effect of leakage at one corner in the building pit
+
+
+

When the contractor wants to restore the dewatering level inside the building pit, the drawdown outside the gap will even grow further.

+
+
+

Using Python for sensitivity analyses with a QGIS-Tim model

+

QGIS-Tim offers the opportunity to export the geopackage of the created model to a Python script. This makes it possible to use the script for other ways of calculation, e.g.: - Calculation of model results in other Python environments, like Anaconda or Spyder or in a notebook. - Use in other python oriented programs, like the Probabilistic Toolkit.

+
    +
  1. If input of all elements is ready and the model has proved to run properly, go to the QGIS-Tim panel and the tab Geopackage.
  2. +
  3. At the bottom press the button Convert GeoPackage to Python script.
  4. +
  5. After a short period for translation in Python the explorer panel appears where you can enter the name you want to give for the python file, e.g. “DHRVS.py” and store it in a directory you choose to save your work. The file looks like:
  6. +
+

+

As can be seen the converted Python file contains a call on main necessary Python packages and all data coordinates and parameter values related to the elements that were selected in the model that was created in QGIS-Tim. At the end of the Python file the model.solve command is stated after which all head values in the domain with the desired mesh density are determined and also at demanded observation points.

+

+

As can be seen the Python script for TimML is written in a very dedicated and condensed manner.

+

To get the Python file running in a platform like Anaconda or Spyder, extra lines should be added at wish, to get the output that the user needs.

+

Also this file can be used for geostatistical and scenario-analysis. There are several ways of handling this kind of study, like writing an additional Python program to perform repeated calculations and statistical analysis on results. But another way is to use the Probabilistic Toolkit (PTK), a platform for statistical analysis to be used together with geotechnical design programs, developed by Deltares. The PTK can be used for study of model sensitivity for variation of parameter values or reliability analysis.

+

The PTK can be downloaded free of charge at Probabilistic Toolkit - download.

+
    +
  1. Open the Probabilistic Toolkit from your desktop () or Windows menu (Deltares folder).
  2. +
+

The Toolkit opens at the first of 5 tabs: Model.

+
    +
  1. In the section Model Type check if the dropdown menu Type is set to Internal

  2. +
  3. In the section Model Type check if the dropdown menu Language is set to Python and a the field Version appears.

  4. +
  5. Select the ‘…’ in the field Version and give the path where PTK can find the Python interpreter, e.g. Spyder at .

  6. +
  7. Than we copy the Python file we converted from QGIS-Tim into the Source code window. We handle the process in this way because we want to change some lines in the source code to get the program running in PTK.

  8. +
+

Next the specific parameters must be selected that are expected to be probably most relevant to variations in results. In the source code used in the PTK those parameters will not have input on a value but need to be mentioned with a name that the PTK can use for input selection in the calculations.
The parameters that seem to be important are:

+
    +
  • The hydraulic resistance of the sheet pile wall Rlld.
  • +
  • The resistance c1 of the first clay layer.
  • +
  • The permeability of the sand layer k01.
  • +
  • The resistance c2 of the second clay layer at -14 m NAP.
  • +
+

This is shown in the next figure.

+

+

In the Source code we have to change a few things:

+
    +
  • In the PTK panel input we use the parameter names Rshp, czba, khol and cbasis, give them values (10000, 40, 10, 100)
  • +
  • in the variables tab and in the source we assign these values to the parameters by statement lines in the source code.
  • +
+

+

In the source code we change the values in the element declaration of the aquifer, leaky line doublet Damw0_0, to the names of the parameters Rlld, c1, khol, c2.

+

We make this a simple analysis by using only the sheetpile in the upper layer (maybe eliminating the element statement lines for the sheetpile in the second layer). At the end of the source code we eliminate the following lines form the converted file:

+

head = model.headgrid(xg=np.arange(80940.0, 81166.0, 4), yg=np.arange(455554.0, 455360.0, -4) )

+

And also we eliminate the lines

+

observation_peilbuis_2 = model.head(x=80970.16497991727, y=455495.54316352855) observation_peilbuis_3 = model.head(x=81004.86605597858, y=455389.68291883526) observation_peilbuis_4 = model.head(x=81049.06450220713, y=455485.0645022071)

+

Because we only are interested in 2 points we use the first two observation points and we add

+

pb0 = observation_peilbuis_0[0] pb1 = observation_peilbuis_1[0]

+

In the output screen of the PTK we add variables pb0 and pb1.

+

We check if the program works properly by performing the Run model in Single run mode (in toolbar of PTK). By pressing the arrow the calculation starts running. In the Run model tab we find the results of our calculation. Check if it complies with your earlier calculations in QGIS-Tim.

+

+

If results are as expected, we can step to a sensitivity analyses. For each selected parameter a distribution is defined with certain limits or characteristic values. Distribution formulas can be chosen based on knowhow of the user. Best guess of the parameter value distributions are given in the next table.

+
+
+

+
Best guess of the parameter value distributions
+
+
+

Parameter value distributions of sheetpile resistance Rshp, silt layer resistance czba, basic peat layer resistance cbasis and permeability of Holocene sand khol are shown in graphs below.

+

figuur Pameter value distributions of sheetpile resistance Rshp (??)

+
+
+

+
Pameter value distributions of silt layer resistance czba (??)
+
+
+
+
+

+
Pameter value distributions of basic peat layer resistance (??)
+
+
+
+
+

+
Pameter value distributions of cbasis (??)
+
+
+
+
+

+
Pameter value distributions of permeability of Holocene sand khol (??)
+
+
+

Low and high value of resistivity are set in the Calculation tab to 10 and 90%.

+

In the tab Sensitivity we can find in what extent parameter variations contribute to model results. In the next graph it is shown what parameter variation means for drawdown in the building pit. We conclude that for a situation with a sheet pile wall in only the first sand layer the variation of the resistance of the loamy layer determines the drawdown, and with that this factor determines the amount of extraction in that situation for the largest part. Translated to practical considerations, it is worthwhile to spend extra budget on determining the homogeneity of that layer and the vertical permeability of the loamy layer in more detail.

+

+ + +
+ +
+ +
+ + + + \ No newline at end of file