ETG_CostDistanceSource

Cost Distance - Costs from Source

Calculates for each cell of the output raster the least cost to reach one of the sources of the input point feature class. The cost is calculated as distance from the cell to the source multiplied by the weight of the source. The smaller the weight value of a source is, the greater the influence of the source is.

The performance of the function depends very much on the difference between the smallest and largest weights. The larger this difference is, the slower the function will be.

Inputs:

Input point feature dataset - Sources
Output raster name and format
The cell size of the output raster.
Weight field. Any numeric field (integer or double) can be used as a weight field.
Cutoff cost - cells with larger than this cost (distance x weight) to reach will not be allocated to any source.

Outputs:

A floating point raster. Each cell will have as a value the minimum cost to be reached from one of the sources.

Example:

Points (Sources) labeled with their weights.

Notes:

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.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	CostDistanceSource
<InputFeatures>	A String - the full path to the input feature dataset.
<output raster>	A String - the full name of the output raster.
<CellSize>	A Double representing the cell size of the output raster.
<WeightField>	A String representing the name of the field in the input point feature class that are going to be used as weights.
<CutOff>	A Double representing the cut off cost - the value of the cells with larger than this cost (distance x weight) to reach will be set to NODATA.

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

CellSize

Language	Syntax
Python	subprocess.call([ETSPath, "CostDistanceSource", "InputFeatures", "output raster", "CellSize", "WeightField", "CutOff"])
.NET using ETSRun.exe	StartInfo.FileName = ETSPath StartInfo.Arguments = "CostDistanceSource" "InputFeatures" "output raster" "CellSize" "WeightField" "CutOff"
.NET using ETSOutX.dll	CostDistanceSource(InputFeatures, output raster, CellSize, WeightField, CutOff)
ArcPy	arcpy.CostDistanceSource("InputFeatures", "output raster", "CellSize", "WeightField", "CutOff")

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)