ETG_RasterPlane

Create Raster Plane

Creates a floating raster with values representing a tilted plane based on a known point on the plane, slope and azimuth. The extent can be imported from an existing feature dataset, raster or TIN.

Inputs:

Output raster name and format.
X coordinate of a known point on the plane.
Y coordinate of a known point on the plane.
Z value of a known point on the plane.
Slope of the plane in degrees (0 - 90).
Azimuth of the plane in degrees (0 - 360).
Cell Size of the output raster.
Reference dataset (feature, raster or TIN). The reference dataset will be used for assigning of spatial reference and extent of the output raster.
Custom extent for the output raster (optional) - X min, X max, Y min, Y max.

Outputs:

A floating point raster.

Notes:

The known point does not have to be in the extent of the created raster.
Azimuth values are in degrees rotating clockwise - 0 degrees - North, 90 degrees - East, 180 degrees - South, 270 degrees - West.
Slope values are in degrees from 0 to 90. A value of 0 will create a horizontal plane (all cells will have the same value). Higher slope values will result in cell values declining in the direction of the azimuth (for example with azimuth of 0 the lower cell values will be to the North and higher cell values to the South).
If custom extent is specified, the output raster will be created with it.
When custom extent is not specified, the output raster will have the extent of the reference dataset.
The spatial reference of the output raster will be the same as the spatial reference of the reference dataset.
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.
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) - TIFF image.
- The initial output raster format can be changed by selecting the desired output in the dialog.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	CreateRasterPlane
<output raster>	A String - the full name of the output raster.
<x coordinate>	A Double representing the X coordinate of the known point.
<y coordinate>	A Double representing the Y coordinate of the known point.
<z value>	A Double representing the Z value of the known point.
<slope>	A Double representing the slope of the plane in degrees (0.0 - 90.0).
<azimuth>	A Double representing the azimuth of the plane in degrees (0.0 - 360.0).
<cell size>	A Double representing the cell size.
<reference dataset>	A String - the full path to the reference dataset.
{MinX}	A Double - minimum X of the custom extent.
{MaxX}	A Double - maximum X of the custom extent.
{MinY}	A Double - minimum Y of the custom extent.
{MinX}	A Double - maximum Y of the custom extent.

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

Language	Syntax
Python	subprocess.call([ETSPath, "CreateRasterPlane", "output raster", "x coordinate", "y coordinate", "z value", "slope", "azimuth", "cell size", "reference dataset", "MinX", "MaxX", "MinY", "MaxY"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "CreateRasterPlane" "output raster" "x coordinate" "y coordinate" "z value" "slope" "azimuth" "cell size" "reference dataset" "MinX" "MaxX" "MinY" "MaxY"
.NET using ETSOutX.dll	CreateRasterPlane(output raster, x coordinate, y coordinate, z value, slope, azimuth, maximum value, cell size, reference dataset, MinX, MaxX, MinY, MaxY)
ArcPy	arcpy.CreateRasterPlane("output raster", "x coordinate", "y coordinate", "z value", "slope", "azimuth", "cell size", "reference dataset", "MinX", "MaxX", "MinY", "MaxY")

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)