SMS:TUFLOW ZShape: Difference between revisions

From XMS Wiki
Jump to navigationJump to search
 
(18 intermediate revisions by the same user not shown)
Line 1: Line 1:
The TUFLOW ZShape coverage allows the user to modify terrain with arcs and set up triggers to change those modifications, such as at a specific time during the simulation or when water depth exceeds a certain amount.  An example application is a levee collapsing when flood water overtops it.
The TUFLOW ZShape coverage allows modifying terrain with arcs and setting up triggers to change those modifications, such as at a specific time during the simulation or when water depth exceeds a certain amount.  An example application is a levee collapsing when flood water overtops it.


TUFLOW also supports polygon ZShapes.  However, SMS does not support polygon ZShapes at this time.  If needing to create static modifications to terrain using polygons, use the [[SMS:TUFLOW_Coverages#2D Z Lines/Polygons (Simple) Coverage|2D Z Lines/Polygons (Simple) Coverage]].
TUFLOW also supports polygon ZShapes.  However, SMS does not support polygon ZShapes at this time.  If needing to create static modifications to terrain using polygons, use the [[SMS:TUFLOW_Coverages#2D Z Lines/Polygons (Simple) Coverage|2D Z Lines/Polygons (Simple) Coverage]].
Line 11: Line 11:


===Arc Properties Dialog===
===Arc Properties Dialog===
[[Image:ZShape_properties_dialog.jpg|thumb|300px|right|''Z Shape Properties'' dialog]]
[[Image:zshape_property_dlg.png|thumb|325 px|''Z Shape Properties'' dialog]]  
 
Arcs in a 2D Z Lines/Polygons (Advanced) coverage store ZShape data only if they are told to "override Z values". Otherwise they are not exported for TUFLOW's use. To reach the properties dialog, right-click on an arc and choose '''Attributes..'''. Below is an explanation of the zshape options.  
Arcs in a ZShape coverage store ZShape data only if they are told to "override Z values". Otherwise they are not exported for TUFLOW's use. To reach the properties dialog, right-click on an arc and choose '''Attributes...'''. Below is an explanation of the zshape options.
* ''Override Z Values'' – ZShape data is only stored and exported if this checkbox is enabled. It tells TUFLOW to override the current terrain Z values with the new values from the arc.  
 
* ''Thickness'' – Arcs can be "Thin Lines", "Thick Lines", or "Wide Lines". Thin lines have a width of 0, thick lines have a thickness less than or equal to 1.5 times the 2D cell size, and wide lines are any width larger than that. Thin lines follow some special rules that affect other options in the dialog, such as Option and Trigger Type.  
* '''Override Z Values:''' ZShape data is only stored and exported if this checkbox is enabled. It tells TUFLOW to override the current terrain Z values with the new values from the arc.
* ''Option'' – The ZShape Options are All, Add, Min, Max, and Offset. Offset is only available for variable thin line Z Shapes, which cannot use the "Add", "Min" or "Max" options. "Add" is unavailable for any variable Z Shape.  
* '''Thickness:''' Arcs can be Thin Lines, Thick Lines, or Wide Lines. Thin lines have a width of 0, thick lines have a thickness less than or equal to 1.5 times the 2D cell size, and wide lines are any width larger than that. Thin lines follow some special rules that affect other options in the dialog, such as Option and Trigger Type.
** Offset is not listed by the same name in the TUFLOW documentation and is an alias in SMS for not specifying "NO MERGE". This causes the points of the arc to not be written, and the Z of the arc is determined by the Offset field.  
* '''Option:''' The ZShape Options are All, Add, Min, Max, and Offset. Offset is only available for variable thin line Z Shapes, which cannot use the Add, Min or Max options. Add is unavailable for any variable Z Shape.
* ''Offset'' – Raises the entire arc by this amount. Negative values are appropriate.  
<blockquote>
** When offset is specified as the Option for variable thin lines, this field specifies the height to adjust terrain to (instead of adjusting it up or down by this amount) when triggered.  
* Offset is not listed by the same name in the TUFLOW documentation and is an alias in SMS for not specifying "NO MERGE". This causes the points of the arc to not be written, and the Z of the arc is determined by the Offset field.
** For all other variable arcs, this the the amount to adjust the terrain by when the trigger activates.  
</blockquote>
* ''Change with Time'' &ndash; Toggles the arc between being a static zshape and a variable zshape. Variable z shapes use triggers to change terrain when a specific event occurs. All variable Z Shapes have the ''Duration'' option to span the change over a certain period of time. Other options will change with the trigger ''Type''.  
* '''Offset:''' Raises the entire arc by this amount. Negative values are appropriate.
** Trigger ''Type'' &ndash; The type of event that will trigger the Z modification.  
<blockquote>
*** "Specified time" &ndash; Triggers at a specific time during the simulation, measured in hours.  
* When offset is specified as the Option for variable thin lines, this field specifies the height to adjust terrain to (instead of adjusting it up or down by this amount) when triggered.
*** "Water level at point" &ndash; Uses a [[SMS:TUFLOW Coverages#Trigger Points|Trigger Point]] to measure water level, and triggers when the water level reaches or exceeds the value in the Water level field.  
* For all other variable arcs, this the the amount to adjust the terrain by when the trigger activates.
*** "Water level difference" &ndash; Uses two trigger points. Triggers when the difference between water levels measured at both points exceeds the value in Water level difference. A difference in either direction is treated the same in TUFLOW, and there is no need for negative numbers.  
</blockquote>
*** "Thin line water level" &ndash; Similar to Water level at point, but for thin lines. Does not use a trigger point, instead measuring the water levels on either side of the thin line.  
* '''Use Trigger:''' Toggles the arc between being a static zshape and a variable zshape. Variable z shapes use triggers to change terrain when a specific event occurs. All variable Z Shapes have the Duration option to span the change over a certain period of time. Other options will change with the Trigger Type.
*** "Thin line water level difference" &ndash; Triggers when the difference between water levels on either side of the thin line reaches or exceeds the value in water level difference.  
<blockquote>
** ''Point1'' and ''Point2'' &ndash; Both point selection boxes list the trigger points available in the coverage. These fields are only enabled for trigger types that use them.  
* '''Trigger Type:''' The type of event that will trigger the Z modification.
** ''Specified time, Water level, Water level difference'' &ndash; These fields become available based on the trigger type selected.  
<blockquote>
** ''Duration'' &ndash; If set to 0, changes are instantaneous once triggered. Otherwise the change will be interpolated over this many hours.  
* Specified time: Triggers at a specific time during the simulation, measured in hours.
* ''Restore Z Shape'' &ndash; This option can be used to have TUFLOW restore the original elevations at a specified time.
* Water level at point: Uses a [[#Trigger Points|Trigger Point]] to measure water level, and triggers when the water level reaches or exceeds the value in the ''Water level'' field.
** ''Repeat restoration'' &ndash; The z-shape will be restored indefinitely.
* Water level difference: Uses two trigger points. Triggers when the difference between water levels measured at both points exceeds the value in ''Water level difference''. A difference in either direction is treated the same in TUFLOW, and there is no need for negative numbers.
** ''Restore interval'' &ndash; The time (hrs) between when the variable z-shape is finished and when to start restoring the points back to their original values.
* Thin line water level: Similar to ''Water level at point'', but for thin lines. Does not use a trigger point, instead measuring the water levels on either side of the thin line.
** ''Restore period'' &ndash; The time (hrs) needed to restore the points back to their original values.
* Thin line water level difference: Triggers when the difference between water levels on either side of the thin line reaches or exceeds the value in ''Water level difference''.
</blockquote>
* Point1 and Point2: Both point selection boxes list the trigger points available in the coverage. These fields are only enabled for trigger types that use them.
* Specified time, Water level, Water level difference: These fields become available based on the trigger type selected.
* Duration: If set to 0, changes are instantaneous once triggered. Otherwise the change will be interpolated over this many hours.
</blockquote>


==Trigger Points==
==Trigger Points==
Trigger points are used by the ''Water level at point'' and ''Water level difference'' trigger types.  Simply create a feature point and enter its attributes dialog to create a trigger point.
Trigger points are used by the "Water level at point" and "Water level difference" trigger types.  Simply create a feature point and enter its attributes dialog to create a trigger point.


===Trigger Point Dialog===
===Trigger Point Dialog===
[[Image:ZShape_trigger_point_dialog.jpg‎|thumb|200px|right|''Trigger Point Attributes'' dialog]]
[[Image:ZShape_trigger_point_dialog.png‎|thumb|200px|right|''Trigger Point Attributes'' dialog]]


The ''trigger point'' dialog is used to turn a feature point into a ZShape trigger point.  Enabling the ''Specify Trigger'' checkbox and giving the point a name will cause it to appear in the Point1 and Point2 selection boxes in the arc attributes dialog for use as a trigger point.
The ''Trigger Point'' dialog is used to turn a feature point into a ZShape trigger point.  Enabling the ''Specify Trigger'' checkbox and giving the point a name will cause it to appear in the Point1 and Point2 selection boxes in the arc attributes dialog for use as a trigger point.


If renaming a trigger point that is being used by triggers, or deleting it by unchecking ''Specify Trigger'', SMS will notify the user that there are one or more arcs/polygons being updated with the new change.
If renaming a trigger point that is being used by triggers, or deleting it by unchecking ''Specify Trigger'', SMS will notify that there are one or more arcs/polygons being updated with the new change.


==Related Topics==
==Related Topics==
Line 58: Line 52:


[[Category:TUFLOW|Z]]
[[Category:TUFLOW|Z]]
[[Category:TUFLOW Dialogs]]
[[Category:TUFLOW Dialogs|Z]]

Latest revision as of 21:30, 14 July 2020

The TUFLOW ZShape coverage allows modifying terrain with arcs and setting up triggers to change those modifications, such as at a specific time during the simulation or when water depth exceeds a certain amount. An example application is a levee collapsing when flood water overtops it.

TUFLOW also supports polygon ZShapes. However, SMS does not support polygon ZShapes at this time. If needing to create static modifications to terrain using polygons, use the 2D Z Lines/Polygons (Simple) Coverage.

Failing Levee

The ZShape Coverage

The ZShape coverage is available under the models/TUFLOW folder. ZShape data is stored in a feature arc's attributes. The Z values of the feature arc's points determine its Z, not the Z of the arc itself (exceptions to this are explained in the Arc Properties Dialog section below).

ZShapes are split into two main categories, Static ZShapes and Variable ZShapes. Static ZShapes are simple terrain modifications that do not change over time. They can be used to create a levee, pit, sand bar, dam, etc. Variable ZShapes have a trigger that causes them to raise or lower the terrain during the simulation. Often a variable ZShape is combined with a static one to provide raised terrain for the trigger to modify. This is necessary because a variable z shape cannot raise the same area it intends to lower when its trigger activates -- it needs the terrain to already be there and cannot create it itself, only modify once its trigger activates.

Arc Properties Dialog

Z Shape Properties dialog

Arcs in a 2D Z Lines/Polygons (Advanced) coverage store ZShape data only if they are told to "override Z values". Otherwise they are not exported for TUFLOW's use. To reach the properties dialog, right-click on an arc and choose Attributes... Below is an explanation of the zshape options.

  • Override Z Values – ZShape data is only stored and exported if this checkbox is enabled. It tells TUFLOW to override the current terrain Z values with the new values from the arc.
  • Thickness – Arcs can be "Thin Lines", "Thick Lines", or "Wide Lines". Thin lines have a width of 0, thick lines have a thickness less than or equal to 1.5 times the 2D cell size, and wide lines are any width larger than that. Thin lines follow some special rules that affect other options in the dialog, such as Option and Trigger Type.
  • Option – The ZShape Options are All, Add, Min, Max, and Offset. Offset is only available for variable thin line Z Shapes, which cannot use the "Add", "Min" or "Max" options. "Add" is unavailable for any variable Z Shape.
    • Offset is not listed by the same name in the TUFLOW documentation and is an alias in SMS for not specifying "NO MERGE". This causes the points of the arc to not be written, and the Z of the arc is determined by the Offset field.
  • Offset – Raises the entire arc by this amount. Negative values are appropriate.
    • When offset is specified as the Option for variable thin lines, this field specifies the height to adjust terrain to (instead of adjusting it up or down by this amount) when triggered.
    • For all other variable arcs, this the the amount to adjust the terrain by when the trigger activates.
  • Change with Time – Toggles the arc between being a static zshape and a variable zshape. Variable z shapes use triggers to change terrain when a specific event occurs. All variable Z Shapes have the Duration option to span the change over a certain period of time. Other options will change with the trigger Type.
    • Trigger Type – The type of event that will trigger the Z modification.
      • "Specified time" – Triggers at a specific time during the simulation, measured in hours.
      • "Water level at point" – Uses a Trigger Point to measure water level, and triggers when the water level reaches or exceeds the value in the Water level field.
      • "Water level difference" – Uses two trigger points. Triggers when the difference between water levels measured at both points exceeds the value in Water level difference. A difference in either direction is treated the same in TUFLOW, and there is no need for negative numbers.
      • "Thin line water level" – Similar to Water level at point, but for thin lines. Does not use a trigger point, instead measuring the water levels on either side of the thin line.
      • "Thin line water level difference" – Triggers when the difference between water levels on either side of the thin line reaches or exceeds the value in water level difference.
    • Point1 and Point2 – Both point selection boxes list the trigger points available in the coverage. These fields are only enabled for trigger types that use them.
    • Specified time, Water level, Water level difference – These fields become available based on the trigger type selected.
    • Duration – If set to 0, changes are instantaneous once triggered. Otherwise the change will be interpolated over this many hours.
  • Restore Z Shape – This option can be used to have TUFLOW restore the original elevations at a specified time.
    • Repeat restoration – The z-shape will be restored indefinitely.
    • Restore interval – The time (hrs) between when the variable z-shape is finished and when to start restoring the points back to their original values.
    • Restore period – The time (hrs) needed to restore the points back to their original values.

Trigger Points

Trigger points are used by the "Water level at point" and "Water level difference" trigger types. Simply create a feature point and enter its attributes dialog to create a trigger point.

Trigger Point Dialog

Trigger Point Attributes dialog

The Trigger Point dialog is used to turn a feature point into a ZShape trigger point. Enabling the Specify Trigger checkbox and giving the point a name will cause it to appear in the Point1 and Point2 selection boxes in the arc attributes dialog for use as a trigger point.

If renaming a trigger point that is being used by triggers, or deleting it by unchecking Specify Trigger, SMS will notify that there are one or more arcs/polygons being updated with the new change.

Related Topics