com.esri.arcgis.geoprocessing.tools.spatialanalysttools
Class CostBackLink

java.lang.Object
  extended by com.esri.arcgis.geoprocessing.AbstractGPTool
      extended by com.esri.arcgis.geoprocessing.tools.spatialanalysttools.CostBackLink
All Implemented Interfaces:
GPTool

public class CostBackLink
extends AbstractGPTool

Defines the neighbor that is the next cell on the least accumulative cost path to the nearest source. The Cost Back Link tool is contained in the Spatial Analyst Tools tool box.
Learn more about how Cost functions work

Software restrictions: none

Illustration:

Usage tips:


Field Summary
 
Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
vals
 
Constructor Summary
CostBackLink()
          Creates the Cost Back Link tool with defaults.
CostBackLink(Object inSourceData, Object inCostRaster, Object outBacklinkRaster)
          Creates the Cost Back Link tool with the required parameters.
 
Method Summary
 Object getInCostRaster()
          Returns the Input cost raster parameter of this tool .
 Object getInSourceData()
          Returns the Input raster or feature source data parameter of this tool .
 double getMaximumDistance()
          Returns the Maximum distance parameter of this tool .
 Object getOutBacklinkRaster()
          Returns the Output backlink raster parameter of this tool .
 Object getOutDistanceRaster()
          Returns the Output distance raster parameter of this tool .
 String getToolboxAlias()
          Returns the alias of the tool box containing this tool.
 String getToolboxName()
          Returns the name of the tool box containing this tool.
 String getToolName()
          Returns the name of this tool.
 void setInCostRaster(Object inCostRaster)
          Sets the Input cost raster parameter of this tool .
 void setInSourceData(Object inSourceData)
          Sets the Input raster or feature source data parameter of this tool .
 void setMaximumDistance(double maximumDistance)
          Sets the Maximum distance parameter of this tool .
 void setOutBacklinkRaster(Object outBacklinkRaster)
          Sets the Output backlink raster parameter of this tool .
 void setOutDistanceRaster(Object outDistanceRaster)
          Sets the Output distance raster parameter of this tool .
 
Methods inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool
getParameterValues, toString
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait
 

Constructor Detail

CostBackLink

public CostBackLink()
Creates the Cost Back Link tool with defaults.

Initializes the array of tool parameters with the default values specified when the tool was created.


CostBackLink

public CostBackLink(Object inSourceData,
                    Object inCostRaster,
                    Object outBacklinkRaster)
Creates the Cost Back Link tool with the required parameters.

Initializes the array of tool parameters with the values as specified for the required parameters and with the default values for the other parameters.

Parameters:
inSourceData - Composite Geodataset, for rasters, it must be of integer type. For features, only integer fields can be used.
inCostRaster - Composite Geodataset, 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 compensating for diagonal movement, to obtain the total cost of passing through the cell. The values on the can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).
outBacklinkRaster - Raster Dataset, 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.
Method Detail

getInSourceData

public Object getInSourceData()
Returns the Input raster or feature source data parameter of this tool . This parameter is Composite Geodataset, for rasters, it must be of integer type. For features, only integer fields can be used. This is a required parameter.

Returns:
the Input raster or feature source data

setInSourceData

public void setInSourceData(Object inSourceData)
Sets the Input raster or feature source data parameter of this tool . This parameter is Composite Geodataset, for rasters, it must be of integer type. For features, only integer fields can be used. This is a required parameter.

Parameters:
inSourceData - Composite Geodataset, for rasters, it must be of integer type. For features, only integer fields can be used.

getInCostRaster

public Object getInCostRaster()
Returns the Input cost raster parameter of this tool . This parameter is Composite Geodataset, 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 compensating for diagonal movement, to obtain the total cost of passing through the cell. The values on the can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost). This is a required parameter.

Returns:
the Input cost raster

setInCostRaster

public void setInCostRaster(Object inCostRaster)
Sets the Input cost raster parameter of this tool . This parameter is Composite Geodataset, 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 compensating for diagonal movement, to obtain the total cost of passing through the cell. The values on the can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost). This is a required parameter.

Parameters:
inCostRaster - Composite Geodataset, 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 compensating for diagonal movement, to obtain the total cost of passing through the cell. The values on the can be integer or floating point, but they cannot be negative or zero (you cannot have a negative or zero cost).

getOutBacklinkRaster

public Object getOutBacklinkRaster()
Returns the Output backlink raster parameter of this tool . This parameter is Raster Dataset, 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. This is a required parameter.

Returns:
the Output backlink raster

setOutBacklinkRaster

public void setOutBacklinkRaster(Object outBacklinkRaster)
Sets the Output backlink raster parameter of this tool . This parameter is Raster Dataset, 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. This is a required parameter.

Parameters:
outBacklinkRaster - Raster Dataset, 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.

getMaximumDistance

public double getMaximumDistance()
Returns the Maximum distance parameter of this tool . This parameter is Double, if an accumulative cost distance value exceeds the {max_distance}, the output value for the cell location will be NoData. The {max_distance} defines the extent for which the accumulative cost distances are calculated. The default distance is to the edge of the output raster. This is an optional parameter.

Returns:
the Maximum distance

setMaximumDistance

public void setMaximumDistance(double maximumDistance)
Sets the Maximum distance parameter of this tool . This parameter is Double, if an accumulative cost distance value exceeds the {max_distance}, the output value for the cell location will be NoData. The {max_distance} defines the extent for which the accumulative cost distances are calculated. The default distance is to the edge of the output raster. This is an optional parameter.

Parameters:
maximumDistance - Double, if an accumulative cost distance value exceeds the {max_distance}, the output value for the cell location will be NoData. The {max_distance} defines the extent for which the accumulative cost distances are calculated. The default distance is to the edge of the output raster.

getOutDistanceRaster

public Object getOutDistanceRaster()
Returns the Output distance raster parameter of this tool . This parameter is Raster Dataset, the cost distance raster identifies, for each cell, the least accumulative cost distance over a cost surface to the identified source locations. A source can be a cell, a set of cells, or feature locations. This is an optional parameter.

Returns:
the Output distance raster

setOutDistanceRaster

public void setOutDistanceRaster(Object outDistanceRaster)
Sets the Output distance raster parameter of this tool . This parameter is Raster Dataset, the cost distance raster identifies, for each cell, the least accumulative cost distance over a cost surface to the identified source locations. A source can be a cell, a set of cells, or feature locations. This is an optional parameter.

Parameters:
outDistanceRaster - Raster Dataset, the cost distance raster identifies, for each cell, the least accumulative cost distance over a cost surface to the identified source locations. A source can be a cell, a set of cells, or feature locations.

getToolName

public String getToolName()
Returns the name of this tool.

Returns:
the tool name

getToolboxName

public String getToolboxName()
Returns the name of the tool box containing this tool.

Returns:
the tool box name

getToolboxAlias

public String getToolboxAlias()
Returns the alias of the tool box containing this tool.

Returns:
the tool box alias