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

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

All Implemented Interfaces:

GPTool

public class InterpolateShape
extends AbstractGPTool

Interpolates z-values for a feature class based on an underlying raster, TIN, or terrain surface. Interpolates a 3D feature class from an input 2D feature class and a surface with the overlapping extent. The Interpolate Shape tool is contained in the 3D Analyst Tools tool box.
Learn more about how Interpolate Shape (3D Analyst) works

Software restrictions: none

Illustration:

Usage tips:

• When using the natural neighbors interpolation option make sure to specify a reasonable sample distance. This usually falls between 0.5 and 1.0 times the average point spacing of the data used to build the TIN.
• When using the vertex only option, input features with vertices that fall outside the data area of the surface will be ignored and not available in the output. Clip features prior to running the interpolate shape to ensure the features are completely on the surface.
• The following environment settings affect this tool:

Field Summary

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

vals

Constructor Summary

InterpolateShape()
Creates the Interpolate Shape tool with defaults.

InterpolateShape(Object inSurface, Object inFeatureClass, Object outFeatureClass)
Creates the Interpolate Shape 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 .
Object	getOutFeatureClass() Returns the Output Feature Class parameter of this tool .
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.
String	getVerticesOnly() Returns the Interpolate Vertices Only parameter 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	setOutFeatureClass(Object outFeatureClass) Sets the Output Feature Class 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	setVerticesOnly(String verticesOnly) Sets the Interpolate Vertices Only 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

InterpolateShape

public InterpolateShape()

Creates the Interpolate Shape tool with defaults.

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

InterpolateShape

public InterpolateShape(Object inSurface,
                        Object inFeatureClass,
                        Object outFeatureClass)

Creates the Interpolate Shape 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 - Tin Layer | Raster Layer, the input raster, TIN, or Terrain surface to be used as a source of z-values.

inFeatureClass - Feature Layer, the input 2D feature class.

outFeatureClass - Feature Class, the output feature class.

Method Detail

getInSurface

public Object getInSurface()

Returns the Input Surface parameter of this tool . This parameter is Tin Layer | Raster Layer, the input raster, TIN, or Terrain surface to be used as a source of z-values. 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 Tin Layer | Raster Layer, the input raster, TIN, or Terrain surface to be used as a source of z-values. This is a required parameter.

Parameters:

inSurface - Tin Layer | Raster Layer, the input raster, TIN, or Terrain surface to be used as a source of z-values.

getInFeatureClass

public Object getInFeatureClass()

Returns the Input Feature Class parameter of this tool . This parameter is Feature Layer, the input 2D 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 Feature Layer, the input 2D feature class. This is a required parameter.

Parameters:

inFeatureClass - Feature Layer, the input 2D feature class.

getOutFeatureClass

public Object getOutFeatureClass()

Returns the Output Feature Class parameter of this tool . This parameter is Feature Class, the output feature class. This is a required parameter.

Returns:

the Output Feature Class

setOutFeatureClass

public void setOutFeatureClass(Object outFeatureClass)

Sets the Output Feature Class parameter of this tool . This parameter is Feature Class, the output feature class. This is a required parameter.

Parameters:

outFeatureClass - Feature Class, the output feature class.

getSampleDistance

public double getSampleDistance()

Returns the Sampling Distance parameter of this tool . This parameter is Double, the spacing at which z values will be interpolated. By default, this is a raster's cell size or a TIN's natural densification. 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 Double, the spacing at which z values will be interpolated. By default, this is a raster's cell size or a TIN's natural densification. This is an optional parameter.

Parameters:

sampleDistance - Double, the spacing at which z values will be interpolated. By default, this is a raster's cell size or a TIN's natural densification.

getZFactor

public double getZFactor()

Returns the Z Factor parameter of this tool . This parameter is Double, the factor by which the heights of the input surface will be multiplied to calculate new heights in the output feature class. Used for converting 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 Double, the factor by which the heights of the input surface will be multiplied to calculate new heights in the output feature class. Used for converting z units to match x,y units. This is an optional parameter.

Parameters:

zFactor - Double, the factor by which the heights of the input surface will be multiplied to calculate new heights in the output feature class. Used for converting z units to match x,y units.

getMethod

public String getMethod()

Returns the Method parameter of this tool . This parameter is String, the interpolation method. For raster surfaces the only option is BILINEAR. For TINs you may select LINEAR or NATURAL_NEIGHBORS. The default for TINs is LINEAR. This is an optional parameter.

Returns:

the Method

setMethod

public void setMethod(String method)

Sets the Method parameter of this tool . This parameter is String, the interpolation method. For raster surfaces the only option is BILINEAR. For TINs you may select LINEAR or NATURAL_NEIGHBORS. The default for TINs is LINEAR. This is an optional parameter.

Parameters:

method - String, the interpolation method. For raster surfaces the only option is BILINEAR. For TINs you may select LINEAR or NATURAL_NEIGHBORS. The default for TINs is LINEAR.

getVerticesOnly

public String getVerticesOnly()

Returns the Interpolate Vertices Only parameter of this tool . This parameter is String, the sample distance will be ignored and the interpolation will use the input vertex locations only. This is an optional parameter.

Returns:

the Interpolate Vertices Only

setVerticesOnly

public void setVerticesOnly(String verticesOnly)

Sets the Interpolate Vertices Only parameter of this tool . This parameter is String, the sample distance will be ignored and the interpolation will use the input vertex locations only. This is an optional parameter.

Parameters:

verticesOnly - String, the sample distance will be ignored and the interpolation will use the input vertex locations only.

getPyramidLevelResolution

public double getPyramidLevelResolution()

Returns the Pyramid Level Resolution parameter of this tool . This parameter is Double, the resolution, given in z-tolerance, of the pyramid level to use for conversion. 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 Double, the resolution, given in z-tolerance, of the pyramid level to use for conversion. The default is 0, full resolution. This is an optional parameter.

Parameters:

pyramidLevelResolution - Double, the resolution, given in z-tolerance, of the pyramid level to use for conversion. The default is 0, full resolution.

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