GRID to GRID draft - Revision history

Anne.Kolega: /* Introduction */ The

2024-11-26T23:06:10Z

Introduction: The

← Older revision		Revision as of 09:06, 27 November 2024
Line 1:		Line 1:
	=Introduction=		=Introduction=
	grid_to_grid.exe is a utility that can be used to perform a range of operations on gridded files. The input grids can be a combination of GeoTIFF (.tif), ESRI ASCII (.asc), binary float (.flt) geopackage (.gpkg), NetCDF (.nc) and Cloud Optimised GeoTIFFs (.cog) grids, all of which can be input and output from TUFLOW and any of the format can be set as output from the utility.<br>		The grid_to_grid.exe is a utility that can be used to perform a range of operations on gridded files. The input grids can be a combination of GeoTIFF (.tif), ESRI ASCII (.asc), binary float (.flt) geopackage (.gpkg), NetCDF (.nc) and Cloud Optimised GeoTIFFs (.cog) grids, all of which can be input and output from TUFLOW and any of the format can be set as output from the utility.<br>
	For some options (such as processing maximums or differences) the input files must be of the same row/column dimensions.<br>		For some options (such as processing maximums or differences) the input files must be of the same row/column dimensions.<br>

Pavlina Monhartova: /* Remap */

2024-11-22T03:56:21Z

Remap

← Older revision		Revision as of 13:56, 22 November 2024
Line 472:		Line 472:
	:<tt>grid_to_grid.exe -remap -fb0.2 -bd20 -wl lowres_h.tif -dem DEM_highres.tif</tt>		:<tt>grid_to_grid.exe -remap -fb0.2 -bd20 -wl lowres_h.tif -dem DEM_highres.tif</tt>

	Note, 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>		Note, 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 <u>[[TUFLOW_Remapping \| TUFLOW Remapping Tool]]</u>.<br>

	=GPKG and NetCDF=		=GPKG and NetCDF=

Pavlina Monhartova: /* Remap */

2024-11-22T03:56:00Z

Remap

← Older revision		Revision as of 13:56, 22 November 2024
Line 461:		Line 461:

	==Remap==		==Remap==
		⚫	'''"-wl <wl_file> -dem <dem_file>"'''<br>
	Remaps a water level grid to a ~~higher~~ resolution DEM.<br>		Remaps coarser resolution water level grid to a finer resolution DEM.<br>
	'''"-wl <wl_file>"'''<br>
	Sets the coarser resolution water level grid to remap to a finer resolution DEM.<br>
⚫	'''"-dem <dem_file>"'''<br>
	The default interpolation method is TIN. But "-idw_npt<number of points>" flag can be used to change the interpolation method to IDW and set the number of points used for IDW interpolation (default is 12).<br>		The default interpolation method is TIN. But "-idw_npt<number of points>" flag can be used to change the interpolation method to IDW and set the number of points used for IDW interpolation (default is 12).<br>
	Example:		Example:
	*~~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>		*Remaps water level grid to the resolution of the DEM file:<br>
	:<tt>grid_to_grid.exe -remap -wl lowres_h.tif -dem DEM_highres.tif</tt>		:<tt>grid_to_grid.exe -remap -wl lowres_h.tif -dem DEM_highres.tif</tt>
	*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>		*The utility can also remap depth output grids to the resolution of the DEM file:<br>
	:<tt>grid_to_grid.exe -remap -wl lowres_h.tif -dem DEM_highres.tif ~~lowres_v.tif lowres_hazard~~.tif</tt>		:<tt>grid_to_grid.exe -remap -wl lowres_h.tif -dem DEM_highres.tif lowres_d.tif</tt>
			*The utility can also apply a buffer distance or add a freeboard. The below applies a buffer distance of 20m, and adds a freeboard of 0.2m to the original water level grid.<br>
	:<tt>grid_to_grid.exe -remap -fb0.2 -bd20 -wl lowres_h.tif -dem DEM_highres.tif</tt>		:<tt>grid_to_grid.exe -remap -fb0.2 -bd20 -wl lowres_h.tif -dem DEM_highres.tif</tt>

	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>		Note, 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>

	=GPKG and NetCDF=		=GPKG and NetCDF=

Pavlina Monhartova: /* Remap */

2024-11-22T01:46:49Z

Remap

← Older revision		Revision as of 11:46, 22 November 2024
Line 461:		Line 461:

	==Remap==		==Remap==
	~~Remap~~ a water level grid to a higher resolution DEM.<br>		Remaps a water level grid to a higher resolution DEM.<br>
	'''"-wl <wl_file>"'''<br>		'''"-wl <wl_file>"'''<br>
	Sets the coarser resolution water level grid to remap ~~from~~.<br>		Sets the coarser resolution water level grid to remap to a finer resolution DEM.<br>
	'''"-dem <dem_file>"'''<br>		'''"-dem <dem_file>"'''<br>
	Sets the finer resolution DEM.<br>
	The default interpolation method is TIN. But "-idw_npt<number of points>" flag can be used to change the interpolation method to IDW and set the number of points used for IDW interpolation (default is 12).<br>		The default interpolation method is TIN. But "-idw_npt<number of points>" flag can be used to change the interpolation method to IDW and set the number of points used for IDW interpolation (default is 12).<br>
	Example:		Example:
Line 475:		Line 474:

	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>		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>


	=GPKG and NetCDF=		=GPKG and NetCDF=

Pavlina Monhartova: /* Flood Extent */

2024-11-22T01:45:12Z

Flood Extent

← Older revision		Revision as of 11:45, 22 November 2024
Line 455:		Line 455:

	==Flood Extent==		==Flood Extent==
			'''"-fe"'''<br>
	Returns a simple grid with value of 1 where the input grid has an active, non-zero value.<br>		Returns a simple grid with value of 1 where the input grid has an active, non-zero value.<br>
	Example:		Example:

Pavlina Monhartova: /* "-statRank" */

2024-11-22T01:42:50Z

"-statRank"

← Older revision		Revision as of 11:42, 22 November 2024
Line 446:		Line 446:

	==="-statRank<integer id>"===		==="-statRank<integer id>"===
	The -statRank<integer> flag outputs the ''n<integer>'' ranked value at each grid cell from all the input grids. All the input grids are considered, regardless of if the grid cell is dry in some of the input grids (dry areas are still ranked as low e.g. Rank1, Rank2 and so on). For example, if the number of input grids is 10, at each grid cell the values are ranked lowest to highest (from 1 to 10). -statRank8 will output results taken from the 8th ranked grid. In this example, -statRank1 is equivalent to ''Min'', -statRank10 is equivalent to ''Max'', and -statRank6 is equivalent to ''Median''. The Rank flag allows additional functionality that lets users extract results in between those that are pre-programmed.		The -statRank<integer> flag outputs the n<integer> ranked value at each grid cell from all the input grids. All the input grids are considered, regardless of if the grid cell is dry in some of the input grids (dry areas are still ranked as low e.g. Rank1, Rank2 and so on). For example, if the number of input grids is 10, at each grid cell the values are ranked lowest to highest (from 1 to 10). -statRank8 will output results taken from the 8th ranked grid. In this example, -statRank1 is equivalent to Min, -statRank10 is equivalent to Max, and -statRank6 is equivalent to Median. The Rank flag allows additional functionality that lets users extract results in between those that are pre-programmed.

	The utility outputs two grids:		The utility outputs two grids:

Pavlina Monhartova: /* "-statMin" */

2024-11-22T01:41:36Z

"-statMin"

← Older revision		Revision as of 11:41, 22 November 2024
Line 418:		Line 418:

	==="-statMin"===		==="-statMin"===
	The -statMin flag outputs the minimum value at each grid cell from all the input grids.		The -statMin flag outputs the minimum value at each grid cell from all the input grids. This flag is analogous with the [[#Minimum\|-Min]] operation flag.

	The utility outputs two grids:		The utility outputs two grids:

Pavlina Monhartova: /* "-statFrac" */

2024-11-22T01:40:35Z

"-statFrac"

← Older revision		Revision as of 11:40, 22 November 2024
Line 413:		Line 413:

	The utility outputs one grid:		The utility outputs one grid:
	* A Frac grid: the resulting ~~Fraction~~ value<br>		* A Frac grid: the resulting fraction value<br>
	Example:		Example:
	<tt>grid_to_grid.exe -statFrac Q100_30min__h.tif</tt><br>		<tt>grid_to_grid.exe -statFrac Q100_30min__h.tif</tt><br>

Pavlina Monhartova: /* "-statMedian" */

2024-11-22T01:35:22Z

"-statMedian"

← Older revision		Revision as of 11:35, 22 November 2024
Line 393:		Line 393:
	* 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>		* 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:		Example:
	*<tt>grid_to_grid.exe -statMedian Q100_30min_TP1_h.tif Q100_30min_TP2_h.tif Q100_30min_TP3_h.tif Q100_30min_TP4_h.tif ~~Q100_30min_TP5_h~~.tif </tt><br>		*<tt>grid_to_grid.exe -statMedian Q100_30min_TP1_h.tif Q100_30min_TP2_h.tif Q100_30min_TP3_h.tif Q100_30min_TP4_h.tif ... Q100_30min_TP10_h.tif </tt><br>

	[[File: asc_to_asc_statsMedian_eg.PNG\|1000px\|]]<br>		[[File: asc_to_asc_statsMedian_eg.PNG\|1000px\|]]<br>
	<br>		<br>
	Note, the median value for ~~that~~ ~~cell~~ ~~was~~ ~~dry~~ (a 'NULL') value, ~~then~~ the output ~~would~~ be dry. ~~For example,~~ 7 out of the 10 inputs are dry at a particular ~~location~~. Once ~~they~~ are ordered ~~them~~ (with NULL showing at the lowest), ~~then~~ the median value for ~~this~~ cell is 'NULL' (dry) ~~and the source would be 8, as shown below. Therefore, at this location you would see a dry cell in the median output,~~ and '8' in the source grid output.		Note, the median value for the example below is a 'NULL' value, the output is a dry cell. 7 out of the 10 inputs are dry at this particular cell. Once the outputs are ordered (with NULL showing at the lowest spots), the median (6th) value for the cell is 'NULL' (dry) and '8' is the source grid output.
	<br>		<br>
	[[File:A2A median.png\|400px]]<br>		[[File:A2A median.png\|400px]]<br>

Pavlina Monhartova: /* Extract 1D Nodal Area Tables from Grid */

2024-11-22T01:11:55Z

Extract 1D Nodal Area Tables from Grid

← Older revision		Revision as of 11:11, 22 November 2024
Line 357:		Line 357:
	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>		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:		Example:
	*<tt>grid_to_grid.exe -na ~~1d_na_storage_R~~.shp DEM_1m.tif</tt>		*<tt>grid_to_grid.exe -na storage_R.shp DEM_1m.tif</tt>

	==Calibration Points==		==Calibration Points==