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

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

All Implemented Interfaces:

GPTool

public class SetNull
extends AbstractGPTool

Returns NoData if a conditional evaluation is true and returns the value specified by another raster if it is false, on a cell-by-cell basis. The Set Null tool is contained in the Spatial Analyst Tools tool box.
Learn more about how Set Null works

Software restrictions: none

Illustration:

Usage tips:

• If the evaluation of the where clause is true, the cell location on the output raster will be assigned NoData. If the evaluation is false, the output raster will be defined by the input false raster or constant value.
• If no where clause is specified, the output raster will have NoData wherever the conditional raster is greater than zero.
• The input conditional raster does not affect whether the output data type is integer or floating point. If the input false raster or constant value contains floating-point values, the output raster will be floating point. If it contains all integer values, the output will be an integer raster.
• The following environment settings affect this tool:

Field Summary

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

vals

Constructor Summary

SetNull()
Creates the Set Null tool with defaults.

SetNull(Object inConditionalRaster, Object inFalseRasterOrConstant, Object outRaster)
Creates the Set Null tool with the required parameters.

Method Summary

Object	getInConditionalRaster() Returns the Input conditional raster parameter of this tool .
Object	getInFalseRasterOrConstant() Returns the Input false raster or constant value parameter of this tool .
Object	getOutRaster() Returns the Output 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.
Object	getWhereClause() Returns the Expression parameter of this tool .
void	setInConditionalRaster(Object inConditionalRaster) Sets the Input conditional raster parameter of this tool .
void	setInFalseRasterOrConstant(Object inFalseRasterOrConstant) Sets the Input false raster or constant value parameter of this tool .
void	setOutRaster(Object outRaster) Sets the Output raster parameter of this tool .
void	setWhereClause(Object whereClause) Sets the Expression 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

SetNull

public SetNull()

Creates the Set Null tool with defaults.

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

SetNull

public SetNull(Object inConditionalRaster,
               Object inFalseRasterOrConstant,
               Object outRaster)

Creates the Set Null 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:

inConditionalRaster - Composite Geodataset, the input must be an integer raster.

inFalseRasterOrConstant - Composite Geodataset, the input must be an integer, float raster, or constant value.

outRaster - Raster Dataset, the raster to be created.

Method Detail

getInConditionalRaster

public Object getInConditionalRaster()

Returns the Input conditional raster parameter of this tool . This parameter is Composite Geodataset, the input must be an integer raster. This is a required parameter.

Returns:

the Input conditional raster

setInConditionalRaster

public void setInConditionalRaster(Object inConditionalRaster)

Sets the Input conditional raster parameter of this tool . This parameter is Composite Geodataset, the input must be an integer raster. This is a required parameter.

Parameters:

inConditionalRaster - Composite Geodataset, the input must be an integer raster.

getInFalseRasterOrConstant

public Object getInFalseRasterOrConstant()

Returns the Input false raster or constant value parameter of this tool . This parameter is Composite Geodataset, the input must be an integer, float raster, or constant value. This is a required parameter.

Returns:

the Input false raster or constant value

setInFalseRasterOrConstant

public void setInFalseRasterOrConstant(Object inFalseRasterOrConstant)

Sets the Input false raster or constant value parameter of this tool . This parameter is Composite Geodataset, the input must be an integer, float raster, or constant value. This is a required parameter.

Parameters:

inFalseRasterOrConstant - Composite Geodataset, the input must be an integer, float raster, or constant value.

getOutRaster

public Object getOutRaster()

Returns the Output raster parameter of this tool . This parameter is Raster Dataset, the raster to be created. This is a required parameter.

Returns:

the Output raster

setOutRaster

public void setOutRaster(Object outRaster)

Sets the Output raster parameter of this tool . This parameter is Raster Dataset, the raster to be created. This is a required parameter.

Parameters:

outRaster - Raster Dataset, the raster to be created.

getWhereClause

public Object getWhereClause()

Returns the Expression parameter of this tool . This parameter is SQL Expression, an SQL expression used to select a subset of raster cells. For information on SQL syntax, see This is an optional parameter.

Returns:

the Expression

setWhereClause

public void setWhereClause(Object whereClause)

Sets the Expression parameter of this tool . This parameter is SQL Expression, an SQL expression used to select a subset of raster cells. For information on SQL syntax, see This is an optional parameter.

Parameters:

whereClause - SQL Expression, an SQL expression used to select a subset of raster cells. For information on SQL syntax, see

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