com.esri.arcgis.geoprocessing.tools.datamanagementtools
Class BuildFootprints
java.lang.Object
com.esri.arcgis.geoprocessing.AbstractGPTool
com.esri.arcgis.geoprocessing.tools.datamanagementtools.BuildFootprints
- All Implemented Interfaces:
- GPTool
public class BuildFootprints
- extends AbstractGPTool
Computes the footprints for each raster dataset in a mosaic dataset.
The Build Footprints tool is contained in the Data Management Tools tool box.
Usage tips:
- If there is a selection, only those selected footprints will be recalculated.
- The footprint is used to calculate the boundary. If you modify the shape of the footprints along the perimeter of the mosaic dataset, you need to recalculate the boundary. If you don't choose to using this tool, then you can do it later using the .
- If you add the orthorectifcation function to a raster dataset you should recalculate the footprint using the Geometry method. You may then also need to recalculate the boundary.
- The Image Type sets the default parameters for the advanced parameters in this tool, such as the Minimum Data Value. No matter what Image Type you choose, you can always modify the advanced parameters.
- You cannot rebuild footprints for an referenced mosaic dataset.
- This tool does not support the environment settings.
Constructor Summary |
BuildFootprints()
Creates the Build Footprints tool with defaults. |
BuildFootprints(java.lang.Object inMosaicDataset)
Creates the Build Footprints tool with the required parameters. |
Method Summary |
int |
getApproxNumVertices()
Returns the Approximate number of vertices parameter of this tool . |
java.lang.Object |
getInMosaicDataset()
Returns the Mosaic Dataset parameter of this tool . |
java.lang.String |
getMaintainEdges()
Returns the Maintain sheet edges parameter of this tool . |
double |
getMaxDataValue()
Returns the Maximum Data Value parameter of this tool . |
double |
getMinDataValue()
Returns the Minimum Data Value parameter of this tool . |
int |
getMinRegionSize()
Returns the Minimum Region Size parameter of this tool . |
java.lang.Object |
getOutMosaicDataset()
Returns the Mosaic Dataset parameter of this tool (Read only). |
int |
getRequestSize()
Returns the Request Size parameter of this tool . |
java.lang.String |
getResetFootprint()
Returns the Reset footprints to default parameter of this tool . |
double |
getShrinkDistance()
Returns the Shrink distance parameter of this tool . |
java.lang.String |
getSkipDerivedImages()
Returns the Skip overviews 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. |
java.lang.String |
getUpdateBoundary()
Returns the Update Boundary parameter of this tool . |
java.lang.Object |
getWhereClause()
Returns the Query Definition parameter of this tool . |
void |
setApproxNumVertices(int approxNumVertices)
Sets the Approximate number of vertices parameter of this tool . |
void |
setInMosaicDataset(java.lang.Object inMosaicDataset)
Sets the Mosaic Dataset parameter of this tool . |
void |
setMaintainEdges(java.lang.String maintainEdges)
Sets the Maintain sheet edges parameter of this tool . |
void |
setMaxDataValue(double maxDataValue)
Sets the Maximum Data Value parameter of this tool . |
void |
setMinDataValue(double minDataValue)
Sets the Minimum Data Value parameter of this tool . |
void |
setMinRegionSize(int minRegionSize)
Sets the Minimum Region Size parameter of this tool . |
void |
setRequestSize(int requestSize)
Sets the Request Size parameter of this tool . |
void |
setResetFootprint(java.lang.String resetFootprint)
Sets the Reset footprints to default parameter of this tool . |
void |
setShrinkDistance(double shrinkDistance)
Sets the Shrink distance parameter of this tool . |
void |
setSkipDerivedImages(java.lang.String skipDerivedImages)
Sets the Skip overviews parameter of this tool . |
void |
setUpdateBoundary(java.lang.String updateBoundary)
Sets the Update Boundary parameter of this tool . |
void |
setWhereClause(java.lang.Object whereClause)
Sets the Query Definition parameter of this tool . |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
BuildFootprints
public BuildFootprints()
- Creates the Build Footprints tool with defaults.
Initializes the array of tool parameters with the default values specified when the tool was created.
BuildFootprints
public BuildFootprints(java.lang.Object inMosaicDataset)
- Creates the Build Footprints 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:
inMosaicDataset
- the mosaic dataset for which the footprints will be calculated.
getInMosaicDataset
public java.lang.Object getInMosaicDataset()
- Returns the Mosaic Dataset parameter of this tool .
This parameter is the mosaic dataset for which the footprints will be calculated.
This is a required parameter.
- Returns:
- the Mosaic Dataset
setInMosaicDataset
public void setInMosaicDataset(java.lang.Object inMosaicDataset)
- Sets the Mosaic Dataset parameter of this tool .
This parameter is the mosaic dataset for which the footprints will be calculated.
This is a required parameter.
- Parameters:
inMosaicDataset
- the mosaic dataset for which the footprints will be calculated.
getWhereClause
public java.lang.Object getWhereClause()
- Returns the Query Definition parameter of this tool .
This parameter is using SQL you can define a query or use the Query Builder to build a query.
This is an optional parameter.
- Returns:
- the Query Definition
setWhereClause
public void setWhereClause(java.lang.Object whereClause)
- Sets the Query Definition parameter of this tool .
This parameter is using SQL you can define a query or use the Query Builder to build a query.
This is an optional parameter.
- Parameters:
whereClause
- using SQL you can define a query or use the Query Builder to build a query.
getResetFootprint
public java.lang.String getResetFootprint()
- Returns the Reset footprints to default parameter of this tool .
This parameter is the footprints will be redefined using the original parameters to generate them when the rasters were added.
This is an optional parameter.
- Returns:
- the Reset footprints to default
setResetFootprint
public void setResetFootprint(java.lang.String resetFootprint)
- Sets the Reset footprints to default parameter of this tool .
This parameter is the footprints will be redefined using the original parameters to generate them when the rasters were added.
This is an optional parameter.
- Parameters:
resetFootprint
- the footprints will be redefined using the original parameters to generate them when the rasters were added.
getMinDataValue
public double getMinDataValue()
- Returns the Minimum Data Value parameter of this tool .
This parameter is the lowest pixel value representing valid image data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 0 represents very dark colors, like black border pixels. When you specify 1 then the only value less than 1 is 0, therefore all 0 values will be considered invalid data and will be removed from the perimeter of the footprint. If the imagery is compressed using a lossy compression method, then you should define a value slightly greater than 1 to remove all the black pixels. When dark areas, such as shadows, have been incorrectly removed from the footprint this value should be decreased.
This is an optional parameter.
- Returns:
- the Minimum Data Value
setMinDataValue
public void setMinDataValue(double minDataValue)
- Sets the Minimum Data Value parameter of this tool .
This parameter is the lowest pixel value representing valid image data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 0 represents very dark colors, like black border pixels. When you specify 1 then the only value less than 1 is 0, therefore all 0 values will be considered invalid data and will be removed from the perimeter of the footprint. If the imagery is compressed using a lossy compression method, then you should define a value slightly greater than 1 to remove all the black pixels. When dark areas, such as shadows, have been incorrectly removed from the footprint this value should be decreased.
This is an optional parameter.
- Parameters:
minDataValue
- the lowest pixel value representing valid image data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 0 represents very dark colors, like black border pixels. When you specify 1 then the only value less than 1 is 0, therefore all 0 values will be considered invalid data and will be removed from the perimeter of the footprint. If the imagery is compressed using a lossy compression method, then you should define a value slightly greater than 1 to remove all the black pixels. When dark areas, such as shadows, have been incorrectly removed from the footprint this value should be decreased.
getMaxDataValue
public double getMaxDataValue()
- Returns the Maximum Data Value parameter of this tool .
This parameter is highest value representing valid data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 255 represents very bright colors, such as white clouds and snow. If you specify 245, then all values between 246 and 255 will be removed from the perimeter of the footprint.
This is an optional parameter.
- Returns:
- the Maximum Data Value
setMaxDataValue
public void setMaxDataValue(double maxDataValue)
- Sets the Maximum Data Value parameter of this tool .
This parameter is highest value representing valid data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 255 represents very bright colors, such as white clouds and snow. If you specify 245, then all values between 246 and 255 will be removed from the perimeter of the footprint.
This is an optional parameter.
- Parameters:
maxDataValue
- highest value representing valid data. This value is determined by the bit depth of the raster dataset. for example, with 8-bit data, the values can range from 0 to 255. A value around 255 represents very bright colors, such as white clouds and snow. If you specify 245, then all values between 246 and 255 will be removed from the perimeter of the footprint.
getApproxNumVertices
public int getApproxNumVertices()
- Returns the Approximate number of vertices parameter of this tool .
This parameter is approximate number of vertices with which the new footprint polygon will be created. the greater this value, the more accurate and irregular the polygon and longer the processing time.
This is an optional parameter.
- Returns:
- the Approximate number of vertices
setApproxNumVertices
public void setApproxNumVertices(int approxNumVertices)
- Sets the Approximate number of vertices parameter of this tool .
This parameter is approximate number of vertices with which the new footprint polygon will be created. the greater this value, the more accurate and irregular the polygon and longer the processing time.
This is an optional parameter.
- Parameters:
approxNumVertices
- approximate number of vertices with which the new footprint polygon will be created. the greater this value, the more accurate and irregular the polygon and longer the processing time.
getShrinkDistance
public double getShrinkDistance()
- Returns the Shrink distance parameter of this tool .
This parameter is distance value specified in the units of the mosaic dataset's coordinate system by which the overall polygon will be reduced in size. shrinking of the polygon is used to counteract effects of lossy compression, which causes edges of the image to overlap into NoData areas.
This is an optional parameter.
- Returns:
- the Shrink distance
setShrinkDistance
public void setShrinkDistance(double shrinkDistance)
- Sets the Shrink distance parameter of this tool .
This parameter is distance value specified in the units of the mosaic dataset's coordinate system by which the overall polygon will be reduced in size. shrinking of the polygon is used to counteract effects of lossy compression, which causes edges of the image to overlap into NoData areas.
This is an optional parameter.
- Parameters:
shrinkDistance
- distance value specified in the units of the mosaic dataset's coordinate system by which the overall polygon will be reduced in size. shrinking of the polygon is used to counteract effects of lossy compression, which causes edges of the image to overlap into NoData areas.
getMaintainEdges
public java.lang.String getMaintainEdges()
- Returns the Maintain sheet edges parameter of this tool .
This parameter is use when using raster datasets that have been tiled and are butt joined (or line up along the seams with little to no overlap).
This is an optional parameter.
- Returns:
- the Maintain sheet edges
setMaintainEdges
public void setMaintainEdges(java.lang.String maintainEdges)
- Sets the Maintain sheet edges parameter of this tool .
This parameter is use when using raster datasets that have been tiled and are butt joined (or line up along the seams with little to no overlap).
This is an optional parameter.
- Parameters:
maintainEdges
- use when using raster datasets that have been tiled and are butt joined (or line up along the seams with little to no overlap).
getSkipDerivedImages
public java.lang.String getSkipDerivedImages()
- Returns the Skip overviews parameter of this tool .
This parameter is adjust the footprints for derived images, such as service overviews.
This is an optional parameter.
- Returns:
- the Skip overviews
setSkipDerivedImages
public void setSkipDerivedImages(java.lang.String skipDerivedImages)
- Sets the Skip overviews parameter of this tool .
This parameter is adjust the footprints for derived images, such as service overviews.
This is an optional parameter.
- Parameters:
skipDerivedImages
- adjust the footprints for derived images, such as service overviews.
getUpdateBoundary
public java.lang.String getUpdateBoundary()
- Returns the Update Boundary parameter of this tool .
This parameter is generates or updates the boundary polygon of a mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels.
This is an optional parameter.
- Returns:
- the Update Boundary
setUpdateBoundary
public void setUpdateBoundary(java.lang.String updateBoundary)
- Sets the Update Boundary parameter of this tool .
This parameter is generates or updates the boundary polygon of a mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels.
This is an optional parameter.
- Parameters:
updateBoundary
- generates or updates the boundary polygon of a mosaic dataset. By default, the boundary merges all the footprint polygons to create a single boundary representing the extent of the valid pixels.
getRequestSize
public int getRequestSize()
- Returns the Request Size parameter of this tool .
This parameter is the size to which the raster will be resampled when it is examined using this process. The value (such as 2000) defines the dimension of rows and columns. you can increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset and thereby increases the processing time.
This is an optional parameter.
- Returns:
- the Request Size
setRequestSize
public void setRequestSize(int requestSize)
- Sets the Request Size parameter of this tool .
This parameter is the size to which the raster will be resampled when it is examined using this process. The value (such as 2000) defines the dimension of rows and columns. you can increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset and thereby increases the processing time.
This is an optional parameter.
- Parameters:
requestSize
- the size to which the raster will be resampled when it is examined using this process. The value (such as 2000) defines the dimension of rows and columns. you can increase or decrease this value based on the complexity of your raster data. Greater image resolution provides more detail in the raster dataset and thereby increases the processing time.
getMinRegionSize
public int getMinRegionSize()
- Returns the Minimum Region Size parameter of this tool .
This parameter is determines a filter used to remove holes created in the footprint. this value is specified in pixels, and it is directly related to the Request Size, not to the pixel resolution of the source raster.
This is an optional parameter.
- Returns:
- the Minimum Region Size
setMinRegionSize
public void setMinRegionSize(int minRegionSize)
- Sets the Minimum Region Size parameter of this tool .
This parameter is determines a filter used to remove holes created in the footprint. this value is specified in pixels, and it is directly related to the Request Size, not to the pixel resolution of the source raster.
This is an optional parameter.
- Parameters:
minRegionSize
- determines a filter used to remove holes created in the footprint. this value is specified in pixels, and it is directly related to the Request Size, not to the pixel resolution of the source raster.
getOutMosaicDataset
public java.lang.Object getOutMosaicDataset()
- Returns the Mosaic Dataset parameter of this tool (Read only).
This is an derived parameter.
- Returns:
- the Mosaic Dataset
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