Jump to content
TUFLOW Forum
Nicola

Gauge Outputs

Recommended Posts

In the 2011 TUFLOW workshops, a new .tgc command "Read GIS Gauge Output" was discussed and apparently available from Build 2011-09-AA.  As far as I know this hasn't been documented anywhere in subsequent release notes.  Is this feature available and is there any documentation for it at present? Thanks very much.

Share this post


Link to post
Share on other sites

Hi Nicola

 

Below is a description of the feature that will hopefully head you in the right direction.  There was a minor bug fix last year, so you should run with Build 2012-05-AB or later to include this fix.  FYI, we're updating the TUFLOW Manual for the next TUFLOW release in May 2013, so this feature will be in the next manual.

 

Cheers

Bill

 

Gauge Level Output Feature Description:

 

A GIS layer of, for example, properties or building outlines, is read by TUFLOW using the .tgc command “Read GIS Gauge Output == <gis_layer>”.  The objects can be points and/or polygons.  At present up to 20 different layers may be read in by repeating this command (let us know if you want to input more than 20 layers!).  Also, only the .mif/.mid format is currently supported, so if using .shp layers you'll need to export the layer to the .mif format.

 

At the end of the simulation TUFLOW outputs the layer(s) with a _GO extension to the results folder with the following additional attributes:

  1. Trigger_Level:  The level at the property/building/object used to register when first inundated.  The level will be either the first attribute in the GIS layer (typically either the ground level of the property or the floor level of the building), or the lowest ZC value within the property or building polygon if the “USE ZC” option is specified (ie. Read GIS Gauge Output USE ZC == ...).
  2. Time:  The simulation time when the water level first reaches the Trigger_Level.
  3. <Gauge 1>:  The water level at <Gauge 1> when the water level first reaches the Trigger_Level.
  4. <Gauge 2>:  The water level at <Gauge 2> .....
  5. and so on...

Gauges are defined as points in 2d_po layer(s) using the new “G_” PO type.  G_ PO's are treated the same as H_ except they are additionally used for the above purpose.

 

In addition, the “Read GIS Zpts” and “Read GIS Gauge Output” commands can be merged as one in the event you also want TUFLOW to adjust the Zpts within the polygon or whole cell at a point object (eg. to set the Zpts to the house floor/pad level).  The command in this case would be “Read GIS Zpt Gauge Output == ...”.  In this case, the first attribute is used to set the value of the Zpts within each polygon.  If there is a second attribute, this is used to define the level for monitoring when first inundated, otherwise the first attribute is used.

 

This output provides a great opportunity to easily link the flood level at gauges with the time of first inundation at properties, buildings and other infrastructure, thereby making a gauge level forecast during a flood much more useful. 

 

Below is an image showing when buildings were first inundated at different gauge heights.  For example, those shown yellow were inundated when the gauge was between 6 and 6.5 metres.

 

Example of GIS Mapping using the Gauge Output Feature:  post-2-0-22231400-1360302341_thumb.jpg

Share this post


Link to post
Share on other sites

Hi Bill

I've been using Gauge Outputs in version 2011-09-AF. Very useful! Just wondering if the minor bug fix in Build 2012-05-AB will have any implications?

Thanks

Laura

Share this post


Link to post
Share on other sites

Hello!

 

I've trying to use Gauge tool and it doesn't work. The model run correclty, but when it is writting the results it crashes, with a window dialog saying forrtl:severe (68): variable format expression value error, unit 906, file \\..........2d_g_po_buildings_003.mid.

 

I guess the problem is the file input formal, right now it has polygons and I've tryied different options: using numbers in the first colum, using the flag G_, using "Read GIS Gauge Output" and "read GIS Gauge Output USE ZC", none of them works. 

 

Any idea?

 

Thanks,

 

Aram

Share this post


Link to post
Share on other sites

Hi Avidal,

 

Apologies for the slow response!

 

Are you able to email the log file and gauge input files to support@tuflow.com and we can investigate.

 

Regards

Phil

Share this post


Link to post
Share on other sites

Further to the above, we have had a number of users asking for a example.

 

A version of the tutorial model is here:Gauge_Output.zip

 

There are two GIS layers inputs:

  • A layer of points in the 2d_po format with the Type set to “G_” for the gauge locations (there can be multiple).  This should also have a unique label (i.e. the gauge name).  a 2d_po layer which contains the gauges.
  •  A layer of points of polygons for the buildings.

If using the “Read GIS Gauge Output” the polygons only require one attribute.  This is the level that the building is considered inundated, e.g. the floor level, this should be a float (numeric) type field.
If using “Read GIS Zpt Gauge Output” the first attribute set the elevations in the model.  The second attribute sets the inundated level (e.g. 11.0, 11.5 would set the building level to 11.0m and the building is considered inundated at 11.5 or a depth of 0.5m).  If there is only one attribute the ground level and the inundation level are the same.
If using “Read GIS Gauge Output USE ZC” the lowest elevation inside the polygon is used for setting the inundation level.

The 2d_po is read in the usual manner (Read GIS PO == in the .tcf).  For the locations you are tying back to the gauge, these are read into the .tgc with “Read GIS Gauge Output == “.  If you also want to use these to modify the elevations in the you will need to use “Read GIS Zpt Gauge Output”.

When the model is simulated you will get two output layers, in this case 2d_go_buildings_001_GO.mif and 2d_go_buildings_001_GOp.mif.  The first contains the results on the original input type, e.g. polygons in the input are polygons in the output.  For the 2d_go_buildings_001_GOp.mif all input locations are converted to points.

 

Please let us know if you have any queries.
 

Share this post


Link to post
Share on other sites

Please note that this command has been renamed "Read GIS Objects RECORD GAUGE DATA ==" for the 2016 TUFLOW release (you can also use "Read GIS Receptors RECORD GAUGE DATA ==").  The "USE ZC" and "ZPTS" options also remain available.  The feature is essentially the same and now supports .shp format for the GIS layer written by TUFLOW.  The main change, needed to accommodate the .shp format, is that all objects/receptors are output as point objects in one layer (irrespective of the number of input layers).  For regions the point is located at the region's centroid. This feature is now documented in the 2016 TUFLOW Manual.

Cheers
Bill

Share this post


Link to post
Share on other sites

Join the conversation

You can post now and register later. If you have an account, sign in now to post with your account.

Guest
Reply to this topic...

×   Pasted as rich text.   Paste as plain text instead

  Only 75 emoji are allowed.

×   Your link has been automatically embedded.   Display as a link instead

×   Your previous content has been restored.   Clear editor

×   You cannot paste images directly. Upload or insert images from URL.


×
×
  • Create New...