ETG_RasterCutFillPolygons

Cut/Fill Analysis

Calculates the cut and fill areas for each polygon from a polygon feature class based on levels for each polygon from a field in the attribute table and the surface defined by a raster.

Inputs:

Input raster dataset representing the surface for which the analysis will be performed.
Output raster name and format
A polygon dataset.
A field from the attribute table containing the level information for each polygon.

Outputs:

An integer raster with values assigned to each zone derived from the input surface raster and the polygons at their levels.
The raster attribute table will contain the following fields
- Value - the zone ID
- ET_Volume - the volume of the zone in the units of the spatial reference of the input raster.
  - Negative values of the volume indicate areas where the Z values of the raster surface is above the level of the polygons - CUT.
  - Positive values of the volume indicate areas where the Z values of the surface is below the levels of the polygons. - FILL
- ET_Area - the area of the zone in the units of the spatial reference of the input raster
- ET_Status - Cut or Fill

Example:

The result of the Cut/Fill function overlaid with the elevation raster.

red areas indicate FILL
green areas indicate CUT

Notes:

The input feature class and raster must have the same projected coordinate system.
If the input polygon feature class has overlapping polygons, the maximum level in the area of overlap will be used.
The areas not covered by polygons will have assigned NODATA values
The polygons or parts of them that are outside of the extents of the input raster will be ignored.
The cells of the input raster that have the same value as the levels of the polygons will have assigned NODATA values
The input format accepted are file based rasters - ERDAS IMAGINE or Tagged Image File Format (TIFF).
The .NET ToolBox for ArcGIS Desktop accepts also FileGDB Raster inputs.
The smooth polylines option might be time consuming.
The input raster must have a projected coordinate system.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	RasterViewshed
<input raster>	A String representing the input raster dataset.
<output raster>	A String - the full name of the output raster.
<PolygonLayer>	A String - full path to the polygon layer to be used.
{LevelField}	A String representing the name of the field which values are going to be used as level of the input polygons.

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

PolygonLayer

Language	Syntax
Python	subprocess.call([ETSPath, "RasterViewshed", "input raster", "output raster", "PolygonLayer", "LevelField"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "RasterViewshed" "input raster" "output raster" "PolygonLayer" "LevelField"
.NET using ETSOutX.dll	RasterViewshed(input raster, output raster, PolygonLayer, LevelField)
ArcPy	arcpy.RasterViewshed("input raster", "output raster", "PolygonLayer", "LevelField")

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)