Skip to content

Commit

Permalink
Update i_running_a_simulation.rst
Browse files Browse the repository at this point in the history
  • Loading branch information
leendertvanwolfswinkel committed May 16, 2024
1 parent 4d54b91 commit 844ef7f
Showing 1 changed file with 57 additions and 12 deletions.
69 changes: 57 additions & 12 deletions source/i_running_a_simulation.rst
Original file line number Diff line number Diff line change
Expand Up @@ -200,20 +200,23 @@ Initial conditions either refer to the use of saved state file, or the use of in
Laterals
========

Laterals can be uploaded using .csv format for either 1D or 2D. For a more detailed description on laterals, see: :ref:`laterals`.
Laterals can be uploaded using .csv format for 1D and/or 2D. For a more detailed description on laterals, see: :ref:`laterals`.

* Select the 'Type of laterals:'
* Upload a CSV file
* Set the time units used in your CSV file (hours, minutes, or seconds). The default is minutes (mins), because this is the time unit that is used in the 3Di spatialite
* If the option 'Interpolate' is checked, the value between time steps will be linearly interpolated.
* Check the option 'Overrule single laterals', to exclude certain laterals in your model
You can switch the 1D and/or the 2D laterals on and off by checking or unchecking the checkbox for the group.

If the option 'Interpolate' is checked, the value between time steps will be linearly interpolated. If not, the value will be constant until the next time frame starts.

.. note::

If the box *Use 1D laterals from the simulation template* is checked and *Upload 1D laterals* is also checked, the uploaded laterals are added to the laterals already present in the simulation template. The same applies to 2D laterals.

.. VRAAG: klopt mijn uitleg over 'Overrule single laterals'
.. note::

The time units you choose should match the time units used in the CSV file. The default is minutes (mins), because this is the time unit that is used in the 3Di spatialite

The CSV file format is generated by a right-mouse click on table: v2_1d_lateral. Then choose export --> save features as --> Select csv as output format. Choose a filename and location to store and click OK. the file should be like this:

| **Follow these steps to generate the CSV file:**
| The instructions are for 1D laterals; for 2D laterals, the same instructions apply.
Generating a CSV file for 1D laterals
-------------------------------------

- Load your schematisation
- In the Layers panel, right click on the layer '1D lateral' > 'Export' > 'Save features as..'
Expand All @@ -224,10 +227,52 @@ The CSV file format is generated by a right-mouse click on table: v2_1d_lateral.
- Under 'Geometry' > 'Geometry type' choose 'No Geometry'
- Under 'Layer options', make sure the 'Separator' is 'comma'
- Click 'Ok' to save the file
- You can now select the CSV file under the option "Upload file(s)" when adding scenario information
- You can now select the CSV file under the option "Upload file(s)" when adding scenario information. The time units in the spatialite (and therefore in the exported CSV) are minutes.

The CSV file for 1D laterals should look like this::

id,connection_node_id,timeseries
1,3,"0,0.5
60,1.0
120,2.0"
2,2,"0,0.5
60,1.0
120,2.0"
3,1,"0,0.5
60,1.0
120,2.0"
4,4,"0,0.5
60,1.0
120,2.0"

Generating a CSV file for 2D laterals
-------------------------------------

- Load your schematisation
- In the Layers panel, right click on the layer '2D lateral' > 'Export' > 'Save features as..'
- For 'Format', choose 'Comma Separated Value [CSV]'
- Choose a 'File name' and location to save the file to
- As CRS, choose 'EPGS: 4326 - WGS 84'
- Click 'Select fields to export and their export options'
- Make sure only the checkboxes for the fields 'id', 'type' and 'timeseries' are checked
- Under 'Geometry', make sure the 'Geometry type' is 'Automatic'
- Under 'Layer options', set GEOMETRY to 'AS_XY'
- Under 'Layer options', make sure the 'Separator' is 'comma'
- Click 'Ok' to save the file
- You can now select the CSV file under the option "Upload file(s)" when adding scenario information

*Important note: Units in the CSV are seconds (for time steps) and m\ :sup:`3`/s (for the flows).*
The CSV file for 1D laterals should look like this::

X,Y,id,type,timeseries
4.73305012754464,52.5607362843091,1,1: Surface,"0,0.5
60,1.0
120,2.0"
4.73149460853063,52.5589740526876,2,1: Surface,"0,0.5
60,1.0
120,2.0"
4.73018087976208,52.5556893490626,3,1: Surface,"0,2.5
60,2.0
120,5.0"

|
Expand Down

0 comments on commit 844ef7f

Please sign in to comment.