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