com.esri.arcgis.geoprocessing.tools.analyst3dtools
Class SurfaceLength

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.analyst3dtools.SurfaceLength

All Implemented Interfaces:

GPTool

public class SurfaceLength
extends AbstractGPTool

This tool calculates the surface length for each polyline or polygon in a feature class based on a raster, triangulated irregular network (TIN), or terrain dataset surface. The Surface Length tool is contained in the 3D Analyst Tools tool box.

Usage tips:

• Use a smaller sampling distance to increase the accuracy of the surface length calculations.
• Use {out_length_field} to give the length field a custom name.
• Only polyline and polygon feature classes are valid inputs for this tool.

Field Summary

Fields inherited from class com.esri.arcgis.geoprocessing.AbstractGPTool

vals

Constructor Summary

SurfaceLength()
Creates the Surface Length tool with defaults.

SurfaceLength(Object inSurface, Object inFeatureClass)
Creates the Surface Length tool with the required parameters.

Method Summary

Object	getInFeatureClass() Returns the Input Feature Class parameter of this tool .
Object	getInSurface() Returns the Input Surface parameter of this tool .
String	getMethod() Returns the Method parameter of this tool .
String	getOutLengthField() Returns the Surface Length Field parameter of this tool .
Object	getOutputFeatureClass() Returns the Output Feature Class parameter of this tool (Read only).
double	getPyramidLevelResolution() Returns the Pyramid Level Resolution parameter of this tool .
double	getSampleDistance() Returns the Sampling Distance 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.
double	getZFactor() Returns the Z Factor parameter of this tool .
void	setInFeatureClass(Object inFeatureClass) Sets the Input Feature Class parameter of this tool .
void	setInSurface(Object inSurface) Sets the Input Surface parameter of this tool .
void	setMethod(String method) Sets the Method parameter of this tool .
void	setOutLengthField(String outLengthField) Sets the Surface Length Field parameter of this tool .
void	setPyramidLevelResolution(double pyramidLevelResolution) Sets the Pyramid Level Resolution parameter of this tool .
void	setSampleDistance(double sampleDistance) Sets the Sampling Distance parameter of this tool .
void	setZFactor(double zFactor) Sets the Z Factor 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

SurfaceLength

public SurfaceLength()

Creates the Surface Length tool with defaults.

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

SurfaceLength

public SurfaceLength(Object inSurface,
                     Object inFeatureClass)

Creates the Surface Length 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:

inSurface - the input raster, TIN, or terrain dataset whose values will be used for interpolation.

inFeatureClass - the input polygon or polyline feature class.

Method Detail

getInSurface

public Object getInSurface()

Returns the Input Surface parameter of this tool . This parameter is the input raster, TIN, or terrain dataset whose values will be used for interpolation. This is a required parameter.

Returns:

the Input Surface

setInSurface

public void setInSurface(Object inSurface)

Sets the Input Surface parameter of this tool . This parameter is the input raster, TIN, or terrain dataset whose values will be used for interpolation. This is a required parameter.

Parameters:

inSurface - the input raster, TIN, or terrain dataset whose values will be used for interpolation.

getInFeatureClass

public Object getInFeatureClass()

Returns the Input Feature Class parameter of this tool . This parameter is the input polygon or polyline feature class. This is a required parameter.

Returns:

the Input Feature Class

setInFeatureClass

public void setInFeatureClass(Object inFeatureClass)

Sets the Input Feature Class parameter of this tool . This parameter is the input polygon or polyline feature class. This is a required parameter.

Parameters:

inFeatureClass - the input polygon or polyline feature class.

getOutLengthField

public String getOutLengthField()

Returns the Surface Length Field parameter of this tool . This parameter is the name of the attribute field to contain the surface length. This is an optional parameter.

Returns:

the Surface Length Field

setOutLengthField

public void setOutLengthField(String outLengthField)

Sets the Surface Length Field parameter of this tool . This parameter is the name of the attribute field to contain the surface length. This is an optional parameter.

Parameters:

outLengthField - the name of the attribute field to contain the surface length.

getSampleDistance

public double getSampleDistance()

Returns the Sampling Distance parameter of this tool . This parameter is the surface spacing at which the length is calculated. By default, the sampling distance is the natural densification of a TIN or the cell size of a raster. This is an optional parameter.

Returns:

the Sampling Distance

setSampleDistance

public void setSampleDistance(double sampleDistance)

Sets the Sampling Distance parameter of this tool . This parameter is the surface spacing at which the length is calculated. By default, the sampling distance is the natural densification of a TIN or the cell size of a raster. This is an optional parameter.

Parameters:

sampleDistance - the surface spacing at which the length is calculated. By default, the sampling distance is the natural densification of a TIN or the cell size of a raster.

getZFactor

public double getZFactor()

Returns the Z Factor parameter of this tool . This parameter is the factor multiplied by input surface values to store new values in the length field. The Z factor is used to convert z-units to match x,y units. This is an optional parameter.

Returns:

the Z Factor

setZFactor

public void setZFactor(double zFactor)

Sets the Z Factor parameter of this tool . This parameter is the factor multiplied by input surface values to store new values in the length field. The Z factor is used to convert z-units to match x,y units. This is an optional parameter.

Parameters:

zFactor - the factor multiplied by input surface values to store new values in the length field. The Z factor is used to convert z-units to match x,y units.

getMethod

public String getMethod()

Returns the Method parameter of this tool . This parameter is the interpolation method. For raster surfaces, the only option is BILINEAR. Select LINEAR or NATURAL_NEIGHBORS. This is an optional parameter.

Returns:

the Method

setMethod

public void setMethod(String method)

Sets the Method parameter of this tool . This parameter is the interpolation method. For raster surfaces, the only option is BILINEAR. Select LINEAR or NATURAL_NEIGHBORS. This is an optional parameter.

Parameters:

method - the interpolation method. For raster surfaces, the only option is BILINEAR. Select LINEAR or NATURAL_NEIGHBORS.

getPyramidLevelResolution

public double getPyramidLevelResolution()

Returns the Pyramid Level Resolution parameter of this tool . This parameter is the resolution of the terrain dataset pyramid level to use for geoprocessing. The default is 0, full resolution. This is an optional parameter.

Returns:

the Pyramid Level Resolution

setPyramidLevelResolution

public void setPyramidLevelResolution(double pyramidLevelResolution)

Sets the Pyramid Level Resolution parameter of this tool . This parameter is the resolution of the terrain dataset pyramid level to use for geoprocessing. The default is 0, full resolution. This is an optional parameter.

Parameters:

pyramidLevelResolution - the resolution of the terrain dataset pyramid level to use for geoprocessing. The default is 0, full resolution.

getOutputFeatureClass

public Object getOutputFeatureClass()

Returns the Output Feature Class parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output Feature Class

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