User interface overview

The 3Di Modeller Interface consists of five components:

1. Main menu

2. Toolbar: the 3Di Schematisation Editor toolbar, a button to open the 3Di Models and Simulations panel, and the 3Di Results Analysis toolbar are already added to the toolbar.

3. Panels: the 3Di Processing Algorithms QGIS Processing Toolbox.

4. Map canvas

5. Status bar

Fig. 7 Overview of the 3Di Modeller Interface.

3Di Schematisation Editor toolbar

Fig. 8 3Di Schematisation Editor toolbar

• Open geopackage: Loads your schematisation in the Modeller Interface, directly from the geopackage.

• Load from Spatialite: Load your schematisation in the Modeller Interface, by loading the data from the spatialite into a geopackage. The Schematisation Editor automatically performs the transformation and saves the .gpkg-file in the same folder and with the same name as the spatialite.

• Save to Spatialite: Saves the data back to the spatialite from which you loaded it. Do not forget to save your changes to the spatialite before uploading the spatialite to a new revision!

• Save As: Gives you the option to select another spatialite to save your data to.

• Remove 3Di Model: Removes the schematisation layers from your project.

To start working with the Schematisation Editor, the data from the spatialite has to be loaded into a geopackage. This is easily done by using the Load from Spatialite button. The Schematisation Editor automatically performs the transformation and saves the .gpkg-file in the same folder and with the same name as the spatialite.

Once you are finished with editing the schematisation, the changes have to be saved back to the spatialite.

Save to Spatialite will save the data back to the spatialite from which you loaded it. Save As gives you the option to select another spatialite to save your data to. Do not forget to save your changes to the spatialite before uploading the spatialite to a new revision!

Schematisations can also be opened directly from the geopackage, using the Open 3Di Geopackage option.

The Remove 3Di Model button removes the schematisation layers from your project.

3Di Models and Simulations panel

Activate the 3Di Models and Simulation panel by clicking the pictogram () in the toolbar.

• User: Log in by clicking on the arrow and Log out by clicking on the cross.

• Schematisation: Load an existing schematisation of your organization.

• Revisions: Shows the revision of the currently loaded schematisation.

• Download: Download schematisations that belong to your organization.

• Upload: Upload your schematisation to your organization.

• New: Create a new schematisation.

• Simulate: Run a simulation with a 3Di model.

• Results: Download results of simulations run by your organization in the past 7 days.

• Manage: Redirects you to the 3Di Management, where you can manage your schematisations, revisions and simulations.

3Di Models and Simulations settings

Access the 3Di Models and Simulation settings dialog by clicking Main menu > Plugins > 3Di Models and Simulations > Settings.

• Base API URL: The Base API URL is in most cases https://api.3di.live.

• Uploads processing timeout: If uploading data for a simulation (such as initial water levels or laterals time series) takes longer than the value specified here (in seconds), 3Di Models & Simulations will stop trying to initialize the simulation. Default value is 900 s.

• Working directory: Set the local working directory. In this directory all your schematisations and results will be stored.

• API Key: Set you personal API Key. Click here for more information on how to obtain one.

• Use defaults: Sets the default Base API URL, Uploads processing timeout and Working directory

3Di Results Analysis toolbar

Temporal controller

When you load your results the Temporal Controller will automatically appear at the top of your screen (if it was not already visible). With the Temporal Controller you can see and analyse the results through time. The Temporal Controller is a native feature of QGIS and can also be utilised in combination with other results tools. To use this tool, you first need to click the in front of the desired results in the Results Manager. If you have loaded more than one set of results, the shows the set that is used in the visualisation. Click the again to stop visualisation of the results.

The results are visualised on the flowlines, 1D nodes and 2D computational cells (see Results 3Di for more information on the possible flow-variables).

1. Pause or play the animation of the results through time.

2. Skip to next frame.

3. Skip to last frame.

4. Move the slider to visualise the results at different timesteps.

5. Check to automatically reset and repeat the animation endlessly when running the animation.

6. The temporal range that is used for the visualisation. Note that the default range that is shown is the range used in the simulation.

7. The steps per frame. Here the steps frame are shown every 300 seconds. Note that this shouldn’t be smaller than the used output timestep in the simulation.

8. The units that correspond to the number of steps [6].

9. Export the results as png’s for every or any timestep.

3Di Processing Algorithms

Many 3Di related actions can be performed by running a Processing Algorithm. These can be found in the (QGIS native) Processing Toolbox. To open the processing toolbox from the main menu, click Processing > Toolbox. Alteratively, you can click in the attributes toolbar or use the keyboard shortcut CTRL + ALT + T. Scroll down to the sections 3Di and 3Di Schematisation Editor to find the 3Di-specific processing algorithms.