Skip to content

Commit

Permalink
Merge pull request #403 from nens/399-crashende-simulatie-handboek
Browse files Browse the repository at this point in the history
Update f_problem_solving.rst
  • Loading branch information
leendertvanwolfswinkel authored Feb 21, 2024

Verified

This commit was created on GitHub.com and signed with GitHub’s verified signature.
2 parents e94c140 + 2b88380 commit ab9ce85
Showing 4 changed files with 84 additions and 16 deletions.
59 changes: 48 additions & 11 deletions source/d_overview_management_portal.rst
Original file line number Diff line number Diff line change
@@ -26,20 +26,57 @@ You can log out by clicking *<your user name>* > *Logout* in the top right.

.. _3di_management_schematisations:

Schematisations
===============
Schematisations list
====================
If you click the *Schematisations* tile in the overview, you will see a list of all :ref:`schematisations <schematisation>` within your organization. This list of schematisations can be exported to an Excel file.

You can find a specific schematisation by searching its Name, Tag, or Creator using the search bar. Once you locate the desired schematisation, you can click on its name to open the detailed view. In this detailed view, you have the following options:
You can find a specific schematisation by searching its Name, Tag, or Creator using the search bar. Once you locate the desired schematisation, you can click on its name to open the detailed view.

- View all information related to the :ref:`threedimodel`.
- Verify the IDs.
- Select a different revision.
- Review the history of simulations conducted with this schematisation.
- Download the SQLite file and rasters.
- Generate or regenerate a 3Di model and track its progress.
- Delete the schematisation, its revisions, associated models (note: all revisions must be deleted first), and simulation templates.
- Explore the simulation templates connected to the schematisation.
Schematisation detail page
==========================

The schematisation detail page consists of the following sections:

- Schematisation
- Revision
- 3Di Model of this revision
- Predefined simulation data (if applicable)

Schematisation
--------------

Describes the schematisation. In this section you can change the properties of the schematisation, such as the name, description, and tags. You can also transfer the schematisation to another organisation or delete the schematisation.

Revision
--------

This section gives information on the selected revision. To view the properties of another revision of this schematisation, click *Choose other* revision.
In this section you can download the SQLite file and rasters for this revision.

3Di Model of this revision
--------------------------

If a 3Di Model has been generated for this revision, this section shows the properties of the 3Di Model, such as model name, model size (nodes and line count), extent and location,

.. _regenerate_3di_model:

(Re-)generate 3Di Model
^^^^^^^^^^^^^^^^^^^^^^^

Under the heading *Re-generate*, you can see if the 3Di Model is still up to date, i.e. if it has been generated with the most recent 3Di framework version. If it says here that "The model is **not** up to date", you may want to re-generate the 3Di Model. In most cases, this will not be necessary, but if there are any problems with this 3Di Model, please re-generate the 3Di model to see if this solves the issues.

To re-generate the 3Di model, click *Re-generate this 3Di model*.

Simulation templates
^^^^^^^^^^^^^^^^^^^^

This table gives an overview of the simulation templates that are available for this 3Di model.


Predefined simulation data (if applicable)
------------------------------------------

This section shows initial (ground)water level rasters and saved states that are available for the selected 3Di model.


.. _3di_management_models:
29 changes: 29 additions & 0 deletions source/f_problem_solving.rst
Original file line number Diff line number Diff line change
@@ -8,9 +8,11 @@ Some issues are due to the software, these will be summarised in the section Kno
Errors related to input data or other user settings are usually covered by the schematisation checker. In rare cases however they might not catch a potential issue.

- :ref:`model_size_limitations`
- :ref:`problem_solving_guide`
- :ref:`faq`
- :ref:`known_issues`


.. _model_size_limitations:

Limitations to model size
@@ -48,6 +50,33 @@ Maximum raster size

The maximum size of the Digital Elevation Model is 5 billion pixels. This includes NoData pixels. The other rasters will be resampled to the resolution of the DEM, so their pixel count is not relevant.

.. _problem_solving_guide:

Problem solving guide
---------------------

The 3Di computational core is very stable and crashing simulations are very uncommon. Most schematisation errors that result in a failure to generate a valid 3Di model, or in crashing simulations, will be caught by the :ref:`schematisation checker<checking_model>`. However, if you do run into an error or crash, there are several things you can do to resolve the issues before contacting the :ref:`servicedesk`. The service desk will always ask you to go through these steps before your issue is taken up.

Errors during 3Di model generation
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
- Run the :ref:`schematisation checker<checking_model>`. Resolve any errors reported by the checker. Also look into the warnings and info messages and try to resolve those as well, unless you are convinced that the schematisation choice for which te schematisation checker gives a warning is the correct choice for your specific use case.
- Check if the 3Di Modeller Interface and the 3Di plugins are up to date. If this is not the case, :ref:`update the 3Di plugins<updating_plugin_schem_editor>` and run the schematisation checker again. It is recommended to :ref:`re-install the 3Di Modeller Interface<MI_installation>` every year at the end of March.
- Check if your model is not too large, see :ref:`model_size_limitations`
- If the model generation failed while making the simulation template: Check your initial settings in your schematisation including initial (ground)water level raster.

.. todo::
Margriet gaat op een rijtje zetten welke tabellen/kolommen door de template worker worden gebruikt, zodat we dat hier kunnen toevoegen

Crashed simulations
^^^^^^^^^^^^^^^^^^^

Common causes for crashing simulations are noted in the list below. Please check these if you encounter crashing simulations.

- Check if your 3Di model is up to date. The model generation will always use the latest 3Di framework, but if the 3Di model was generated a long time ago, or there was a new release after the generation of your model, your 3di Model may be outdated. Please :ref:`re-generate the 3Di model<regenerate_3di_model>` to see if this resolves your issue.
- It could be that you missed something when uploading your schematisation, when encountering a crashing simulation. You could download your schematisation and run this schematisation again to see if you missed any warnings.

If these suggestions did not solve your problem, you can try to run your simulation on the 3Di Live. When your model does run on 3Di Live, it could be that something is wrong with your simulation template. Check this for any weird/wrong settings and restart your simulation.


.. _faq:

6 changes: 4 additions & 2 deletions source/f_servicedesk.rst
Original file line number Diff line number Diff line change
@@ -6,7 +6,7 @@ Service desk

Nelen & Schuurmans provide a Service Desk function via https://nelen-schuurmans.topdesk.net/, The Nelen & Schuurmans Self Service Portal shall be available 24/7.
The Service Desk gives support on all 3Di modules for 3Di customers.
Customers can reach telephonic support (Prio 1) on working days from 09:00 - 17:00 (CEST) excluding the days declared as dutch public holiday close days.
Customers can reach telephonic support (Prio 1) on working days from 09:00 - 17:00 (CEST) excluding the days declared as Dutch public holiday close days.

Customers shall report incidents primarily via the Self Service Portal but may also do so via email: [email protected].
This access should be used for, but not limited to:
@@ -20,8 +20,10 @@ This access should be used for, but not limited to:

All incidents relating to the 3Di software with the exception of enhancement/feature requests are recorded and followed up at no additional cost.

When reporting an issue, please provide all information that is needed for the service desk to reproduce the issue, such as schematisation ID, 3Di model ID, revision number, simulation ID, etc.

If you have an issue with generating 3Di models or crashing simulations, please follow the :ref:`problem_solving_guide`. If the problem persists despite following the recommendations in the Problem solving guide, please mention in your service desk ticket that you have already attempted these steps.

If there is an error, please provide as much information as you can about the error and the model and revision number for which the error occurs.


Priority incidents
6 changes: 3 additions & 3 deletions source/i_checking_schematisations.rst
Original file line number Diff line number Diff line change
@@ -1,14 +1,14 @@
.. _checking_model:

Checking the schematisation
===================================
===========================

It is highly recommended to check your schematisation before uploading. It helps you detect and solve errors or warnings early on.

.. _schematisationchecker:

Schematisation checker
-------------------------
----------------------

The *schematisation checker* checks your 3Di schematisation (.sqlite file) for completeness and consistency between tables.
With the checker you detect most database errors before uploading the schematisation to the 3Di servers for model generation.
@@ -37,7 +37,7 @@ For a table of all the checks run on the schematisation, and their respective er
Visualising computational grids
--------------------------------
-------------------------------

3Di builds a computational grid from schematisation data (stored in spatialite and rasters). This computational grid is stored in a "gridadmin.h5" file. You can visualize these grids in the 3Di Modeller Interface.

0 comments on commit ab9ce85

Please sign in to comment.