Skip to content

Commit

Permalink
Changes after staging review
Browse files Browse the repository at this point in the history
  • Loading branch information
leendertvanwolfswinkel committed Feb 21, 2024
1 parent 654dbcc commit e94c140
Show file tree
Hide file tree
Showing 8 changed files with 45 additions and 23 deletions.
13 changes: 4 additions & 9 deletions source/c_3di_live_sessions.rst
Original file line number Diff line number Diff line change
Expand Up @@ -88,10 +88,10 @@ You can:
Storing results
---------------

Raw results always stored for 7 days
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
.. note::

:ref:`Raw results<outputs>` will always be stored for 7 days, even if you choose the option *Quit, don't store results*.

:ref:`Raw results<outputs>` will always be stored for 7 days, even if you choose the option *Quit, don't store results*.

Direct download
^^^^^^^^^^^^^^^
Expand All @@ -104,12 +104,7 @@ Store in scenario archive
.. note::
This option is only available if your subscription includes the Scenario Archive.

Another option you have when you quit the session, is to store the results in the :ref:`scenario_archive`. When you choose this option, you also have several options for **automated post-processing**.

.. figure:: image/d3.9_store_results.png
:alt: Storing results

For an explanation of the available options, see :ref:`scenario_archive`.
Another option you have when you quit the session, is to store the results in the :ref:`scenario_archive`. When you choose this option, you also have several options for **automated post-processing**. For an explanation of the available options, see :ref:`scenario_archive`.


.. _live_simulation_template:
Expand Down
27 changes: 22 additions & 5 deletions source/d_scenario_archive.rst
Original file line number Diff line number Diff line change
Expand Up @@ -8,9 +8,9 @@ Scenario Archive

The Scenario Archive (Lizard) is used to store and view scenarios.

You can access the Scenario Archive here: https://demo.lizard.net/. For instructions on how to use the Scenario Archive, see the `Lizard documentation<http://docs.lizard.net>`_, for example, the sections about finding scenarios in the `Catalog<https://docs.lizard.net/e_catalog.html#scenarios>`_, and the section about the `Viewer<https://docs.lizard.net/e_viewer.html#>`_.
You can access the Scenario Archive here: https://demo.lizard.net/. For instructions on how to use the Scenario Archive, see the `Lizard documentation <http://docs.lizard.net>`_, for example, the sections about finding scenarios in the `Catalog <https://docs.lizard.net/e_catalog.html#scenarios>`_, and the section about the `Viewer <https://docs.lizard.net/e_viewer.html>`_.

Scenario's that are stored in the Scenario Archive can also be accessed in the 3Di Modeller Interface, using the `Lizard plugin<https://docs.lizard.net/d_qgisplugin.html>`
Scenario's that are stored in the Scenario Archive can also be accessed in the 3Di Modeller Interface, using the `Lizard plugin <https://docs.lizard.net/d_qgisplugin.html>`

A 3Di scenario consists of one or more of the following components:

Expand Down Expand Up @@ -69,7 +69,24 @@ Rain intensity per calculation cell (mm/h).
Rate of rise
^^^^^^^^^^^^

Rate of rise (m/s), defined by the difference in water level per second. Can be used for flood damage estimations, for example.
Rate of rise (m/s), defined as how fast the water depth rises from 0 to 1.5 m.

.. math::
:label: rate_of_rise
R = \frac{\delta \zeta}{\delta t}
In which:

| :math:`\delta \zeta` difference in water depth, fixed to 1.5 - 0
| :math:`\delta t` time between the cell getting wet (volume > 0) and reaching a water depth of 1.5 m. The water depth is defined as (water level - lowest DEM pixel in the cell)
Cells that already have a water depth of 1.5 m at the start of the simulation are ignored.

.. note::

This raster is calculated from the :ref:`3dinetcdf`. The temporal resolution (output time step) of this file determines the precision of :math:`\delta t`.


Max flow velocity
^^^^^^^^^^^^^^^^^
Expand All @@ -83,8 +100,8 @@ Arrival time
------------

.. todo::
Hier een stukje voor schrijven.


Hier een stukje over schrijven


.. _damage_estimation:
Expand Down
2 changes: 1 addition & 1 deletion source/h_gridadmin.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,4 @@
Computational grid file
-----------------------

The :ref:`computational_grid` is stored in a **gridadmin.h5** file. The contents of this file can be viewed in the 3Di Modeller Interface. If you are using Python, use :ref:`threedigrid` to work with this file.
The :ref:`computational_grid` is stored in a **gridadmin.h5** file. The contents of this file can be :ref:`viewed in the 3Di Modeller Interface<3di_results_manager>`. If you are using Python, use :ref:`threedigrid` to work with this file.
6 changes: 5 additions & 1 deletion source/h_water_quality_results.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,11 @@
Water quality results 3Di
=========================

The water quality results of a simulation are written to a `NetCDF <https://en.wikipedia.org/wiki/NetCDF>`_ file called *water_quality_results_3di.nc*, which follows the `CF Conventions <http://cfconventions.org/>`_ . The CF convention stipulates that the 2D and 1D mesh data are stored in separate parts of the file. The *water_quality_results_3di.nc* file contains snapshots of concentrations at nodes (1D and 2D). The output timestep, i.e. the interval at which these snapshot values are written to the NetCDF file, is set at the start of the simulation.
The water quality results of a simulation are written to a `NetCDF <https://en.wikipedia.org/wiki/NetCDF>`_ file called *water_quality_results_3di.nc*.

Use :ref:`threedigrid` to work with this file.

The file structure follows the `CF Conventions <http://cfconventions.org/>`_ . The CF convention stipulates that the 2D and 1D mesh data are stored in separate parts of the file. The *water_quality_results_3di.nc* file contains snapshots of concentrations at nodes (1D and 2D). The output timestep, i.e. the interval at which these snapshot values are written to the NetCDF file, is set at the start of the simulation.

Water quality results can be retrieved from the nodes in the 1D and 2D. The amount of variables in the netcdf depends on the amount of added substances in the model. An overview of the configuration of the variables is given below.

Expand Down
14 changes: 9 additions & 5 deletions source/i_downloading_results.rst
Original file line number Diff line number Diff line change
Expand Up @@ -11,30 +11,34 @@ There are two options for downloading simulation results:

.. _dl_via_models_simulations:

Download via 3Di Models and Simulation panel
--------------------------------------------
Download via 3Di Models and Simulations panel
---------------------------------------------

Simulation results can be downloaded using the :ref:`models_simulation_panel`, within 7 days after the simulation has finished. To download results:
Simulation results can be downloaded using the :ref:`models_simulation_panel`. To download results:

#) Activate the *3Di Models and Simulation panel* by clicking the pictogram (|modelsSimulations|) in the toolbar.
#) Click the *Results* icon (|download_results|).
#) Select the results you want to download and click *Download*.

The results will be downloaded to your local 3Di working directory, so that you can find them easily when loading them via the :ref:`3Di Resuls Manager<3di_results_manager>`

The files that are downloaded in this way are the :ref:`Raw results<outputs>`. To download automatically post-processed results, such as maximum water depth rasters, see :ref:`dl_via_lizard_plugin`.

.. note::
The raw results are only available for 7 days after a simulation has finished.
Results are only available for download from the 3Di Models and Simulations panel for 7 days after a simulation has finished.

.. |modelsSimulations| image:: /image/pictogram_modelsandsimulations.png
:scale: 90%

.. |download_results| image:: /image/pictogram_download_results.png
:scale: 60%

.. _dl_via_lizard_plugin:

Download via the Lizard plugin
------------------------------

If you have stored simulation results in the Scenario Archive, you can download them using the `Lizard plugin<https://docs.lizard.net/d_qgisplugin.html>`_.
If you have stored simulation results in the :ref:`scenario_archive`, you can download them using the `Lizard plugin <https://docs.lizard.net/d_qgisplugin.html>`_.

Instructions for storing simulation results in the Scenario Archive can be found here:

Expand Down
2 changes: 1 addition & 1 deletion source/i_wms_layers.rst
Original file line number Diff line number Diff line change
Expand Up @@ -5,4 +5,4 @@ Load results as WMS layers

You can add the post-processed results from the :ref:`scenario_archive` to your project as WMS layers, such as maximum water depth maps. This has several advantages: you do not need to download anything, and you can easily view the water depth map for any time step, or see how the water depth map changes over time.

This is easy to do with the Lizard plugin. The documentation for this tool is `part of the Lizard documentation<https://docs.lizard.net/d_qgisplugin.html>`_
This is easy to do with the Lizard plugin. The documentation for this tool is `part of the Lizard documentation <https://docs.lizard.net/d_qgisplugin.html>`_
Binary file removed source/image/d3.9_store_results.png
Binary file not shown.
4 changes: 3 additions & 1 deletion source/j_threedigrid.rst
Original file line number Diff line number Diff line change
Expand Up @@ -3,4 +3,6 @@
3Di Results API (threedigrid)
=============================

The Python package "threedigrid" is a Python interface for reading and analyzing 3Di results. It has its own documentation, which can be found `here <https://threedigrid.readthedocs.io/en/latest/>`_.
The Python package "threedigrid" is a Python interface for reading and analyzing 3Di results.

threedigrid has its own documentation, which `can be found here <https://threedigrid.readthedocs.io/en/latest/>`_.

0 comments on commit e94c140

Please sign in to comment.