ETS_CutFill

TIN Cut/Fill Analysis

Calculates the cut and fill areas for each polygon from a polygon feature class based on user assigned level or different levels for each polygon from a field in the attribute table and the surface defined by a TIN. If a single polygon has both cut and fill areas it is split into two or more polygons. The Volume and 3D area are calculated for each resulting polygon.

Inputs:

Input Polygon feature dataset.
Output polygon dataset.
Reference TIN dataset.
A String - the field name of the input polygon attribute table to be used for levels of the polygons.
A Double - the level for all input polygons (optional).

Outputs:

New Polygon feature dataset.

Notes:

If the optional Level value is specified, it will be used for the calculations and the Level Field parameter will be ignored.
When the Level field is used, any features with NULL values in the field will be ignored and will not exist in the output.
The following new fields will be added to the output polygon feature dataset.
- ET_ID - contains the feature ID of the original polygon.
- ET_Status - the classification of the polygon based on its Cut/Fill status.
- ET_Cut - the volume of the polygon with a Status = Cut.
- ET_Fill - the volume of a polygon with Status = Fill.
- ET_Area3D - 3D Area of the polygon.
- ET_Area - 2D Area of the polygon.
All attributes of the original polygons are preserved.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	PolygonCutFillTin
<input dataset>	A String representing the input polygon feature dataset.
<output dataset>	A String - the full name of the output polygon dataset.
<reference tin>	A String - the full name of the reference TIN dataset.
<level field>	A String indicating the field name of the input polygon attribute table to be used for levels of the polygons.
{Level}	A Double indicating the level for all input polygons (optional).

Running the function

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

Language	Syntax
Python	subprocess.call([ETSPath, "PolygonCutFillTin", "input dataset", "output dataset", "reference tin", "level field", "level"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "PolygonCutFillTin" "input dataset" "output dataset" "reference tin" "level field" "level"
.NET using ETSOutX.dll	PolygonCutFillTin(input dataset, output dataset, reference tin, level field, level)
ArcPy	arcpy.PolygonCutFillTin("input dataset", "output dataset", "reference tin", "level field", "level")

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)