Cost Distance - Costs from Source

Open Table of Contents ToolBox Implementation
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 cells of the cost raster. The NODATA values in the cost raster are considered prohibitive cost.

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:

  • A point feature class (Sources).
  • A Cost raster
  • Cutoff cost - the value of the cells with larger than this cost (distance x weight) to reach will be set to NODATA

Outputs:

  • A floating point raster. Each cell will have as a value the minimum cost to be reached from one of the sources.
    • The extent of the output is equal to the extent of the input cost raster.
    • The cell size of the output is equal to the cell size of the input cost raster.

Examples:
 

Source points

Cost Raster - Slope raster of digital terrain model used in the example.

The result of the Cost Distance function
The result of the Cost Distance function over the zones derived with the Cost Allocation function

Notes:

  • Initially the name of the output raster defines the raster format
    • no extension specified - ESRI binary GRID
    • .img extension (for example raster1.img) - ERDAS IMAGINE image.
    • .tif extension (for example raster1.tif - Tagged Image File Format (TIFF) image.
  • The initial output raster format can be changed by selecting the desired output in the dialog.
  • Currently only file based rasters are supported. Rasters cannot be stored in a GeoDatabase. After you get the desired result, you can export the raster to a GeoDatabase using the standard ArcGIS tools.
  • The input feature class and cost raster must be in the same projected coordinate system.

ToolBox implementation

Command line syntax

ETS_GPCostDistanceRaster <Input Points> <Cost Raster>  <Out Raster> {Cut Off Cost}

Parameters

Expression Explanation
<Input Points> A Point layer feature class
<Cost Raster> A Raster dataset or Raster layer
<Out Raster> A String - the full name of the output raster (A raster with the same full name should not exist). The output raster type depends on the extension of the output file(see Notes above)
{Cut Off Cost} 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

Scripting syntax

ETS_GPCostDistanceRaster (Input Points, Cost Raster, Out Raster, Cut Off Cost)

See the explanations above:
<> - required parameter
{} - optional parameter

 

All ESRI products mentioned are trademarks of Environmental Systems Research Institute, Inc.
Copyright: Ianko Tchoukanski