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

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.spatialanalysttools.Curvature

All Implemented Interfaces:

GPTool

public class Curvature

extends AbstractGPTool

Calculates the curvature of a raster surface, optionally including profile and plan curvature. The Curvature tool is contained in the Spatial Analyst Tools tool box.
Learn more about how Curvature works

Software restrictions: none

Usage tips:

• The primary output is the curvature of the surface on a cell-by-cell basis, as fitted through that cell and its eight surrounding neighbors. Curvature is the second derivative of the surface or the slope of the slope. Two optional output curvature types are possible; the profile curvature is in the direction of the maximum slope, and the plan curvature is perpendicular to the direction of the maximum slope.
• A positive curvature indicates the surface is upwardly convex at that cell. A negative curvature indicates the surface is upwardly concave at that cell. A value of zero indicates the surface is flat.
• In the profile output, a negative value indicates the surface is upwardly convex at that cell. A positive profile indicates the surface is upwardly concave at that cell. A value of zero indicates the surface is flat.
• In the plan output, a positive value indicates the surface is upwardly convex at that cell. A negative plan indicates the surface is upwardly concave at that cell. A value of zero indicates the surface is flat.
• Units of the curvature output raster, as well as the units for the optional output profile curve raster and output plan curve raster, are one over 100 z units, or 1/100 (z units). The reasonably expected values of all three output rasters for a hilly area (moderate relief) can vary from -0.5 to 0.5; while for steep, rugged mountains (extreme relief), the values can vary between -4 and 4.

Field Summary

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

vals

Constructor Summary

Curvature()
Creates the Curvature tool with defaults.

Curvature(java.lang.Object inRaster, java.lang.Object outCurvatureRaster)
Creates the Curvature tool with the required parameters.

Method Summary

java.lang.Object	getInRaster() Returns the Input raster parameter of this tool .
java.lang.Object	getOutCurvatureRaster() Returns the Output curvature raster parameter of this tool .
java.lang.Object	getOutPlanCurveRaster() Returns the Output plan curve raster parameter of this tool .
java.lang.Object	getOutProfileCurveRaster() Returns the Output profile curve raster parameter of this tool .
java.lang.String	getToolboxAlias() Returns the alias of the tool box containing this tool.
java.lang.String	getToolboxName() Returns the name of the tool box containing this tool.
java.lang.String	getToolName() Returns the name of this tool.
double	getZFactor() Returns the Z factor parameter of this tool .
void	setInRaster(java.lang.Object inRaster) Sets the Input raster parameter of this tool .
void	setOutCurvatureRaster(java.lang.Object outCurvatureRaster) Sets the Output curvature raster parameter of this tool .
void	setOutPlanCurveRaster(java.lang.Object outPlanCurveRaster) Sets the Output plan curve raster parameter of this tool .
void	setOutProfileCurveRaster(java.lang.Object outProfileCurveRaster) Sets the Output profile curve raster 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

Curvature

public Curvature()

Creates the Curvature tool with defaults.

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

Curvature

public Curvature(java.lang.Object inRaster,
                 java.lang.Object outCurvatureRaster)

Creates the Curvature 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:

inRaster - Composite Geodataset, input raster.

outCurvatureRaster - Raster Dataset, output curvature raster dataset.

Method Detail

getInRaster

public java.lang.Object getInRaster()

Returns the Input raster parameter of this tool . This parameter is Composite Geodataset, input raster. This is a required parameter.

Returns:

the Input raster

setInRaster

public void setInRaster(java.lang.Object inRaster)

Sets the Input raster parameter of this tool . This parameter is Composite Geodataset, input raster. This is a required parameter.

Parameters:

inRaster - Composite Geodataset, input raster.

getOutCurvatureRaster

public java.lang.Object getOutCurvatureRaster()

Returns the Output curvature raster parameter of this tool . This parameter is Raster Dataset, output curvature raster dataset. This is a required parameter.

Returns:

the Output curvature raster

setOutCurvatureRaster

public void setOutCurvatureRaster(java.lang.Object outCurvatureRaster)

Sets the Output curvature raster parameter of this tool . This parameter is Raster Dataset, output curvature raster dataset. This is a required parameter.

Parameters:

outCurvatureRaster - Raster Dataset, output curvature raster dataset.

getZFactor

public double getZFactor()

Returns the Z factor parameter of this tool . This parameter is Double, for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). 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, for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter). This is an optional parameter.

Parameters:

zFactor - Double, for example, if your z units are feet and your x,y units are meters, you would use a z-factor of 0.3048 to convert your z units from feet to meters (1 foot = 0.3048 meter).

getOutProfileCurveRaster

public java.lang.Object getOutProfileCurveRaster()

Returns the Output profile curve raster parameter of this tool . This parameter is Raster Dataset, this is the curvature of the surface in the direction of slope. This is an optional parameter.

Returns:

the Output profile curve raster

setOutProfileCurveRaster

public void setOutProfileCurveRaster(java.lang.Object outProfileCurveRaster)

Sets the Output profile curve raster parameter of this tool . This parameter is Raster Dataset, this is the curvature of the surface in the direction of slope. This is an optional parameter.

Parameters:

outProfileCurveRaster - Raster Dataset, this is the curvature of the surface in the direction of slope.

getOutPlanCurveRaster

public java.lang.Object getOutPlanCurveRaster()

Returns the Output plan curve raster parameter of this tool . This parameter is Raster Dataset, this is the curvature of the surface perpendicular to the slope direction. This is an optional parameter.

Returns:

the Output plan curve raster

setOutPlanCurveRaster

public void setOutPlanCurveRaster(java.lang.Object outPlanCurveRaster)

Sets the Output plan curve raster parameter of this tool . This parameter is Raster Dataset, this is the curvature of the surface perpendicular to the slope direction. This is an optional parameter.

Parameters:

outPlanCurveRaster - Raster Dataset, this is the curvature of the surface perpendicular to the slope direction.

getToolName

public java.lang.String getToolName()

Returns the name of this tool.

Returns:

the tool name

getToolboxName

public java.lang.String getToolboxName()

Returns the name of the tool box containing this tool.

Returns:

the tool box name

getToolboxAlias

public java.lang.String getToolboxAlias()

Returns the alias of the tool box containing this tool.

Returns:

the tool box alias