The Determine Travel Cost Path As Polyline tool produces an output feature of least-cost paths from sources to destinations.
When the source or the destination input is an image service, cells that are not sources or destinations must have the value NoData. Any cells in either of these inputs that have a value, including zero, will be used as valid sources or destinations.
The input cost surface cannot have any zero values or negative values.

Syntax

Parameter	Explanation
inputSourceRasterOrFeatures	An image service or feature service that identifies the cells from which the least-cost path is determined to the destinations. If the input is an image service, the input consists of cells that have valid values (zero is a valid value), and the remaining cells must be assigned NoData.
inputCostRaster	The name of a cost raster image service to be used to determine the least-cost path from the sources to the destinations. The value at each cell location represents the cost-per-unit distance for moving through the cell. Each cell location value is multiplied by the cell resolution while also compensating for diagonal movement to obtain the total cost of passing through the cell. The values of the cost raster can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).
inputDestinationRasterOrFeatures	An image service or feature service that identifies the cells to which the least-cost path is calculated.
outputPolylineName	The name of the output polyline feature service. The polyline feature service of the optimum (least-cost) paths connecting sources and destinations. Each path (or line) is uniquely numbered, and has an additional field in the attribute table called DestID, which connects it back to the unique identifier on the destination raster. Since each path is represented by a unique line, there can be multiple lines in locations where paths travel the same route.
pathType (Optional)	Specifies the manner in which the values and zones on the input destination data will be interpreted in the cost path calculations. To each cell—For each cell or location with valid values on the input destination data, a least-cost path is determined and saved on the output. With this option, each cell or location of the input destination data is treated separately, and a least-cost path is determined for each from cell. To each zone—For each zone on the input destination data, a least-cost path is determined and saved to the output. With this option, the least-cost path for each zone begins at the location with the lowest cost distance weighting in the zone. Best single—For all locations on the input destination data, the least-cost path is derived from the location with the minimum of the least-cost paths to source locations. This is the default.
destinationField (Optional)	The field used to obtain values for the destination locations. Input feature data must contain at least one valid integer field.

Code Samples

#-------------------------------------------------------------------------------
# Name: DetermineTravelCostPathAsPolyline_Ex_02.py
# Description: Calculates the optimum travel cost path.
# Requirements: ArcGIS Image Server

# Import system modules
import arcpy

# Set local variables
inputSourceLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/sources/ImageServer'
inputCostLayer =
    'https://MyPortal.esri.com/server/rest/services/Hosted/costraster/ImageServer'
inputDestinationLayer = 
    'https://MyPortal.esri.com/server/rest/services/Hosted/destinationras/ImageServer'
outputName = 'outTravelPaths'
pathType = 'BEST_SINGLE'

arcpy.DetermineTravelCostPathAsPolyline_ra(inputSourceLayer, inputCostLayer,
                                           inputDestinationLayer, outputName, pathType)

Determine Travel Cost Path As Polyline (Raster Analysis)

Title Determine Travel Cost Path As Polyline (Raster Analysis)

Summary

Illustration

Usage

Syntax

Code Samples

Tags

Credits

Use limitations