GRID to GRID draft: Difference between revisions

=Introduction=

This utility is useful for comparing and processing TUFLOW outputs from different .2dm meshes, which can't be compared with the <u>[[RES_to_RES| res_to_res.exe]]</u>.<br>

For some options (such as processing maximums or differences) the input (.asc or .flt) files must be of the same row/column dimensions.<br>

===GPKG and NetCDF===

GeoPackage and NetCDF are database formats and are able to contain multiple layers in a single file. When passing in an input or output reference to a GeoPackage or NetCDF file the layer name is assumed to be the same as the database name unless otherwise specified. To give the layer a different name than the database, use the following syntax <tt>"database.ext >> layer"</tt>:<Br>

''<b>Note:</b>''

* ''quotes will always be required when using this syntax''

Multiple creation options can be used (each will require its own -co flag).<Br>

<Br>

====GeoTIFF====

* COMPRESS=NONE/DEFLATE/LZW - output compression. Default - DEFLATE

* BIGTIFF=YES/NO/IF_NEEDED - Controls whether the ouput file uses the BigTIFF format or classic TIFF. Default - IF_NEEDED.

* TILED=YES/NO - Controls whether the output GeoTIFF should use tiles or strips. Default - NO.

 

====Cloud Optimised GeoTIFF (COG)====

===Examples===

*Runs a difference operation on GeoTIFF outputs.<br>

* Runs a difference operation on GPKG outputs. The layer name needed is assumed to be the same as the database name.<br>

* Runs a difference operation on GeoPackage outputs where the layer name is different than the database name.<br>

* Converts an ASC grid to a GeoTIFF with an LZW compression and horizontal predictor.<br>

* Runs a maximum operation on all FLT grids in a given location and outputs to a GeoPackage raster.<br>

* Converts GeoTIFF to a Cloud Optimised GeoTIFF. Requires <tt>-out</tt> flag since the extension for COG is also '.tif' and therefore the default output file would be the same as the input file.<br>

 

=Operations=

Examples:<br>

*Converts all .flt grids to .asc format.<br>

*Converts the file "DEM_M01.asc" for .flt format.<br>

 

==Maximum==

Examples:<br>

*Creates a new grid containing the maximum of the 3 input water level grids.<br>

*As per item 2 above, but specifies the output name "Q100_Max_Levels.asc".<br>

*Wildcard character "*" is supported in filenames.<br>

 

==Difference==

'''"-dif"'''<br>

Two .asc grids are output:

*The first is the difference values between the two .asc files. A difference value only occurs at grid cells that have a value in both grids. If the cell has a null value (ie. the TUFLOW output was dry at that location) in either or both .asc grids, a null value is output.

Example:

*Creates new grids comparing the differences in flood levels and extents for: "difference.asc" = "after_h.asc" - "before_h.asc"<br>

 

Secondary options (only one can be used):

Examples:

*Creates a new depth grid only where the depth is greater than 0.1m.<br>

*Creates a new level grid only where the depth is greater than 0.1m.<br>

*As per the example above, but sets the output name as "filtered_levels.asc".<br>

 

==Resize==

Example:

*Creates a new 10m DEM (DEM_10m.asc) based on the the 2m DEM using an averaging approach.<br>

 

===Minimum===

Example:

*Creates a new 10m DEM (DEM_10m_min.asc) based on the the 2m DEM using an minimum approach.<br>

 

===Maximum===

Example:

*Creates a new 10m DEM (DEM_10m_max.asc) based on the the 2m DEM using an maximum approach.<br>

 

==Transform==

Examples:

*Multiplies all values by 0.3048.<br>

*Multiplies all values by 0.3048 and then adds 10.0.<br>

 

==Decimal==

Example:

*Converts all .flt grids to .asc format with 5 decimal spaces.<br>

 

==Classify==

Examples:

*Outputs a classified grid, based on the cut off values and names in the "classifications.csv".<br>

*If using vertical mapper the -grc option can be used to create the .asc file in classified grid format, in this format rather than storing a numerical value when interrogating an area a label is returned. This format is not recognised by ArcMap or QGIS. If using the grc option it is also possible to specify the desired RGB (red, green, blue) values for the output grid in the .csv file used for the classification. The RGB values should be specified in the 3-5th columns of the .csv file.<br>

 

:{| class="wikitable"

'''NOTE:''' For the output GIS file, the '''dz''' attribute is set to 0.0 regardless of the value set in the input field. <br>

Example:

 

==Fuzzy Map==

Example:

*Create a fuzzy map from all maximum depth grids in the directory.<br>

 

==Histogram==

|}

*Example usage:

 

==Extract 1D Model Inputs==

|}

Example usage:

 

An example .egc file is:<br>

The out nodal area table extends from the minimum to the maximum elevation in the DEM. A user defined minimum value can be specified using the "Skew" attribute of the GIS region.<br>

Example usage:

 

==Calibration Points==

The second search radius used to search for maximum and minimum values in meters.<br>

Example usage:

 

==Statistics==

<big>'''"-stat<type>"'''</big>

 

The available options are:

* An SRC grid: a grid listing which source input grid the median result value came from (a corresponding .csv file is also written as a legend)<br>

Example usage:

 

[[File: asc_to_asc_statsMedian_eg.PNG|1000px|]]<br>

* An SRC grid: a grid listing which source input grid the result value came from or was the next above (a corresponding .csv file is also written as a legend)<br>

Example usage:

 

==="-statFrac"===

* A Frac grid: the resulting Fraction value<br>

Example usage:

 

==="-statMin"===

* An SRC grid: a grid listing which source input grid the minimum result value came from (a corresponding .csv file is also written as a legend)<br>

Example usage:

 

==="-statMax"===

* An SRC grid: a grid listing which source input grid the maximum result value came from (a corresponding .csv file is also written as a legend)<br>

Example usage:

 

==="-statAll"===

* A .csv file that contains the legend for all SRC grids<br>

Example usage:

 

==="-statRank<integer id>"===

* An SRC grid: a grid listing which source input grid the ranked result value came from (a corresponding .csv file is also written as a legend)<br>

Example usage:

 

==Flood Extent==

Returns a simple grid with value of 1 where the input grid has an active, non-zero value.<br>

Example usage:

 

==Remap==

Examples:

*The utility can also remap additional map output grids (e.g. velocity, hazard and others) to the resolution of the DEM file, e.g.<br>

*The utility can also apply a buffer distance or add freeboard. For example, the below applies a buffer distance of 20m, and adds a freeboard of 0.2m to the original water level grid.<br>

 

Note that, for any output types other than depth, this utility does NOT interpolate the result from the coarser grid to the finer grid, but only extends/reduces the output extent to the dry/wet extent. More discussions on this function is documented here [[TUFLOW_Remapping | TUFLOW Remapping Tool]].<br>

! style="background-color:#005581; font-weight:bold; color:white;" width=80% | Description

|-

|-

|"-out <output grid name>"||Specify the output filename for the new grid. <br> '''Note:''' a space is required between the -out and the filename.