com.esri.arcgis.geoprocessing.tools.datamanagementtools
Class Clip

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.datamanagementtools.Clip

All Implemented Interfaces:

GPTool

public class Clip
extends AbstractGPTool

Creates a spatial subset of a raster dataset. The Clip tool is contained in the Data Management Tools tool box.

Software restrictions: none

Illustration:

Usage tips:

• The Clip tool allows you to extract a portion of a raster dataset based on a template extent. The clip output will include any pixels that intersect the template extent.
• The clipped area is specified either by a rectangular envelope using minimum and maximum x- and y-coordinates or by using a output extent file. If the clip extent specified is not aligned with the input raster dataset, this tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool.
• An existing raster of vector layer can be used as the clip extent. If you are using a feature class as the output extent, you have the option to clip the raster by the minimum bounding rectangle of the feature class or by the polygon geometry of the features. If Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth.
• When using ArcMap, you also have the ability to use the selected feature(s) as the clipping extent. If a feature within the feature class is selected and Input Features for Clipping Geometry is checked, then the output will clip out the areas that was selected. If a feature within the feature class is selected but the Input Features for Clipping Geometry is not checked, then the output will clip out the minimum bounding rectangle for that feature.
• You can save your output to BMP, GIF, GRID, IMG, JPEG, JPEG 2000, PNG, TIFF, or any geodatabase raster dataset.
• When storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. When storing the raster dataset in a file format, you need to specify the file extension: .bmp for BMP, .gif for GIF, .img for an ERDAS IMAGINE file, .jpg for JPEG, .jp2 for JPEG 2000, .png for PNG, .tif for TIFF, or no extension for GRID.
• When storing your raster dataset to a geodatabase, you can specify a compression type and compression quality within the Raster Storage Settings in the Environment Settings.
• If the clip extent specified is not aligned with the input raster dataset, the Clip tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool.
• If you are using a feature class as the Output Extent, you have the option to clip the raster by the extent of the feature class or by its polygon perimeter.
• The extent values must be in the same spatial coordinates and units as the raster dataset.
• The following environments affect this tool: current workspace; scratch workspace; output coordinate system; snap raster; output CONFIG keyword; pyramid; raster statistics; compression; , and tile size;

Field Summary

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

vals

Constructor Summary

Clip()
Creates the Clip tool with defaults.

Clip(Object inRaster, Object rectangle, Object outRaster)
Creates the Clip tool with the required parameters.

Method Summary

String	getClippingGeometry() Returns the Use Input Features for Clipping Geometry parameter of this tool .
Object	getInRaster() Returns the Input Raster parameter of this tool .
Object	getInTemplateDataset() Returns the Output Extent parameter of this tool .
double	getNodataValue() Returns the NoData Value parameter of this tool .
Object	getOutRaster() Returns the Output Raster Dataset parameter of this tool .
Object	getRectangle() Returns the Rectangle 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	setClippingGeometry(String clippingGeometry) Sets the Use Input Features for Clipping Geometry parameter of this tool .
void	setInRaster(Object inRaster) Sets the Input Raster parameter of this tool .
void	setInTemplateDataset(Object inTemplateDataset) Sets the Output Extent parameter of this tool .
void	setNodataValue(double nodataValue) Sets the NoData Value parameter of this tool .
void	setOutRaster(Object outRaster) Sets the Output Raster Dataset parameter of this tool .
void	setRectangle(Object rectangle) Sets the Rectangle 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

Clip

public Clip()

Creates the Clip tool with defaults.

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

Clip

public Clip(Object inRaster,
            Object rectangle,
            Object outRaster)

Creates the Clip 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, the input raster dataset.

rectangle - Envelope, if the clip extent specified is not aligned with the input raster dataset, the clip tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool.

outRaster - Raster dataset, when storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality.

Method Detail

getInRaster

public Object getInRaster()

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

Returns:

the Input Raster

setInRaster

public void setInRaster(Object inRaster)

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

Parameters:

inRaster - Composite geodataset, the input raster dataset.

getRectangle

public Object getRectangle()

Returns the Rectangle parameter of this tool . This parameter is Envelope, if the clip extent specified is not aligned with the input raster dataset, the clip tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool. This is a required parameter.

Returns:

the Rectangle

setRectangle

public void setRectangle(Object rectangle)

Sets the Rectangle parameter of this tool . This parameter is Envelope, if the clip extent specified is not aligned with the input raster dataset, the clip tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool. This is a required parameter.

Parameters:

rectangle - Envelope, if the clip extent specified is not aligned with the input raster dataset, the clip tool will make sure that the proper alignment is used. This may cause the output to have a slightly different extent than specified in the tool.

getOutRaster

public Object getOutRaster()

Returns the Output Raster Dataset parameter of this tool . This parameter is Raster dataset, when storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality. This is a required parameter.

Returns:

the Output Raster Dataset

setOutRaster

public void setOutRaster(Object outRaster)

Sets the Output Raster Dataset parameter of this tool . This parameter is Raster dataset, when storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality. This is a required parameter.

Parameters:

outRaster - Raster dataset, when storing a raster dataset in a geodatabase, no file extension should be added to the name of the raster dataset. A raster dataset stored in a geodatabase can be compressed; you can specify a compression type and compression quality.

getInTemplateDataset

public Object getInTemplateDataset()

Returns the Output Extent parameter of this tool . This parameter is Geodataset, if a feature class is used as the output extent and you want to clip the raster based on the polygon features, choose the ClippingGeometry option. If Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth. This is an optional parameter.

Returns:

the Output Extent

setInTemplateDataset

public void setInTemplateDataset(Object inTemplateDataset)

Sets the Output Extent parameter of this tool . This parameter is Geodataset, if a feature class is used as the output extent and you want to clip the raster based on the polygon features, choose the ClippingGeometry option. If Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth. This is an optional parameter.

Parameters:

inTemplateDataset - Geodataset, if a feature class is used as the output extent and you want to clip the raster based on the polygon features, choose the ClippingGeometry option. If Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth.

getNodataValue

public double getNodataValue()

Returns the NoData Value parameter of this tool . This parameter is Integer, all the pixels with the specified value will be set to NoData in the output raster dataset. This is an optional parameter.

Returns:

the NoData Value

setNodataValue

public void setNodataValue(double nodataValue)

Sets the NoData Value parameter of this tool . This parameter is Integer, all the pixels with the specified value will be set to NoData in the output raster dataset. This is an optional parameter.

Parameters:

nodataValue - Integer, all the pixels with the specified value will be set to NoData in the output raster dataset.

getClippingGeometry

public String getClippingGeometry()

Returns the Use Input Features for Clipping Geometry parameter of this tool . This parameter is String, if Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth. This is an optional parameter.

Returns:

the Use Input Features for Clipping Geometry

setClippingGeometry

public void setClippingGeometry(String clippingGeometry)

Sets the Use Input Features for Clipping Geometry parameter of this tool . This parameter is String, if Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth. This is an optional parameter.

Parameters:

clippingGeometry - String, if Clipping Geometry is used, then the pixel depth of the output may be promoted. Therefore you need to make sure that the output format can support the proper pixel depth.

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