Gaussian Geostatistical Simulations (Geostatisical Analyst)
Summary
Performs a conditional or unconditional geostatistical simulation based on a Simple Kriging model.
Usage
-
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:
- A Normal Score transformation of the data is recommended to ensure that the input data follows a standard normal distribution.
- Clustered data should be declustered (using either the cell or polygon with a clipping outline method) so that the input histogram accurately represents the sampled population. This histogram will be reproduced (on average) in the realizations.
-
To generate conditional realizations, the conditioning data should be the same as the data that was used to construct the Simple Kriging model from which the simulation will be based; however, other datasets can be used to condition the realizations.
-
Output generated by this tool can be identified as follows:
- The prefix followed by s0 to sN (where N is the number of realizations) is used to name the simulated rasters when the option Save simulated rasters has been selected.
- The prefix followed by MIN, MAX, MEAN, STDDEV, QUARTILE1, MEDIAN, QUARTILE3, QUANTILE, or P_THRSHLD is used to name the output rasters when these post-processing options have been selected.
- The prefix followed by the polygon feature class name is used to name the output polygon feature class when post-processing for areas of interest (statistical polygons) has been selected.
-
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 How Gaussian Geostatistical Simulations work.
-
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 Random Number Generator) 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 (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 be averaged, and the realizations will be conditioned to honor these (relatively) few average values.
If bounding features are supplied, any features or rasters supplied in the Mask environment will be ignored.
-
Current software limitations are as follows:
- The maximum raster size is limited to 20492 cells (that is, 2,049 rows by 2,049 columns for a square raster).
- The maximum number of realizations that can be requested in a single run is 4,500. Note that the maximum number of rasters that can be contained in a workspace is 4,999.
- Simulations based on periodical semivariogram models (J-Bessel and Hole Effect) may not be accurate.
-
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.
Syntax
| Parameter | Explanation | Data Type |
in_geostat_layer |
Input a geostatistical layer resulting from a Simple Kriging model. | Geostatistical Layer |
number_of_realizations |
The number of simulations to perform. | Long |
output_workspace |
Stores all the simulation results. | Workspace |
output_simulation_prefix |
A 1- to 3-character alphanumeric prefix that is automatically added to the output dataset names. | String |
in_conditioning_features (Optional) |
The features used to condition the realizations. If left blank, unconditional realizations are produced. | Feature Layer |
conditioning_field (Optional) |
The field used to condition the realizations. If left blank, unconditional realizations are produced. | Field |
conditioning_measurement_error_field (Optional) |
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. | Field |
cell_size (Optional) |
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. | Analysis Cell Size |
in_bounding_dataset (Optional) |
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. If bounding features are supplied, any features or rasters supplied in the Mask environment will be ignored. | Feature Layer |
save_simulated_rasters (Optional) |
Determines whether the simulated rasters are saved to disk or not. | Boolean |
quantile (Optional) |
The quantile value for which the output raster will be generated. | Double |
threshold (Optional) |
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. | Double |
in_stats_polygons (Optional) |
These polygons represent areas of interest for which summary statistics are calculated. | Feature Layer |
raster_stat_type [raster_stat_type,...] (Optional) |
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.
| String |
Code Sample
Perform an unconditional simulation.
import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GaussianGeostatisticalSimulations_ga("C:/gapyexamples/data/kriging.lyr", "10",
"C:/gapyexamples/output", "ggs", "", "",
"2000", "", "", "", "", "", "MEAN")
Perform an unconditional simulation.
# Name: GaussianGeostatisticalSimulations_Example_02.py
# Description: This tool performs conditional or unconditional geostatistical
# simulation based on a Simple Kriging model.
# Requirements: Geostatistical Analyst Extension
# Import system modules
import arcpy
# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"
# Set local variables
inLayer = "C:/gapyexamples/data/kriging.lyr"
numRealizations = 10
outWorkspace = "C:/gapyexamples/output"
cellSize = 2000
prefix = "ggs"
rasstatType = "MEAN"
conFeatures = ""
conField = ""
boundingData = ""
savesimRasters = ""
quantile = ""
threshold = ""
statsPolygons = ""
errorField = ""
# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")
# Execute GaussianGeostatisticalSimulations
arcpy.GaussianGeostatisticalSimulations_ga(
inLayer, numRealizations, outWorkspace, prefix, conFeatures, conField,
cellSize, boundingData, savesimRasters, quantile, threshold,
statsPolygons, rasstatType, errorField)