Interface

Preferences

The Preferences menu allows to define the general configuration which is saved :

  • in the .thyrsis.ini file of the project folder where the computation database is saved,

  • in the thyrsis.ini file of the $HOME/.thyrsis folder.

At the first use of the plugin, the $HOME/.thyrsis folder is created and the thyrsis.ini file is set with default values. The Preferences dialog is opened and the user is asked to set his configuration (cf. infra).

When a project is re-opened, the configuration loaded is the .thyrsis.ini file of the database folder. Therefore it is possible to define a configuration for each project.

Installation

../../_images/Preferences_installation.png

Figure 34 Preferences menu, installation window

Installation preferences define the location of files and folders needed by the plugin :

  • GMSH executable path

  • OpenFoam project and PMF installation directory

These variable are defined with default values. Please check values before THYRSIS use.

  • the folder where the background layer maps are saved (.vrt files),

  • the MPI configuration file, which includes computational units to use, and the number of processes available for each unit, written like :

tata:8
titi:8
toto:4

Futhermore, it is also possible to define :

  • the number of processes to use for parallelized computation,

  • the maximum number of vertical 1D columns to display.

  • the mesh generator use (GMSH or CFMESH)

Important

For CFMESH use on Windows, minimum version of OpenFoam is v2112. There is an issue with cfMesh use on previous pre-compiled version.

  • the hydrogeologic software used (OPENFOAM or METIS)

Finally, two checkboxes are present in order to define :

  • if the logs have to be displayed in the terminal,

  • if detailed logs are wanted (verbose mode).

Variables

../../_images/Preferences_variables.png

Figure 35 Preferences menu, Variables window

The variables preferences provide the opportunity to define which variables should be saved :

  • potential,

  • Darcy’s velocity,

  • concentration,

  • activity,

  • saturation,

and the display configuration, by defining:

  • the unit,

  • the scale,

  • the number of classes.

The scale defines the ratio between the minimal value to display and the maximal value obtained from simulation. By default the scale is set to 0.001, but a lower value can be chosen to get a better view of the plume extent.

The number of classes is used to display the plume with a graduated scale.

This preferences window enables also to define the mass unit for the mass balance and to check a box avoiding to display units, for communication purposes.

Animation

../../_images/Preferences_animation.png

Figure 36 Preferences menu, Animation window

The refresh rate used for video export can be configure in this window.

Matplotlib

../../_images/Preferences_matplotlib.png

Figure 37 Preferences menu, Matplotlib window

This window allows the user to configure some matplotlib parameters such as :

  • tick label size,

  • y label font size,

  • legend font size.

Database

../../_images/Preference_database.png

Figure 38 Preference menu, Database window

This window allows the user to connect to an experimental database by defining a connection service.

The push button Synchronize experimental database with site database enables the loading of boreholes, points of interest, hydraulic heads and volumic concentrations from the experimental base to the sites.sqlite database.


Dialogs and panels

2D Panel

../../_images/Thyrsis_2D.png

Figure 53 Example of 2D panel, with result layer displayed after a simulation

The 2D panel is the main QGIS interface, more precisely the map canvas. It is connected with the “Layers” panel and displays on various background maps the specific parameters of the hydrogeological model :

  • mesh nodes,

  • mesh,

  • points of interest,

  • boreholes,

  • contours,

  • potential (piezometric level),

  • permeability,

  • topographic elevation,

  • aquifer substratum altitude,

  • Darcy’s velocity,

  • unsatured zone thickness,

  • groundwater thickness,

  • reference potential, which is obtained by interpolation of the piezometric data, and could have been used to build the hydrogeological model, through inversion computation.

Injection zones, defined in the THYRSIS panel, are displayed in the 2D panel.

At the end of a computation, a result layer is also displayed in the 2D panel. The dates and the variable to display are controled by the Menu bar.

THYRSIS panel

../../_images/Thyrsis_Injection_defaut.png

Figure 54 Example of a Thyrsis panel, used to define injection zones

The THYRSIS panel is used to define injection zones.

The first values to define are :

  • the simulation name,

  • the chemical to use, selected in the drop-down menu,

  • the partition coefficient and the solubility limit in case of mass injection,

  • the starting date of the simulation, with format DD/MM/YYYY [hh:mm:ss],

  • a set of tuples (duration, step), that define the simulation output dates.

Then the type of injection can be chosen by clicking on :

  • flux,

  • concentration,

  • mass.

../../_images/Thyrsis_Flux.png

Figure 55 Example of THYRSIS panel to define a flux injection zone

According to the injection type selected, relevant fields may differ, as mention in the injection part. A non-null water volume is a leak that induces a transient flow simulation.

It is possible to add as many injections as wanted by clicking many times on the selected button, but it is impossible to mix several injection types in the same simulation.

The center coordinates of the injection zone can be defined manually or by clicking on \({\odot}\) and then clicking on the wanted location in the map canvas.

Similary the surface can be defines manually in the Area field, or automatically calculated by clicking on ../../_images/draw.png and then drawing the shape on the map canvas.

Below the THYRSIS panel, three buttons allows to cancel or save the modifications, and also to launch computation :

  • “Cancel” will cancel current modifications and reload the saved informations that are stored in the database.

  • “Save” will save the modifications (data and geometry) in the computation database.

  • ../../_images/config_simulation.png will launch the simulation.

Note

If you made modifications, it is important to save it by clicking on “Save” before launching the computation by clicking on ../../_images/config_simulation.png .

Borehole

../../_images/Thyrsis_Forage.png

Figure 56 Example of stratigraphic log diplayed in the borehole panel

When stratigraphic and lithologic informations are provided in the sites.sqlite database, the stratigraphic log can be displayed in the borehole panel. Click on ../../_images/forage.png in the bar menu and select the borehole directly in the map canvas. If the fracturated rate is known, it is displayed in the stratigraphic log.

This graphic representation is based on differents codifications presented in the Stratigraphic logs annexe :

  • codification on the geological time scale (BRGM),

  • RGB colorimetric codification of the Commission for the geological map of the world (CGMW),

  • the lithology pattern chart from USGS.

3D panel

../../_images/Thyrsis_3D.png

Figure 57 Exemple of 3D panel

The 3D panel is used to display a three dimensional representation of the following three levels :

  • the aquifer substratum,

  • the piezometric level,

  • the topographic altitude.

If results from a simulation are available, they are displayed on the potential layer, with the same symbology used in the map canvas.

This panel is controled through the options of the “3D parameters panel” :

  • the cursor is used to ajust vertical scale,

  • checkbox can be activated to display :

    • texture,

    • contours,

    • boreholes,

    • computation points.

Colors of the topographic altitude and contours can be modified.

Unsaturated zone (ZNS)

../../_images/Thyrsis_ZNS.png

Figure 58 Example of results displayed in the panel dedicated to the unsaturated zone

The ZNS panel displays in the unsatured zone columns the temporal evolution of the simulated variables.

These variables and units must be selected in the combobox of the bar menu.

Some options are provided to define the legend :

  • Automatic scale update of the legend : the legend scale is updated for each date. If desactivated, the legend is calculated on the whole timeseries.

  • Legend : this action opens a dialog to custom the legend,

  • Legend position : used to choose the legend position (left, right or bottom).

1D panel

The temporal evolution curves are obtained by clicking on the ../../_images/plot.png button or the ../../_images/plot_bilan.png button in the Menu bar, and are displayed in a new panel :

  • ../../_images/plot_bilan.png displays the temporal evolution of mass balance (if existing).

  • ../../_images/plot.png displays the temporal evolution of the selected variable in the combobox of the Menu bar, for each selected points in the QGIS map canvas.

../../_images/Thyrsis_1D_bilan.png

Figure 59 Example of 1D graphic with temporal evolution of mass balance

../../_images/Thyrsis_1D_potentiel.png

Figure 60 Example of 1D graphic with temporal evolution of simulated and measured potential