QGIS ARR to TUFLOW: Difference between revisions

Content deleted Content added
No edit summary
 
(9 intermediate revisions by 6 users not shown)
Line 1:
The ARR to TUFLOW utility has been developed to help users set up a TUFLOW model that uses Australian Rainfall and Runoff (ARR) input parameters and the Australian Bureau of Meteorology (BOM) rainfall by automating the collection and processing of the data. The inputs and outputs of the tool are explained in detail below. '''''Note:''''' this tool helps with data processing, however is not a substitute to reading ARR. Similarly this wiki page discusses the use of the tool and the options, however context should be derived from ARR directly. Please see the [https://arr.ga.gov.au/arr-guideline| ARR Website] for more information.<br><br>
 
__TOC__
<br>
__TOC__
=Getting Started=
===Installation===
Line 80 ⟶ 81:
=Additional Options=
===Climate Change===
Climate change options can be added by clicking on '''Edit''' under the climate change section. This opens up a table widget that the user can then add/remove climate change scenarios based on the guidance in ARR v4.2. Once a user adds a scenario (green plus), they can double click on the values to change them. For example, double clicking on SSP2-4.5 under the 'SSP' heading will show the available Shared Socioeconomic Pathway (SSP) options. Scenarios added in the table will be displayed in the climate change section (underneath the edit button). Note: each scenario name must be unique and generally the table widget will force unique names. The scenario names will be used throughout the outputs and the user is free to customise the scenario names as they want.<br>
Climate change options can be added by checking on a combination of climate change years and Representative Concentration Pathways (RCP) in the dialog. Selecting at least one climate change scenario will output:
 
The table columns within the table widget are based on ARR guidelines v4.2 and the examples presented in Book 1, Chapter 6. Please note the following assumptions:<br>
* Near-term horizon = 2030
* Medium-term horizon = 2050
* Long-term horizon = 2090
* Temperature Change - Setting this to -1 will adopt the temperature changes output in the climate change part of the ARR datahub download. If a value or zero or greater is set by the user, this will be adopted instead of the datahub values and it will be assumed that these are changes relative to the pre-industrial period. Note: the temperature change will be stopped from going negative within the calculation.
 
 
By adding climate change scenarios, the following outputs will be turned on:
* An extra boundary database file: '''bc_dbase_CC.csv'''
* Climate change inflows will be appended to the end of each event's inflow file
* One additional event option will also be added to the event file for each combination of selected climate change scenarios labelled asbased CC01,on CC02,the CC03,...scenario etc.name. It is intended that the climate change scenarios would be treated as a separate event (e1 = magnitude, e2 = duration, e3 = temporal pattern, e4 = climate change scenario) however the output files can easily be manipulated by the user to configure the model differently.<br><br>
* The following CSV files will be written to the '''data''' output folder:
[[File: ARR_dialog_climate_change_01a.png]]<br><br>
** ''<scen_name>_rainfall_factors.csv''
** ''<scen_name>_rainfall_depths.csv''
** ''<scen_name>_losses.csv''<br><br>
[[File: ARR_dialog_climate_change_01aARR_dialog_climate_change_01b.png]]<br><br>
[[File: ARR_example_climate_change_rf_inflow_01a.png|1200px]] <br><br>
[[File: ARR_example_climate_change_tef_01a.png]]
Line 113 ⟶ 127:
 
===Rainfall Losses===
The following sections summarise the available loss options. Please note, as recommended in ARR2019, <u>[https://data.arr-software.org/ ARR datahub]</u> losses are only intended for rural use. They are not for direct use in urban areas. Furthermore, applications in New South Wales and Victoria should consider the following jurisdiction specific guidance:
''Since version v3.5 initial loss for durations greater than 72 hrs is assumed to be the same as the initial loss for 72 hrs. Previous to this version, these losses were output as zeros.''<Br>
* <u>[https://data.arr-software.org/nsw_specific NSW Specific Guidance]</u>
* <u>[https://data.arr-software.org/vic_specific VIC Specific Guidance]</u>
 
''Note: Since version v3.5 initial loss for durations greater than 72 hrs is assumed to be the same as the initial loss for 72 hrs. Previous to this version, these losses were output as zeros.''<Br>
 
=====Probability Neutral Losses=====
Probability neutral losses can be toggled on / off in the dialog (default is on). If 'on', this option will use probability neutral losses for the design burst initial loss rather than using the storm initial loss and pre-burst depths. If probability neutral losses are not available in the catchment area, then the method will automatically revert to using the storm initial loss). Currently this option cannot be used in conjunction with the '''complete storm''' option.<br><br>
Line 146 ⟶ 165:
=====TUFLOW Loss Method=====
The loss method used by TUFLOW can be changed using the '''TUFLOW Loss Method''' dropdown box:
* '''Infiltration (soil file)''' - will output files for the infiltration approach in TUFLOW. This approach in TUFLOW applies the total rainfall to the 2D grid and ponded water in the 2D domain can then infiltrate based on the underlying soil type and impervious fraction. See <u>[https://docs.tuflow.com/classic-hpc/manual/latest/ TUFLOW Manual]</u> for more information.
* '''Rainfall Excess (material file)''' - will output files for the rainfall excess approach in TUFLOW. This approach removes the losses from the rainfall inflow prior to application so only excess rainfall is added to the model.
<br>
Line 172 ⟶ 191:
The user can choose to output the complete storm (preburst + design burst) rather than just the design burst by checking on the following option (please see ARR Book 2 Chapter 5 [Section 5.9.9] for more information):<br>
[[File: ARR_complete_storm_checkbox_01a.png]]<br>
The complete storm generated by the tool will be the preburst depth (from the '''Preburst percentile''' extracted from the datahub) plus the design burst. The user will be required to select a preburst temporal pattern from the options listed below. The options below have been included at the request of users and are not a direct reference to any specific methodology outline in ARR. If you would like to see another method included, please email <b><u>[mailto:support@tuflow.com support@tuflow.com]</u></b>.<br>
Currently the ARR to TUFLOW tool supports the following preburst temporal pattern methods:
* '''Constant Rate''' - This will apply the preburst depth equally over a given time period. The time period can be specified as an absolute time (either as minutes or hours) or proprotional to the design storm e.g. a proportional value of 0.5 will apply a 30 min preburst to a 1 hr storm and a 15 min preburst to a 30 min storm.