com.esri.arcgis.geoprocessing.tools.geostatisticalanalysttools
Class GaussianGeostatisticalSimulations

java.lang.Object
  com.esri.arcgis.geoprocessing.AbstractGPTool
      com.esri.arcgis.geoprocessing.tools.geostatisticalanalysttools.GaussianGeostatisticalSimulations

All Implemented Interfaces:

GPTool

public class GaussianGeostatisticalSimulations
extends AbstractGPTool

Performs a conditional or unconditional geostatistical simulation based on a Simple Kriging model. The Gaussian Geostatistical Simulations tool is contained in the Geostatistical Analyst Tools tool box.

Usage tips:

• The input geostatistical layer must be the result of performing Simple Kriging on a dataset. Geostatistical layers resulting from other types of kriging cannot be used with this tool.Additionally:
• To generate conditional realizations, the conditioning data should be the same as the data that was used to construct the Simple Kriging model that the simulation will be based on. However, other datasets can be used to condition the realizations.
• Output generated by this tool can be identified as follows:
• Use different prefixes to identify output from different simulation runs. If you use the same prefix, all previous results starting with that prefix will be erased before the new results are created. Alternatively, the output from different simulation runs can be stored in separate folders.
• If selected, the polygon output feature class will contain summary statistics of the values simulated within each polygon. To learn more about these summary statistics, refer to .
• Polygons representing areas of interest must be fully contained within the simulated raster's extent. If any portion of a polygon is covered by NoData values in the simulated rasters, the polygon attribute table will contain invalid results. In this case, the CELL_COUNT field will show the number of cells within the polygon that have simulated values, and the number will be expressed as a negative value.
• The Seed value (set in the Environment variables—see ) specifies the sequence of random numbers used in a simulation. By default, the Seed value is set to 0, so that each simulation will use a new sequence of random numbers. If the Seed is set to a value greater than 0, the simulation results will be replicated until the Seed value is changed. Setting the Seed to a value other than 0 may be useful when the results of a simulation study need to be replicated.
• If you have opted to save the simulated rasters, only the first two will be added to the table of contents in ArcMap. You can, however, browse to the output workspace and add the rest.
• The Environment setting for handling Coincident Points (under Geostatistical Analyst Settings) does not affect the results of unconditional or conditional simulations. Input datasets with coincident points are managed in the Geostatistical Wizard when the Simple Kriging layer (that will be used as input for the simulation) is built.
• For conditional simulations, points of the conditioning dataset that fall inside the same cell will be averaged, and the realizations will be conditioned to honor that average value. If the output cell size is large, many points will fall inside each cell and will be averaged, and the realizations will be conditioned to honor these (relatively) few average values.
• Current software limitations are as follows:
• An error of Not enough memory to execute requested operation might indicate that the cell size requested will produce an output raster that is too large.
• For data formats that support Null values, such as file and personal geodatabase feature classes, a Null value will be used to indicate that a prediction could not be made for that location or that the value showed be ignored when used as input. For data formats that do not support Null values, such as shapefiles, the value of -1.7976931348623158e+308 is used (this is the negative of the C++ defined constant DBL_MAX) to indicate that a prediction could not be made for that location.

Field Summary

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

vals

Constructor Summary

GaussianGeostatisticalSimulations()
Creates the Gaussian Geostatistical Simulations tool with defaults.

GaussianGeostatisticalSimulations(Object inGeostatLayer, int numberOfRealizations, Object outputWorkspace, String outputSimulationPrefix)
Creates the Gaussian Geostatistical Simulations tool with the required parameters.

Method Summary

Object	getCellSize() Returns the Output cell size parameter of this tool .
Object	getConditioningField() Returns the Conditioning field parameter of this tool .
Object	getConditioningMeasurementErrorField() Returns the Conditioning measurement error field parameter of this tool .
Object	getInBoundingDataset() Returns the Bounding feature class parameter of this tool .
Object	getInConditioningFeatures() Returns the Conditioning dataset parameter of this tool .
Object	getInGeostatLayer() Returns the Input geostatistical layer parameter of this tool .
Object	getInStatsPolygons() Returns the Input statistical polygons parameter of this tool .
int	getNumberOfRealizations() Returns the Number of realizations parameter of this tool .
double	getOutConvergenceValue() Returns the Convergence parameter of this tool (Read only).
Object	getOutPolygonStat() Returns the Output statistical polygons parameter of this tool (Read only).
String	getOutputSimulationPrefix() Returns the Output simulation prefix parameter of this tool .
Object	getOutputWorkspace() Returns the Output workspace parameter of this tool .
Object	getOutRasterSimulation() Returns the Output simulation rasters parameter of this tool (Read only).
Object	getOutRasterStat() Returns the Output statistical rasters parameter of this tool (Read only).
Object	getOutWorkspace() Returns the Output workspace parameter of this tool (Read only).
double	getQuantile() Returns the Quantile (0
Object	getRasterStatType() Returns the Raster statistics type parameter of this tool .
String	getSaveSimulatedRasters() Returns the Save simulated rasters parameter of this tool .
double	getThreshold() Returns the Threshold 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	setCellSize(Object cellSize) Sets the Output cell size parameter of this tool .
void	setConditioningField(Object conditioningField) Sets the Conditioning field parameter of this tool .
void	setConditioningMeasurementErrorField(Object conditioningMeasurementErrorField) Sets the Conditioning measurement error field parameter of this tool .
void	setInBoundingDataset(Object inBoundingDataset) Sets the Bounding feature class parameter of this tool .
void	setInConditioningFeatures(Object inConditioningFeatures) Sets the Conditioning dataset parameter of this tool .
void	setInGeostatLayer(Object inGeostatLayer) Sets the Input geostatistical layer parameter of this tool .
void	setInStatsPolygons(Object inStatsPolygons) Sets the Input statistical polygons parameter of this tool .
void	setNumberOfRealizations(int numberOfRealizations) Sets the Number of realizations parameter of this tool .
void	setOutputSimulationPrefix(String outputSimulationPrefix) Sets the Output simulation prefix parameter of this tool .
void	setOutputWorkspace(Object outputWorkspace) Sets the Output workspace parameter of this tool .
void	setQuantile(double quantile) Sets the Quantile (0
void	setRasterStatType(Object rasterStatType) Sets the Raster statistics type parameter of this tool .
void	setSaveSimulatedRasters(String saveSimulatedRasters) Sets the Save simulated rasters parameter of this tool .
void	setThreshold(double threshold) Sets the Threshold 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

GaussianGeostatisticalSimulations

public GaussianGeostatisticalSimulations()

Creates the Gaussian Geostatistical Simulations tool with defaults.

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

GaussianGeostatisticalSimulations

public GaussianGeostatisticalSimulations(Object inGeostatLayer,
                                         int numberOfRealizations,
                                         Object outputWorkspace,
                                         String outputSimulationPrefix)

Creates the Gaussian Geostatistical Simulations 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:

inGeostatLayer - input a geostatistical layer resulting from a Simple Kriging model.

numberOfRealizations - the number of simulations to perform.

outputWorkspace - stores all the simulation results.

outputSimulationPrefix - a 1- to 3-character alphanumeric prefix that is automatically added to the output dataset names.

Method Detail

getInGeostatLayer

public Object getInGeostatLayer()

Returns the Input geostatistical layer parameter of this tool . This parameter is input a geostatistical layer resulting from a Simple Kriging model. This is a required parameter.

Returns:

the Input geostatistical layer

setInGeostatLayer

public void setInGeostatLayer(Object inGeostatLayer)

Sets the Input geostatistical layer parameter of this tool . This parameter is input a geostatistical layer resulting from a Simple Kriging model. This is a required parameter.

Parameters:

inGeostatLayer - input a geostatistical layer resulting from a Simple Kriging model.

getNumberOfRealizations

public int getNumberOfRealizations()

Returns the Number of realizations parameter of this tool . This parameter is the number of simulations to perform. This is a required parameter.

Returns:

the Number of realizations

setNumberOfRealizations

public void setNumberOfRealizations(int numberOfRealizations)

Sets the Number of realizations parameter of this tool . This parameter is the number of simulations to perform. This is a required parameter.

Parameters:

numberOfRealizations - the number of simulations to perform.

getOutputWorkspace

public Object getOutputWorkspace()

Returns the Output workspace parameter of this tool . This parameter is stores all the simulation results. This is a required parameter.

Returns:

the Output workspace

setOutputWorkspace

public void setOutputWorkspace(Object outputWorkspace)

Sets the Output workspace parameter of this tool . This parameter is stores all the simulation results. This is a required parameter.

Parameters:

outputWorkspace - stores all the simulation results.

getOutputSimulationPrefix

public String getOutputSimulationPrefix()

Returns the Output simulation prefix parameter of this tool . This parameter is a 1- to 3-character alphanumeric prefix that is automatically added to the output dataset names. This is a required parameter.

Returns:

the Output simulation prefix

setOutputSimulationPrefix

public void setOutputSimulationPrefix(String outputSimulationPrefix)

Sets the Output simulation prefix parameter of this tool . This parameter is a 1- to 3-character alphanumeric prefix that is automatically added to the output dataset names. This is a required parameter.

Parameters:

outputSimulationPrefix - a 1- to 3-character alphanumeric prefix that is automatically added to the output dataset names.

getInConditioningFeatures

public Object getInConditioningFeatures()

Returns the Conditioning dataset parameter of this tool . This parameter is the features used to condition the realizations. If left blank, unconditional realizations are produced. This is an optional parameter.

Returns:

the Conditioning dataset

setInConditioningFeatures

public void setInConditioningFeatures(Object inConditioningFeatures)

Sets the Conditioning dataset parameter of this tool . This parameter is the features used to condition the realizations. If left blank, unconditional realizations are produced. This is an optional parameter.

Parameters:

inConditioningFeatures - the features used to condition the realizations. If left blank, unconditional realizations are produced.

getConditioningField

public Object getConditioningField()

Returns the Conditioning field parameter of this tool . This parameter is the field used to condition the realizations. If left blank, unconditional realizations are produced. This is an optional parameter.

Returns:

the Conditioning field

setConditioningField

public void setConditioningField(Object conditioningField)

Sets the Conditioning field parameter of this tool . This parameter is the field used to condition the realizations. If left blank, unconditional realizations are produced. This is an optional parameter.

Parameters:

conditioningField - the field used to condition the realizations. If left blank, unconditional realizations are produced.

getCellSize

public Object getCellSize()

Returns the Output cell size parameter of this tool . This parameter is the cell size at which the output raster will be created. this value can be explicitly set under Raster Analysis from the Environment Settings. If not set, it is the shorter of the width or the height of the extent of the input point features, in the input spatial reference, divided by 250. This is an optional parameter.

Returns:

the Output cell size

setCellSize

public void setCellSize(Object cellSize)

Sets the Output cell size parameter of this tool . This parameter is the cell size at which the output raster will be created. this value can be explicitly set under Raster Analysis from the Environment Settings. If not set, it is the shorter of the width or the height of the extent of the input point features, in the input spatial reference, divided by 250. This is an optional parameter.

Parameters:

cellSize - the cell size at which the output raster will be created. this value can be explicitly set under Raster Analysis from the Environment Settings. If not set, it is the shorter of the width or the height of the extent of the input point features, in the input spatial reference, divided by 250.

getInBoundingDataset

public Object getInBoundingDataset()

Returns the Bounding feature class parameter of this tool . This parameter is limits the analysis to these features' bounding polygon. If point features are entered, then a convex hull polygon is automatically created. Realizations are then performed within that polygon. This is an optional parameter.

Returns:

the Bounding feature class

setInBoundingDataset

public void setInBoundingDataset(Object inBoundingDataset)

Sets the Bounding feature class parameter of this tool . This parameter is limits the analysis to these features' bounding polygon. If point features are entered, then a convex hull polygon is automatically created. Realizations are then performed within that polygon. This is an optional parameter.

Parameters:

inBoundingDataset - limits the analysis to these features' bounding polygon. If point features are entered, then a convex hull polygon is automatically created. Realizations are then performed within that polygon.

getSaveSimulatedRasters

public String getSaveSimulatedRasters()

Returns the Save simulated rasters parameter of this tool . This parameter is determines whether the simulated rasters are saved to disk or not. This is an optional parameter.

Returns:

the Save simulated rasters

setSaveSimulatedRasters

public void setSaveSimulatedRasters(String saveSimulatedRasters)

Sets the Save simulated rasters parameter of this tool . This parameter is determines whether the simulated rasters are saved to disk or not. This is an optional parameter.

Parameters:

saveSimulatedRasters - determines whether the simulated rasters are saved to disk or not.

getQuantile

public double getQuantile()

Returns the Quantile (0

Returns:

the Quantile (0

setQuantile

public void setQuantile(double quantile)

Sets the Quantile (0

Parameters:

quantile - the quantile value for which the output raster will be generated.

getThreshold

public double getThreshold()

Returns the Threshold parameter of this tool . This parameter is the threshold value for which the output raster will be generated, as the percentage of the number of times the set threshold was exceeded, on a cell by cell basis. This is an optional parameter.

Returns:

the Threshold

setThreshold

public void setThreshold(double threshold)

Sets the Threshold parameter of this tool . This parameter is the threshold value for which the output raster will be generated, as the percentage of the number of times the set threshold was exceeded, on a cell by cell basis. This is an optional parameter.

Parameters:

threshold - the threshold value for which the output raster will be generated, as the percentage of the number of times the set threshold was exceeded, on a cell by cell basis.

getInStatsPolygons

public Object getInStatsPolygons()

Returns the Input statistical polygons parameter of this tool . This parameter is these polygons represent areas of interest for which summary statistics are calculated. This is an optional parameter.

Returns:

the Input statistical polygons

setInStatsPolygons

public void setInStatsPolygons(Object inStatsPolygons)

Sets the Input statistical polygons parameter of this tool . This parameter is these polygons represent areas of interest for which summary statistics are calculated. This is an optional parameter.

Parameters:

inStatsPolygons - these polygons represent areas of interest for which summary statistics are calculated.

getRasterStatType

public Object getRasterStatType()

Returns the Raster statistics type parameter of this tool . This parameter is the simulated rasters are post-processed on a cell by cell basis and each selected statistics type is calculated and reported in an output raster. This is an optional parameter.

Returns:

the Raster statistics type

setRasterStatType

public void setRasterStatType(Object rasterStatType)

Sets the Raster statistics type parameter of this tool . This parameter is the simulated rasters are post-processed on a cell by cell basis and each selected statistics type is calculated and reported in an output raster. This is an optional parameter.

Parameters:

rasterStatType - the simulated rasters are post-processed on a cell by cell basis and each selected statistics type is calculated and reported in an output raster.

getConditioningMeasurementErrorField

public Object getConditioningMeasurementErrorField()

Returns the Conditioning measurement error field parameter of this tool . This parameter is specifies a constant measurement error for all input data in the input semivariogram model. Use this field if the measurement error values are not the same at each sampling location. The input's unit of measurement is applied. leave this blank if there are no measurement error values. This is an optional parameter.

Returns:

the Conditioning measurement error field

setConditioningMeasurementErrorField

public void setConditioningMeasurementErrorField(Object conditioningMeasurementErrorField)

Sets the Conditioning measurement error field parameter of this tool . This parameter is specifies a constant measurement error for all input data in the input semivariogram model. Use this field if the measurement error values are not the same at each sampling location. The input's unit of measurement is applied. leave this blank if there are no measurement error values. This is an optional parameter.

Parameters:

conditioningMeasurementErrorField - specifies a constant measurement error for all input data in the input semivariogram model. Use this field if the measurement error values are not the same at each sampling location. The input's unit of measurement is applied. leave this blank if there are no measurement error values.

getOutWorkspace

public Object getOutWorkspace()

Returns the Output workspace parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output workspace

getOutPolygonStat

public Object getOutPolygonStat()

Returns the Output statistical polygons parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output statistical polygons

getOutRasterSimulation

public Object getOutRasterSimulation()

Returns the Output simulation rasters parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output simulation rasters

getOutRasterStat

public Object getOutRasterStat()

Returns the Output statistical rasters parameter of this tool (Read only). This is an derived parameter.

Returns:

the Output statistical rasters

getOutConvergenceValue

public double getOutConvergenceValue()

Returns the Convergence parameter of this tool (Read only). This is an derived parameter.

Returns:

the Convergence

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