ETG_AggregateRaster

Aggregate Raster

Derives a new raster with reduced resolution from the original raster. The resolution is defined by the Cell Factor The values of the cells of the output raster are calculated from the input cells using a user defined method - SUM, MIN, MAX, Mean or Median.

Inputs:

Input raster dataset
Output raster name and format
Cell Factor - The value by which to multiply the cell size of the original raster. If for examnple the cell size of the input raster is 5 and the Cell Factor = 3, the cell size of the output raster will be 15
Aggregation type.
- Sum - the sum of the cell values within the neighborhood
- Min - the minimum values within the neighborhood
- Max- the maximum value within the neighborhood
- Mean - the average of the values within the neighborhood
- Median - the median value in the neighborhood
Extent Handling Type.
- Expand - Expands the bottom and right extents of the output raster
- Truncate - Reduces the number of rows and columns. The extent of the output will be entirely inside of the extents of the input raster
Idicates how the NoData values will be handled for calculating the values of the output cells. If true, the cells with NoData value will be ignored when calculating the values of the output calls. If false then if within the output cell there is a cell with NoData value, then the value of the output cell will be NoData.

Outputs:

A raster with type depending on the type of the input raster and the type of aggregation performed.
- Floating point input raster - Floating point output
- Integer input raster
  - MEAN - Floating point output
  - Any other type statistics - Integer output

Notes:

The input format accepted are file based rasters - ERDAS IMAGINE or Tagged Image File Format (TIFF).
The Python ToolBox for ArcGIS Desktop and ArcGIS Pro accepts also FileGDB Raster and ESRI GRID inputs.
For file based rasters initially the name of the output raster define the raster format:
- .img extension (for example raster1.img) - ERDAS IMAGINE image.
- .tif extension (for example raster1.tif - image.
- The initial output raster format can be changed by selecting the desired output in the dialog.

Example:

Original Raster
After Aggregate function with Cell Factor = 3 and Aggregation = SUM. In the backgrounds are the values of the original cells.
After Aggregate function with Cell Factor = 3 and Aggregation = MAX

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	AggegateRaster
<InputRaster>	A String - full path to the input raster dataset.
<OutputRaster>	A String - full path to the output raster dataset.
<cellFactor>	An integer - The value by which to multiply the cell size of the original raster.
{aggregationType}	A String - the type of the statistics to be calculated. Valid values: Sum - the sum of the cell values within the neighborhood Min - the minimum values within the neighborhood Max- the maximum value within the neighborhood Mean - the average of the values within the neighborhood Median - the median value in the neighborhood
{extentHandlingType}	A String - indicates how the extent of the output raster will be handled. Valid values: Expand - Expands the bottom and right extents of the output raster Truncate - Reduces the number of rows and columns. The extent of the output will be entirely inside of the extents of the input raster
{ignoreNoData}	A Boolean idicating how the cells with NoData values in the input will be handled.

Running the function

ETSPath used in the table below is the full path to ETSRun.exe (E.G. "C:\Program Files\ETSpatial Techniques\ETSurface\ETSRun.exe")

InputRaster

Language	Syntax
Python	subprocess.call([ETSPath, "AggegateRaster", "InputRaster", "OutputRaster", "cellFactor", "aggregationType", "extentHandlingType", "ignoreNoData"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "AggegateRaster" "InputRaster" "OutputRaster" "cellFactor" "aggregationType" "extentHandlingType" "ignoreNoData"
.NET using ETSOutX.dll	AggegateRaster(InputRaster, OutputRaster, cellFactor, aggregationType, extentHandlingType, ignoreNoData)
ArcPy	arcpy.AggegateRaster("InputRaster", "OutputRaster", "cellFactor", "aggregationType", "extentHandlingType", "ignoreNoData")

Notes:

<> - required parameter
{} - optional parameter
See examples for Python , .NET or ArcPy
The argument separator for StartInfo.Arguments is space. If a string might contain a space, you need to double quote it.

(Go to TOP)