|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |
java.lang.Object com.esri.arcgis.geoanalyst.RasterReclassOp
public class RasterReclassOp
Raster Reclass operation class.
Constructor Summary | |
---|---|
RasterReclassOp()
Constructs a RasterReclassOp using ArcGIS Engine. |
|
RasterReclassOp(Object obj)
Deprecated. As of ArcGIS 9.2, replaced by normal Java casts. RasterReclassOp theRasterReclassOp = (RasterReclassOp) obj; |
Method Summary | |
---|---|
void |
addOutputDatasetName(int index,
IDatasetName pOutName)
Adds an output dataset name to the specified index. |
boolean |
equals(Object o)
Compare this object with another |
void |
getCellSize(int[] envType,
double[] cellSize)
Gets the type and value of cell size in the RasterAnalysis. |
static String |
getClsid()
getClsid. |
String |
getDefaultOutputRasterPrefix()
The default output raster prefix. |
String |
getDefaultOutputVectorPrefix()
The default output vector prefix. |
void |
getExtent(int[] envType,
IEnvelope[] extent)
Gets the type and values of extent in the RasterAnalysis. |
IGeoDataset |
getMask()
Mask allows processing to occur only for a selected set of cells. |
ISpatialReference |
getOutSpatialReference()
The output spatial reference of GeoAnalysis. |
IWorkspace |
getOutWorkspace()
The output workspace of GeoAnalysis. |
int |
getVerifyType()
The verify type of the RasterAnalysis. |
int |
hashCode()
the hashcode for this object |
void |
interfaceSupportsErrorInfo(GUID riid)
interfaceSupportsErrorInfo |
boolean |
isAvoidDataConversion()
Indicates weather to avoid data conversion in the RasterAnalysis. |
IGeoDataset |
lookup(IGeoDataset geoDataset,
String fieldName)
Creates a new raster by looking up values found in another field in the table of the input raster. |
IGeoDataset |
reclass(IGeoDataset geoDataset,
ITable remapTable,
String fromField,
String toField,
String outField,
boolean retainMissingValues)
Reclassifies (or changes) the values of the input cells of a raster by using a remap table. |
IGeoDataset |
reclassByASCIIFile(IGeoDataset inRaster,
String sRemapFile,
boolean retainMissingValues)
Reclassifies (or changes) the values of the input cells of a raster by using an ascii remap file. |
IGeoDataset |
reclassByRemap(IGeoDataset geoDataset,
IRemap remap,
boolean retainMissingValues)
Reclassifies (or changes) the values of the input cells of a raster by using a remap that is built programmatically. |
void |
reset()
Remove all previously stored default rasteranalysis environments. |
void |
restoreToPreviousDefaultEnvironment()
Restores to the previous default raster analysis environment. |
void |
setAsNewDefaultEnvironment()
Sets the raster analysis environment of the object as new default environment. |
void |
setAvoidDataConversion(boolean bAvoid)
Indicates weather to avoid data conversion in the RasterAnalysis. |
void |
setCellSize(int envType,
Object cellSizeProvider)
Sets the type and value of cell size in the RasterAnalysis. |
void |
setDefaultOutputRasterPrefix(String rasterPrefix)
The default output raster prefix. |
void |
setDefaultOutputVectorPrefix(String vectorPrefix)
The default output vector prefix. |
void |
setExtent(int envType,
Object extentProvider,
Object snapRasterData)
Sets the type and values of extent in the RasterAnalysis. |
void |
setMaskByRef(IGeoDataset mask)
Mask allows processing to occur only for a selected set of cells. |
void |
setOutputDatasetNameArrayByRef(IArray rhs1)
Puts output name array. |
void |
setOutSpatialReferenceByRef(ISpatialReference spatialReference)
The output spatial reference of GeoAnalysis. |
void |
setOutWorkspaceByRef(IWorkspace workspace)
The output workspace of GeoAnalysis. |
void |
setVerifyType(int verifyType)
The verify type of the RasterAnalysis. |
IGeoDataset |
slice(IGeoDataset geoDataset,
int sliceType,
int zoneCount,
Object baseZone)
Slices a range of values of the input cells by zones of equal area or equal interval. |
Methods inherited from class java.lang.Object |
---|
clone, finalize, getClass, notify, notifyAll, toString, wait, wait, wait |
Methods inherited from interface com.esri.arcgis.interop.RemoteObjRef |
---|
getJintegraDispatch, release |
Constructor Detail |
---|
public RasterReclassOp() throws IOException, UnknownHostException
IOException
- if there are interop problems
UnknownHostException
- if there are interop problemspublic RasterReclassOp(Object obj) throws IOException
RasterReclassOp theRasterReclassOp = (RasterReclassOp) obj;
obj
to RasterReclassOp
.
obj
- an object returned from ArcGIS Engine or Server
IOException
- if there are interop problemsMethod Detail |
---|
public static String getClsid()
public boolean equals(Object o)
equals
in class Object
public int hashCode()
hashCode
in class Object
public void setCellSize(int envType, Object cellSizeProvider) throws IOException, AutomationException
envType |
An enumeration type specifying the raster cellsize environment settings for analysis. All subsequent results will be to the value specified. It can be of type esriRasterEnvMaxOf – The largest cell size of all input raster datasets that are specifed in the function. This is the default. This option is not suitable for methods such as IInterpolationOp::IDW, IDensityOp:KernalDensity etc. where features are the only inputs. Use esriRasterEnvValue instead. esriRasterEnvMinOf - Smallest cell size of all input raster datasets. This option is not suitable for methods such as IInterpolationOp::IDW, IDensityOp:KernalDensity etc. where features are the only inputs. Use esriRasterEnvValue instead esriRasterEnvValue - Any user specified value for the cell size. Use this option to specify a particular value for a cell size or for methods such as IInterpolationOp::IDW, IDensityOp:KernalDensity etc. where features are the only input. |
[cellSizeProvider] |
A specified value (double) or RasterDataset that is used to provide the cellsize environment value. |
setCellSize
in interface IRasterAnalysisEnvironment
envType
- A com.esri.arcgis.geoanalyst.esriRasterEnvSettingEnum constant (in)cellSizeProvider
- A Variant (in, optional, pass null if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void getCellSize(int[] envType, double[] cellSize) throws IOException, AutomationException
envType |
will return an enumeration type constant specifying the raster cellsize environment settings for analysis. It can be of type esriRasterEnvMaxOf - largest cell size of all input datasets. This is the default. esriRasterEnvMinOf - smallest cell size of all input datasets esriRasterEnvValue - User specified value. |
cellsize |
returns a value that specifying the current environment setting for cellsize |
getCellSize
in interface IRasterAnalysisEnvironment
envType
- A com.esri.arcgis.geoanalyst.esriRasterEnvSettingEnum constant (out: use single element array)cellSize
- The cellSize (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setExtent(int envType, Object extentProvider, Object snapRasterData) throws IOException, AutomationException
envType |
An enumeration type specifying the raster extent environment settings for analysis. All subsequent results will be to this extent. It can be of type esriRasterEnvMinOf – Intersection of Inputs - All input feature extents are intersected and the extent common to all is used as the extent values for the study area. This is the default. esriRasterEnvMaxOf - Union of Inputs - All input feature extents are combined and the outer extent of the union is used. esriRasterEnvValue - Value - User specified values for the Left, Right, Top and Bottom extent (x, y values) of the study area. |
[extentProvider] |
An envelope object supporting IEnvelope interface or RasterDataset that is used to provide the environment values of the analysis extent. |
[snapRasterData] |
A RasterDataset that can be used to snap all output raster datasets to the cell registration of the specified raster. All subsequent results will share the lower-left corner and cell size of the specified raster. |
setExtent
in interface IRasterAnalysisEnvironment
envType
- A com.esri.arcgis.geoanalyst.esriRasterEnvSettingEnum constant (in)extentProvider
- A Variant (in, optional, pass null if not required)snapRasterData
- A Variant (in, optional, pass null if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void getExtent(int[] envType, IEnvelope[] extent) throws IOException, AutomationException
envType |
will return an enumeration constant specifying the raster extent environment settings for analysis. It can be of type, esriRasterEnvMinOf – Intersection of Inputs - All input feature extents are intersected and the extent common to all is used as the extent values for the study area. This is the default. esriRasterEnvMaxOf - Union of Inputs - All input feature extents are combined and the outer extent of the union is used. esriRasterEnvValue - Value - User specified values for the Left, Right, Top and Bottom extent (x, y values) of the study area. |
extent |
An envelope object supporting IEnvelope interface used to describe the values of the analysis extent. |
getExtent
in interface IRasterAnalysisEnvironment
envType
- A com.esri.arcgis.geoanalyst.esriRasterEnvSettingEnum constant (out: use single element array)extent
- A reference to a com.esri.arcgis.geometry.IEnvelope (out: use single element array)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setMaskByRef(IGeoDataset mask) throws IOException, AutomationException
setMaskByRef
in interface IRasterAnalysisEnvironment
mask
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset getMask() throws IOException, AutomationException
The mask can be a reference to a Raster, RasterDataset, RasterBand, or RasterDescriptor object or FeatureClass, FeatureClassDescriptor object.
The mask identifies only those cells within the analysis extent that will be considered when performing an action. Only the identified cells will be processed in subsequent output raster datasets. All other cells are characterized as nodata.
getMask
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setVerifyType(int verifyType) throws IOException, AutomationException
setVerifyType
in interface IRasterAnalysisEnvironment
verifyType
- A com.esri.arcgis.geoanalyst.esriRasterVerifyEnum constant (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public int getVerifyType() throws IOException, AutomationException
The value is an enumeration environment setting that contols the way that an output RasterDatasets are written to file when during analysis. The verify enumeration can be of type
esriRasterEnvVerifyOn - specifies that the user will be prompted to verify the output already exists and it is okay to overwrite it
esriRasterEnvVerifyOff - specifies that output data will be automatically overwritten if already exists. This is the default environment setting.
esriRasterEnvVerifyError - specifies that an error will be produced when the output already exists.
getVerifyType
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getDefaultOutputRasterPrefix() throws IOException, AutomationException
The user specified prefix which is included to all temporary output RasterDatasets during analysis.
getDefaultOutputRasterPrefix
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setDefaultOutputRasterPrefix(String rasterPrefix) throws IOException, AutomationException
setDefaultOutputRasterPrefix
in interface IRasterAnalysisEnvironment
rasterPrefix
- The rasterPrefix (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public String getDefaultOutputVectorPrefix() throws IOException, AutomationException
The user specified prefix which is included to all temporary output Shapefiles during analysis.
getDefaultOutputVectorPrefix
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setDefaultOutputVectorPrefix(String vectorPrefix) throws IOException, AutomationException
setDefaultOutputVectorPrefix
in interface IRasterAnalysisEnvironment
vectorPrefix
- The vectorPrefix (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setAsNewDefaultEnvironment() throws IOException, AutomationException
Will set all current environment settings of the RasterAnalysis object as the new default environment. All subsequent analysis will use the set object properties unless otherwise specified.
setAsNewDefaultEnvironment
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void restoreToPreviousDefaultEnvironment() throws IOException, AutomationException
This will restore the default environment to the settings of the "previous" RasterAnalysisEnvironment object used to set the default environement. Note: If multiple default environments have been set it will reference the past settings one at a time in order of sequence.
restoreToPreviousDefaultEnvironment
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void reset() throws IOException, AutomationException
This method can be used to restore the system default raster environment settings for extent, cell size, precision, spatial reference and/or current workspace for analysis. This will change all previously altered environment settings made to the RasterAnlaysis object back to the original settings.
reset
in interface IRasterAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setOutWorkspaceByRef(IWorkspace workspace) throws IOException, AutomationException
setOutWorkspaceByRef
in interface IGeoAnalysisEnvironment
workspace
- A reference to a com.esri.arcgis.geodatabase.IWorkspace (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IWorkspace getOutWorkspace() throws IOException, AutomationException
The variable is an object specifying the directory or subdirectory to contain the output rasterdataset
getOutWorkspace
in interface IGeoAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setOutSpatialReferenceByRef(ISpatialReference spatialReference) throws IOException, AutomationException
setOutSpatialReferenceByRef
in interface IGeoAnalysisEnvironment
spatialReference
- A reference to a com.esri.arcgis.geometry.ISpatialReference (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public ISpatialReference getOutSpatialReference() throws IOException, AutomationException
The variable references an object that specifies the output features spatial reference. If not explicitly set the spatial reference of the input features will be used.
getOutSpatialReference
in interface IGeoAnalysisEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setAvoidDataConversion(boolean bAvoid) throws IOException, AutomationException
Setting to false (the default setting) is the same as in versions before ArcGIS 9.4.
Setting the property to True ensures that all processing is performed natively on the raster data. This improves the overall performance as there is no need for the input data to be converted to ESRI grid format. The output data, however, is still temporary rasters in ESRI grid format.
setAvoidDataConversion
in interface IRasterAnalysisGlobalEnvironment
bAvoid
- The bAvoid (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public boolean isAvoidDataConversion() throws IOException, AutomationException
isAvoidDataConversion
in interface IRasterAnalysisGlobalEnvironment
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void addOutputDatasetName(int index, IDatasetName pOutName) throws IOException, AutomationException
addOutputDatasetName
in interface IRasterOpBase
index
- The index (in)pOutName
- A reference to a com.esri.arcgis.geodatabase.IDatasetName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void setOutputDatasetNameArrayByRef(IArray rhs1) throws IOException, AutomationException
setOutputDatasetNameArrayByRef
in interface IRasterOpBase
rhs1
- A reference to a com.esri.arcgis.system.IArray (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset reclass(IGeoDataset geoDataset, ITable remapTable, String fromField, String toField, String outField, boolean retainMissingValues) throws IOException, AutomationException
geoDataset |
an input Raster, RasterDataset, RasterBand, or RasterDescriptor The values contained in this Raster will be the values to be reclassified. |
remapTable |
A table used to identify the input cell values, or range of values, to be reclassified and their respective reclassified output values. "From" and "To" fields define the input cell ranges to be reclassified and the "Out" field is used to specify a new reclassified output value. These fields are used in the fromField, toField and outField parameters. A sample table format is,
|
fromField |
Specifies the field in the remapTable for the start of each range to be used to correlate the values on the input Raster that will be reclassed. For example, the "From" field in the above sample table. |
toField |
Specifies the field in the remapTable for the end of each range to be used to correlate the values on the input Raster that will be reclassed. For example, the "To" field in the above sample table. |
outField |
Specifies the field in the remapTable that is to be used to change or reclass the input values, or range of values, to the values contained in the outField. For example, the "Out" field in the above sample table. |
retainMissingValues |
Defines the manner in which values not present in the remapTable will be handled If True, then if any cell location on the input Raster contains a value that is not present or reclassed in the remap table, the value should remain intact and be written for that location to the output Raster. If False, then if any cell location on the input Raster contains a value that is not present or reclassed in the remap table, the value will be reclassed to NoData for that location on the output Raster. |
Note:
reclass
in interface IReclassOp
geoDataset
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)remapTable
- A reference to a com.esri.arcgis.geodatabase.ITable (in)fromField
- The fromField (in)toField
- The toField (in)outField
- The outField (in)retainMissingValues
- The retainMissingValues (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset slice(IGeoDataset geoDataset, int sliceType, int zoneCount, Object baseZone) throws IOException, AutomationException
geoDataset |
an input Raster, RasterDataset, RasterBand, or RasterDescriptor The values contained in this Raster will be the values that are sliced. |
sliceType |
An esriGeoAnalysisSliceEnum specifying the manner in which to slice the values in the input geoDataset. EsriGeoAnalysisSliceEqualArea - EqualArea specifies that the input values will be divided into the number of zones specified by zoneCount with each zone having a similar number of cells - each zone represents a similar amount of area. EsriGeoAnalysisSliceEqualInterval - The EqualInterval slice determines the range of the input values and divides the range into zoneCount. Each zone on the sliced output raster has the potential of having input cell values that have the same range from the extremes. EsriGeoAnalysisSliceNaturalBreaks - The NaturalNeighbor slice specifies that the classes will be based on natural groupings inherent in the data. Break points are identified by picking the class breaks that best group similar values and maximize the differences between classes. The cell values are divided into classes whose boundaries are set where there are relatively big jumps in the data values |
zoneCount |
Defines the number of zones that should be used with the calculations for the slicing method. When the sliceType EqualArea is used, the output raster will have zoneCounts with similar numbers of cells. When the sliceType EqualInterval is used, the output Raster will have zoneCounts, each containing equal value ranges on the output raster. When the sliceType NaturalBreaks is used, the output raster will have zonesCounts, with the number of cells in each determined by the class breaks |
baseZone |
When the sliceTypes EqualArea, EqualInterval and NaturalBreaks are used, the number that is input for the baseZone identifies the value to begin assigning to the output sliced zones. The zones will begin with the value assigned to the baseZone and increment by 1. If no base zone is specified, slice will begin the assignment at value 1. |
slice
in interface IReclassOp
geoDataset
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)sliceType
- A com.esri.arcgis.geoanalyst.esriGeoAnalysisSliceEnum constant (in)zoneCount
- The zoneCount (in)baseZone
- A Variant (in, optional, pass null if not required)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset lookup(IGeoDataset geoDataset, String fieldName) throws IOException, AutomationException
GeoDataset |
the input Raster, RasterDataset, RasterBand, or RasterDescriptor |
FieldName |
the name of the field that contains the values upon which the input geodataset will be classified. |
lookup
in interface IReclassOp
geoDataset
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)fieldName
- The fieldName (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset reclassByRemap(IGeoDataset geoDataset, IRemap remap, boolean retainMissingValues) throws IOException, AutomationException
GeoDataset |
the input Raster, RasterDataset, RasterBand, or RasterDescriptor |
Remap |
the input remap object that supports IRemap interface. If reclassifying number or string values use the NumberRemap or StringRemap objects respectively. |
retainMissingValues |
a Boolean specifying whether to keep missing values in the analysis. If TRUE, values that have been omitted are given a NODATA value in output raster If FALSE, values that have been omitted are retained and unchanged in the output raster. |
reclassByRemap
in interface IReclassOp
geoDataset
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)remap
- A reference to a com.esri.arcgis.geoanalyst.IRemap (in)retainMissingValues
- The retainMissingValues (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public IGeoDataset reclassByASCIIFile(IGeoDataset inRaster, String sRemapFile, boolean retainMissingValues) throws IOException, AutomationException
inRaster |
the input Raster, RasterDataset, RasterBand, or RasterDescriptor |
sRemapFile |
the input ASCII file of specific format on which to classify the inRaster. |
retainMissingValues |
a Boolean specifying whether to keep missing values in the analysis. If TRUE, values that have been omitted are given a NODATA value in output raster If FALSE, values that have been omitted are retained and unchanged in the output raster. |
reclassByASCIIFile
in interface IReclassOp
inRaster
- A reference to a com.esri.arcgis.geodatabase.IGeoDataset (in)sRemapFile
- The sRemapFile (in)retainMissingValues
- The retainMissingValues (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.public void interfaceSupportsErrorInfo(GUID riid) throws IOException, AutomationException
Indicates whether the interface supports IErrorInfo.
interfaceSupportsErrorInfo
in interface ISupportErrorInfo
riid
- A Structure: com.esri.arcgis.support.ms.stdole.GUID (in)
IOException
- If there are interop problems.
AutomationException
- If the ArcObject component throws an exception.
|
|||||||||
PREV CLASS NEXT CLASS | FRAMES NO FRAMES | ||||||||
SUMMARY: NESTED | FIELD | CONSTR | METHOD | DETAIL: FIELD | CONSTR | METHOD |