ETG_FeaturesToRaster

Features to Raster

Converts features (Points, Polylines, Polygons) to a raster dataset.

A feature dataset (Point, Polyline, Polygon).
Output raster name and format.
Cell Size of the output raster.
Value field - a field from the attribute table to be used as a source for the values of the raster. If the input is of PointZ or PolylineZ type, the Z values of the features can be used as source for the raster values. In this case the parameter should be "Shape". "Shape" is not a valid option for Polygon datasets, because polygons vertices may not lie in a single plane and values inside can not be interpolated consistently.
Priority field (optional) - a field from the attribute table which values define how the values will be stored in the raster in case two or more features cover the same cell. If for example two overlapping polygons are converted to a raster, the polygon with the larger value in this field will be stored in the raster.
For a polyline layer only - rasterize the polyline including all cells touched if TRUE is specified (optional).
Extent from existing dataset (optional). If selected the extent of an existing dataset (Feature, Raster, TIN) will be used for the output, otherwise the extent of the input feature class will be used.

A raster with data type depending on the input value field. If the field is Integer the result will be integer, if the field is Double, the result will be a floating point raster.

Source polygons

Result Raster

The spatial reference of the output raster will be the same as the spatial reference of the input features.
When reference dataset is specified, the output raster will have the extent of the reference dataset. If the reference dataset is with a different spatial reference, its extent will be reprojected to the spatial reference of the input 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.

Parameters

Expression	Explanation
Function Name	FeaturesToRaster
<input dataset>	A String representing the input dataset.
<output raster>	A String - the full name of the output raster.
<cell size>	A Double representing the cell size.
<value field>	A String representing the name of the field which values are going to be used for Z values.
{priority field}	A String representing the name of the field which values are going to be used define the priority of the features. See explanations above.
{thick Line}	For polylines only - if True will include all cells touched by the polyline.
{reference dataset}	A String - the full path to the reference dataset.

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, "FeaturesToRaster", "input dataset", "output raster", "cell size", "value field", "priority field", "thick line", "reference dataset"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "FeaturesToRaster" "input dataset" "output raster" "cell size" "value field" "priority field" "thick line" "reference dataset"
.NET using ETSOutX.dll	FeaturesToRaster(input dataset, output raster, cell size, value field, priority field, thick line, reference dataset)
ArcPy	arcpy.FeaturesToRaster("input dataset", "output raster", "cell size", "value field", "priority field", "thick line", "reference dataset")

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.