com.esri.arcgis.geoprocessing.tools.spatialanalysttools
Class MLClassify
java.lang.Object
com.esri.arcgis.geoprocessing.AbstractGPTool
com.esri.arcgis.geoprocessing.tools.spatialanalysttools.MLClassify
- All Implemented Interfaces:
- GPTool
public class MLClassify
- extends AbstractGPTool
Performs a maximum likelihood classification on a set of raster bands and creates a classified raster as output.
The Maximum Likelihood Classification tool is contained in the Spatial Analyst Tools tool box.
Usage tips:
- Any signature file created by the Create Signature, Edit Signature, or Iso Cluster tools is a valid entry for the input signature file. These will have a .gsg extension.
- By default, all cells in the output raster will be classified, with each class having equal probability weights attached to their signatures.
- The input a priori probability file must be an ASCII file consisting of two columns. The values in the left column represent class IDs. The values in the right column represent the a priori probabilities for the respective classes. Valid values for class a priori probabilities must be greater than or equal to zero. If zero is specified as a probability, the class will not appear on the output raster. The sum of the specified a priori probabilities must be less than or equal to one. The format of the file is as follows:The classes omitted in the file will receive the average a priori probability of the remaining portion of the value of one. In the above example, all classes from 1 to 8 are represented in the signature file. The a priori probabilities of classes 3 and 6 are missing in the input a priori probability file. Since the sum of all probabilities specified in the above file is equal to 0.8, the remaining portion of the probability (0.2) is divided by the number of classes not specified (2). Therefore, classes 3 and 6 will each be assigned a probability of 0.1.
- A specified reject fraction, which lies between any two valid values, will be assigned to the next upper valid value. For example, 0.02 will become 0.025.
- If the input is a layer created from a multiband raster with more than three bands, the operation will consider all the bands associated with the source dataset, not just the three bands that were loaded (symbolized) by the layer. If you want to process a subset of the bands in the source dataset use the tool to create an input layer containing the desired bands.
- There is a direct relationship between the number of unclassified cells on the output raster resulting from the reject fraction and the number of cells represented by the sum of levels of confidence smaller than the respective value entered for the reject fraction.
- The extension for an input a priori probability file is .txt.
|
Constructor Summary |
MLClassify()
Creates the Maximum Likelihood Classification tool with defaults. |
MLClassify(java.lang.Object inRasterBands,
java.lang.Object inSignatureFile,
java.lang.Object outClassifiedRaster)
Creates the Maximum Likelihood Classification tool with the required parameters. |
|
Method Summary |
java.lang.String |
getAPrioriProbabilities()
Returns the A priori probability weighting parameter of this tool . |
java.lang.Object |
getInAPrioriFile()
Returns the Input a priori probability file parameter of this tool . |
java.lang.Object |
getInRasterBands()
Returns the Input raster bands parameter of this tool . |
java.lang.Object |
getInSignatureFile()
Returns the Input signature file parameter of this tool . |
java.lang.Object |
getOutClassifiedRaster()
Returns the Output classified raster parameter of this tool . |
java.lang.Object |
getOutConfidenceRaster()
Returns the Output confidence raster parameter of this tool . |
java.lang.String |
getRejectFraction()
Returns the Reject fraction 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. |
void |
setAPrioriProbabilities(java.lang.String aPrioriProbabilities)
Sets the A priori probability weighting parameter of this tool . |
void |
setInAPrioriFile(java.lang.Object inAPrioriFile)
Sets the Input a priori probability file parameter of this tool . |
void |
setInRasterBands(java.lang.Object inRasterBands)
Sets the Input raster bands parameter of this tool . |
void |
setInSignatureFile(java.lang.Object inSignatureFile)
Sets the Input signature file parameter of this tool . |
void |
setOutClassifiedRaster(java.lang.Object outClassifiedRaster)
Sets the Output classified raster parameter of this tool . |
void |
setOutConfidenceRaster(java.lang.Object outConfidenceRaster)
Sets the Output confidence raster parameter of this tool . |
void |
setRejectFraction(java.lang.String rejectFraction)
Sets the Reject fraction parameter of this tool . |
| Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait |
MLClassify
public MLClassify()
- Creates the Maximum Likelihood Classification tool with defaults.
Initializes the array of tool parameters with the default values specified when the tool was created.
MLClassify
public MLClassify(java.lang.Object inRasterBands,
java.lang.Object inSignatureFile,
java.lang.Object outClassifiedRaster)
- Creates the Maximum Likelihood Classification 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:
inRasterBands - the input raster bands.inSignatureFile - the input signature file whose class signatures are used by the maximum likelihood classifier. a .gsg extension is required.outClassifiedRaster - the output classified raster.
getInRasterBands
public java.lang.Object getInRasterBands()
- Returns the Input raster bands parameter of this tool .
This parameter is the input raster bands.
This is a required parameter.
- Returns:
- the Input raster bands
setInRasterBands
public void setInRasterBands(java.lang.Object inRasterBands)
- Sets the Input raster bands parameter of this tool .
This parameter is the input raster bands.
This is a required parameter.
- Parameters:
inRasterBands - the input raster bands.
getInSignatureFile
public java.lang.Object getInSignatureFile()
- Returns the Input signature file parameter of this tool .
This parameter is the input signature file whose class signatures are used by the maximum likelihood classifier. a .gsg extension is required.
This is a required parameter.
- Returns:
- the Input signature file
setInSignatureFile
public void setInSignatureFile(java.lang.Object inSignatureFile)
- Sets the Input signature file parameter of this tool .
This parameter is the input signature file whose class signatures are used by the maximum likelihood classifier. a .gsg extension is required.
This is a required parameter.
- Parameters:
inSignatureFile - the input signature file whose class signatures are used by the maximum likelihood classifier. a .gsg extension is required.
getOutClassifiedRaster
public java.lang.Object getOutClassifiedRaster()
- Returns the Output classified raster parameter of this tool .
This parameter is the output classified raster.
This is a required parameter.
- Returns:
- the Output classified raster
setOutClassifiedRaster
public void setOutClassifiedRaster(java.lang.Object outClassifiedRaster)
- Sets the Output classified raster parameter of this tool .
This parameter is the output classified raster.
This is a required parameter.
- Parameters:
outClassifiedRaster - the output classified raster.
getRejectFraction
public java.lang.String getRejectFraction()
- Returns the Reject fraction parameter of this tool .
This parameter is portion of cells that will remain unclassified due to the lowest possibility of correct assignments. the default is 0.0; therefore, every cell will be classified. the 14 valid entries are: 0.0, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 0.9, 0.95, 0.975, 0.99, and 0.995.
This is an optional parameter.
- Returns:
- the Reject fraction
setRejectFraction
public void setRejectFraction(java.lang.String rejectFraction)
- Sets the Reject fraction parameter of this tool .
This parameter is portion of cells that will remain unclassified due to the lowest possibility of correct assignments. the default is 0.0; therefore, every cell will be classified. the 14 valid entries are: 0.0, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 0.9, 0.95, 0.975, 0.99, and 0.995.
This is an optional parameter.
- Parameters:
rejectFraction - portion of cells that will remain unclassified due to the lowest possibility of correct assignments. the default is 0.0; therefore, every cell will be classified. the 14 valid entries are: 0.0, 0.005, 0.01, 0.025, 0.05, 0.1, 0.25, 0.5, 0.75, 0.9, 0.95, 0.975, 0.99, and 0.995.
getAPrioriProbabilities
public java.lang.String getAPrioriProbabilities()
- Returns the A priori probability weighting parameter of this tool .
This parameter is specifies how a priori probabilities will be determined.
This is an optional parameter.
- Returns:
- the A priori probability weighting
setAPrioriProbabilities
public void setAPrioriProbabilities(java.lang.String aPrioriProbabilities)
- Sets the A priori probability weighting parameter of this tool .
This parameter is specifies how a priori probabilities will be determined.
This is an optional parameter.
- Parameters:
aPrioriProbabilities - specifies how a priori probabilities will be determined.
getInAPrioriFile
public java.lang.Object getInAPrioriFile()
- Returns the Input a priori probability file parameter of this tool .
This parameter is a text file containing a priori probabilities for the input signature classes. an input for the a priori probability file is only required when the FILE option is used. the extension for the a priori file can be .txt or .asc.
This is an optional parameter.
- Returns:
- the Input a priori probability file
setInAPrioriFile
public void setInAPrioriFile(java.lang.Object inAPrioriFile)
- Sets the Input a priori probability file parameter of this tool .
This parameter is a text file containing a priori probabilities for the input signature classes. an input for the a priori probability file is only required when the FILE option is used. the extension for the a priori file can be .txt or .asc.
This is an optional parameter.
- Parameters:
inAPrioriFile - a text file containing a priori probabilities for the input signature classes. an input for the a priori probability file is only required when the FILE option is used. the extension for the a priori file can be .txt or .asc.
getOutConfidenceRaster
public java.lang.Object getOutConfidenceRaster()
- Returns the Output confidence raster parameter of this tool .
This parameter is output confidence raster dataset showing the certainty of the classification in 14 levels of confidence, with the lowest values representing the highest reliability.
This is an optional parameter.
- Returns:
- the Output confidence raster
setOutConfidenceRaster
public void setOutConfidenceRaster(java.lang.Object outConfidenceRaster)
- Sets the Output confidence raster parameter of this tool .
This parameter is output confidence raster dataset showing the certainty of the classification in 14 levels of confidence, with the lowest values representing the highest reliability.
This is an optional parameter.
- Parameters:
outConfidenceRaster - output confidence raster dataset showing the certainty of the classification in 14 levels of confidence, with the lowest values representing the highest reliability.
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