com.esri.arcgis.spatialanalyst
Interface IDistanceOp

All Superinterfaces:
Serializable
All Known Implementing Classes:
RasterDistanceOp

public interface IDistanceOp
extends Serializable

Provides access to members that control the distance operations.

Superseded By

IDistanceOp2

Remarks

  • Read the Working with ArcGIS Spatial Analyst objects technical document for general information on implementing Spatial Analyst operations.
  • Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux


    Method Summary
     IGeoDataset corridor(IGeoDataset distance1, IGeoDataset distance2)
              Calculates for each cell location the sum of the accumulative costs for two input accumulative-cost datasets.
     IGeoDataset costAllocation(IGeoDataset sourceData, IGeoDataset costRaster, Object maxDistance, Object valueRaster)
              Calculates for each output cell the zone that could be reached with the least accumulative cost.
     IGeoDataset costBackLink(IGeoDataset sourceData, IGeoDataset costRaster, Object maxDistance, Object valueRaster)
              Calculates the neighbor that is the next cell on the least-accumulative-cost path from a cell to a source cell.
     IGeoDataset costDistance(IGeoDataset sourceData, IGeoDataset costRaster, Object maxDistance, Object valueRaster)
              Calculates for each cell the least-accumulative-cost distance over a cost surface to a source cell or a set of source cells.
     IGeoDataset costDistanceFull(IGeoDataset sourceData, IGeoDataset costRaster, boolean distance, boolean backlink, boolean allocation, Object maxDistance, Object valueRaster)
              Calculates for each cell the least-accumulative-cost distance, backlink, and allocation over a cost surface to a source cell or a set of source cells.
     IGeoDataset costPath(IGeoDataset fromData, IGeoDataset distance, IGeoDataset backlink, int pathType)
              Calculates the least-cost path(s) from selected cell(s) in the input data to the closest source cell.
     IGeometryCollection costPathAsPolyline(IPointCollection sourcePoints, IGeoDataset distance, IGeoDataset backlink)
              Calculates the least-cost path(s) from selected points in the input data and returns it as a polyline.
     IGeoDataset eucAllocation(IGeoDataset sourceData, Object maxDistance, Object valueRaster)
              Calculates for each cell the zone of the closest source cell (in Euclidean distance).
     IGeoDataset eucDirection(IGeoDataset sourceData, Object maxDistance, Object valueRaster)
              Calculates the direction in degrees from each cell center to the cell center of the closest source.
     IGeoDataset eucDistance(IGeoDataset sourceData, Object maxDistance, Object valueRaster)
              Calculates for each cell the Euclidean distance to the closest source.
     IGeoDataset eucDistanceFull(IGeoDataset sourceData, boolean distance, boolean direction, boolean allocation, Object maxDistance, Object valueRaster)
              Calculates for each cell optionally the Euclidean distance, direction, and allocation to the closest source.
     

    Method Detail

    eucDistance

    IGeoDataset eucDistance(IGeoDataset sourceData,
                            Object maxDistance,
                            Object valueRaster)
                            throws IOException,
                                   AutomationException
    Calculates for each cell the Euclidean distance to the closest source.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations whose values are assigned to the output cell locations that they are closest to. For rasters, the input value type can be an integer type, string type, or floating point type if in_value_raster is used.

    [maxDistance]

    Defines the threshold that the Euclidean distance values cannot exceed. If a cell is farther than the [maxDistance], the output value for the cell location will be NoData. The default distance is to the edge of the output Raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    An input Raster that identifies the values to associate with the source cell locations. The source cells define the zones that will be used in the Euclidean distance calculations. The [valueRaster] is particularly important if the source Raster was created by the ILogicalOp::Test method or a Boolean operator that will only output 1 and 0, or if alternative values or zones are to be used instead of the existing ones on the source input. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    eucDistanceFull

    IGeoDataset eucDistanceFull(IGeoDataset sourceData,
                                boolean distance,
                                boolean direction,
                                boolean allocation,
                                Object maxDistance,
                                Object valueRaster)
                                throws IOException,
                                       AutomationException
    Calculates for each cell optionally the Euclidean distance, direction, and allocation to the closest source.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations whose values are assigned to the output cell locations that they are closest to. For rasters, the input value type can be an integer type, string type, or floating point type if in_value_raster is used.

    distance

    A Boolean and if True an output (Euclidean) distance Raster will be created. The distance Raster calculates for each cell the Euclidean distance to the closest source.

    direction

    a Boolean and if True an output (Euclidean) direction Raster will be created. The direction Raster contains the calculated direction in degrees each cell center is from the closest source cell center. The range of values is from 0 to 360, with 0 being reserved for the source cells. Due east (right) is 90 and the values increase clockwise (180, south; 270, west; and 360, north).

    allocation

    A Boolean and if True an output (Euclidean) allocation Raster will be created. For each cell, the allocation Raster identifies the zone of the closest source cell (in Euclidean distance)..

    [maxDistance]

    Defines the threshold that the Euclidean distance values cannot exceed. If a cell is farther than the [maxDistance], the output value for the cell location will be NoData. The default distance is to the edge of the output Raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    An input Raster that identifies the values to associate with the source cell locations. The source cells define the zones that will be used in the Euclidean distance calculations. The [valueRaster] is particularly important if the source Raster was created by the ILogicalOp::Test method or a Boolean operator that will only output 1 and 0, or if alternative values or zones are to be used instead of the existing ones on the source input. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    distance - The distance (in)
    direction - The direction (in)
    allocation - The allocation (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    eucAllocation

    IGeoDataset eucAllocation(IGeoDataset sourceData,
                              Object maxDistance,
                              Object valueRaster)
                              throws IOException,
                                     AutomationException
    Calculates for each cell the zone of the closest source cell (in Euclidean distance).

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations whose values are assigned to the output cell locations that they are closest to. For rasters, the input value type can be an integer type, string type, or floating point type if in_value_raster is used.

    [maxDistance]

    defines the threshold that the Euclidean distance values cannot exceed. If a cell is farther than the [maxDistance], the output value for the cell location will be NoData. The default distance is to the edge of the output Raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    an input Raster that identifies the values to associate with the source cell locations. The source cells define the zones that will be used in the Euclidean allocation calculations. The [valueRaster] is particularly important if the source Raster was created by the ILogicalOp::TEST method or a Boolean method that will only output 1 and 0, or if alternative values or zones are to be used instead of the existing ones on the source input. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    eucDirection

    IGeoDataset eucDirection(IGeoDataset sourceData,
                             Object maxDistance,
                             Object valueRaster)
                             throws IOException,
                                    AutomationException
    Calculates the direction in degrees from each cell center to the cell center of the closest source.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations whose values are assigned to the output cell locations that they are closest to. For rasters, the input value type can be an integer type, string type, or floating point type if in_value_raster is used.

    [maxDistance]

    defines the threshold that the Euclidean distance values cannot exceed. If a cell is farther than the [maxDistance], the output value for the cell location will be NoData. The default distance is to the edge of the output Raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    an input Raster that identifies the values to associate with the source cell locations. The source cells define the zones that will be used in the Euclidean direction calculations. The [valueRaster] is particularly important if the source Raster was created by the ILogicalOp::TEST method or a Boolean operator that will only output 1 and 0, or if alternative values or zones are to be used instead of the existing ones on the source input. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costDistance

    IGeoDataset costDistance(IGeoDataset sourceData,
                             IGeoDataset costRaster,
                             Object maxDistance,
                             Object valueRaster)
                             throws IOException,
                                    AutomationException
    Calculates for each cell the least-accumulative-cost distance over a cost surface to a source cell or a set of source cells.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations to which the least accumulated cost distances for every cell is calculated

    For Rasters, the input value types can be either integer, string or floating-point type if in_raster_value is used.

    costRaster

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor defining the impedance or cost to move planimetrically through each cell

    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 on the costRaster can be integer or floating point, but they cannot be negative (you cannot have a negative cost).

    [maxDistance]

    defines the threshold that the accumulative cost values cannot exceed

    If an accumulative cost distance value exceeds the maxDistance, the output value for the cell location will be NoData. The maxDistance defines the extent which the accumulative cost distances are calculated. If no maxDistance is specified the distance will be to the edge of the output raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    an optional input Raster that identifies the zone values that should be used for each cell on the sourceData

    The value defined by the valueRaster for each source cell will be assigned to all cells that will be allocated to the source cell in the cost allocation computations. If no valueRaster is specified, the zone value for a source cell is the value on the sourceData.

    This parameter is particularly important if the sourceRaster was created by the ILogicalOp::Test or a ILogicalOp::Boolean methods that will only output 1 and 0 or if alternative values or zones are to be used instead of the existing ones, on the input source. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    costRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costAllocation

    IGeoDataset costAllocation(IGeoDataset sourceData,
                               IGeoDataset costRaster,
                               Object maxDistance,
                               Object valueRaster)
                               throws IOException,
                                      AutomationException
    Calculates for each output cell the zone that could be reached with the least accumulative cost.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations to which the least accumulated cost distances for every cell is calculated

    For Rasters, the input value types can be either integer, string or floating-point type if in_raster_value is used.

    costRaster

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor defining the impedance or cost to move planimetrically through each cell

    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 on the costRaster can be integer or floating point, but they cannot be negative (you cannot have a negative cost).

    [maxDistance]

    defines the threshold that the accumulative cost values cannot exceed

    If an accumulative cost distance value exceeds the maxDistance, the output value for the cell location will be NoData. The maxDistance defines the extent which the accumulative cost distances are calculated. If no maxDistance is specified the distance will be to the edge of the output raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    an optional input Raster that identifies the zone values that should be used for each cell on the sourceData

    The value defined by the valueRaster for each source cell will be assigned to all cells that will be allocated to the source cell in the cost allocation computations. If no valueRaster is specified, the zone value for a source cell is the value on the sourceData.

    This parameter is particularly important if the sourceRaster was created by the ILogicalOp::Test or a ILogicalOp::Boolean methods that will only output 1 and 0 or if alternative values or zones are to be used instead of the existing ones, on the input source. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    costRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costBackLink

    IGeoDataset costBackLink(IGeoDataset sourceData,
                             IGeoDataset costRaster,
                             Object maxDistance,
                             Object valueRaster)
                             throws IOException,
                                    AutomationException
    Calculates the neighbor that is the next cell on the least-accumulative-cost path from a cell to a source cell.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations to which the least accumulated cost distances for every cell is calculated

    For Rasters, the input value types can be either integer, string or floating-point type if in_raster_value is used.

    costRaster

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor defining the impedance or cost to move planimetrically through each cell. 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 on the costRaster can be integer or floating point, but they cannot be negative (you cannot have a negative cost)

    [maxDistance]

    defines the threshold that the accumulative cost values cannot exceed. If an accumulative cost distance value exceeds the maxDistance, the output value for the cell location will be NoData. The maxDistance defines the extent which the accumulative cost distances are calculated. If no maxDistance is specified the distance will be to the edge of the output raster. The data type for maxDistance can be either integer or floating point

    [valueRaster]

    an optional input Raster that identifies the zone values that should be used for each cell on the sourceData. The value defined by the valueRaster for each source cell will be assigned to all cells that will be allocated to the source cell in the cost allocation computations. If no valueRaster is specified, the zone value for a source cell is the value on the sourceData.

    This parameter is particularly important if the sourceRaster was created by the ILogicalOp::Test or a ILogicalOp::Boolean methods that will only output 1 and 0 or if alternative values or zones are to be used instead of the existing ones, on the input source. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    costRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costDistanceFull

    IGeoDataset costDistanceFull(IGeoDataset sourceData,
                                 IGeoDataset costRaster,
                                 boolean distance,
                                 boolean backlink,
                                 boolean allocation,
                                 Object maxDistance,
                                 Object valueRaster)
                                 throws IOException,
                                        AutomationException
    Calculates for each cell the least-accumulative-cost distance, backlink, and allocation over a cost surface to a source cell or a set of source cells.

    Remarks

    sourceData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations to which the least accumulated cost distances for every cell is calculated

    For Rasters, the input value types can be either integer, string or floating-point type if in_raster_value is used.

    costRaster

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor defining the impedance or cost to move planimetrically through each cell

    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 on the costRaster can be integer or floating point, but they cannot be negative (you cannot have a negative cost).

    distance

    a Boolean that if True will create an output Raster that for each cell the least-accumulative-cost distance is calculated over a cost surface, the costRaster, to a source cell or a set of source cells specified in the sourceData

    backlink

    a Boolean that if True will create an output cost back link Raster

    The back link Raster contains values from 0 through 8, which defines the direction or identifies the next neighboring cell (the succeeding cell) along the least acaccumulative cost path from a cell to reach a source.

    If the path is to pass into the right neighbor, the cell will be assigned the value '1', '2' for the lower-right diagonal cell and continuing clockwise. The value '0' is reserved for source cells.

    allocation

    a Boolean that if True will create an output cost allocation Raster

    The cost allocation raster identifies, for each cell, which source would require the least accumulative cost to reach.

    [maxDistance]

    defines the threshold that the accumulative cost values cannot exceed

    If an accumulative cost distance value exceeds the maxDistance, the output value for the cell location will be NoData. The maxDistance defines the extent which the accumulative cost distances are calculated. If no maxDistance is specified the distance will be to the edge of the output raster. The data type for maxDistance can be either integer or floating point.

    [valueRaster]

    an optional input Raster that identifies the zone values that should be used for each cell on the sourceData

    The value defined by the valueRaster for each source cell will be assigned to all cells that will be allocated to the source cell in the cost allocation computations. If no valueRaster is specified, the zone value for a source cell is the value on the sourceData.

    This parameter is particularly important if the sourceRaster was created by the ILogicalOp::Test or a ILogicalOp::Boolean methods that will only output 1 and 0 or if alternative values or zones are to be used instead of the existing ones, on the input source. The data type for the valueRaster can be of type Raster, RasterDataset, RasterBand, or RasterDescriptor.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourceData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    costRaster - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    distance - The distance (in)
    backlink - The backlink (in)
    allocation - The allocation (in)
    maxDistance - A Variant (in, optional, pass null if not required)
    valueRaster - A Variant (in, optional, pass null if not required)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    corridor

    IGeoDataset corridor(IGeoDataset distance1,
                         IGeoDataset distance2)
                         throws IOException,
                                AutomationException
    Calculates for each cell location the sum of the accumulative costs for two input accumulative-cost datasets.

    Remarks

    distance1

    an input Raster which was the output accumulated cost Raster from the IDistance::CostDistance or other Cost methods

    distance2

    an input Raster which was the output accumulated cost Raster from the IDistance::CostDistance or other Cost methods

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    distance1 - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    distance2 - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costPath

    IGeoDataset costPath(IGeoDataset fromData,
                         IGeoDataset distance,
                         IGeoDataset backlink,
                         int pathType)
                         throws IOException,
                                AutomationException
    Calculates the least-cost path(s) from selected cell(s) in the input data to the closest source cell.

    Remarks

    fromData

    an input Raster, RasterDataset, RasterBand, or RasterDescriptor or FeatureClass, FeatureClassDescriptor that identifies those cells or locations from which the least cost path is determined to the least costly source

    The Raster consists of cells which are to be considered in the IDistance::CostPath method calculations having valid values ('0' is a valid value), and the remaining cells must be assigned to NoData

    distance

    the name of a cost distance Raster to be used to determine the least cost path from the fromRaster cell locations to a source

    The distance Raster is usually created with the IDistanceOp::CostDistance method (or by the IDistanceOp::CostDistanceFull method). The distance Raster stores, for each cell, the minimum accumulative cost distance over a cost surface from each cell to a set of source cells.

    backlink

    the name of a cost back link Raster used to determine the path to return to a source via the least-cost path

    For each cell in the back link raster, a value identifies the neighbor that is the next cell on the least accumulative cost path from the cell to a single or set of source cells.

    pathType

    a parameter defining the manner in which the values and zones on the fromData will be interpreted in the cost path calculations

    There are three different esriGeoAnalysisPathEnum types:

    esriGeoAnalysisPathForEachCell

    For each cell with valid values on the fromData, a least-cost path is determined and saved on the output raster of the IDistance::CostPath method. With the for each cell parameter, each cell of the fromData input is treated separately, and a least-cost path is determined for each 'from' cell.

    esriGeoAnalysisPathForEachZone

    For each zone on the fromData, a single least-cost path is determined and saved on the output raster of the IDistance::CostPath method. With the for each zone parameter, for each zone, the least-cost path begins from the cell with the lowest cost distance weighting in the zone.

    esriGeoAnalysisPathForBestSingle

    For all cells on the fromData input, the least cost path is derived from the cell with the minimum of the least cost paths to source cells.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    fromData - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    distance - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    backlink - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    pathType - A com.esri.arcgis.spatialanalyst.esriGeoAnalysisPathEnum constant (in)
    Returns:
    A reference to a com.esri.arcgis.geodatabase.IGeoDataset
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.

    costPathAsPolyline

    IGeometryCollection costPathAsPolyline(IPointCollection sourcePoints,
                                           IGeoDataset distance,
                                           IGeoDataset backlink)
                                           throws IOException,
                                                  AutomationException
    Calculates the least-cost path(s) from selected points in the input data and returns it as a polyline.

    Remarks

    sourcePoints

    input collection of points which identifies the destinations in which the least cost path is routed to

    distance

    the name of a cost distance Raster to be used to determine the least cost path from the fromRaster cell locations to a source.

    The distance Raster is usually created with the IDistanceOp::CostDistance method (or by the IDistanceOp::CostDistanceFull method). The distance Raster stores, for each cell, the minimum accumulative cost distance over a cost surface from each cell to a set of source cells.

    backlink

    the name of a cost back link Raster used to determine the path to return to a source via the least-cost path

    For each cell in the back link raster, a value identifies the neighbor that is the next cell on the least accumulative cost path from the cell to a single or set of source cells.

    Product Availability

    Available with ArcGIS Engine, ArcGIS Desktop, and ArcGIS Server. Requires Spatial Analyst Extension.

    Supported Platforms

    Windows, Solaris, Linux

    Parameters:
    sourcePoints - A reference to a com.esri.arcgis.geometry.IPointCollection (in)
    distance - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    backlink - A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
    Returns:
    A reference to a com.esri.arcgis.geometry.IGeometryCollection
    Throws:
    IOException - If there are interop problems.
    AutomationException - If the ArcObject component throws an exception.