ArcMap

Create Geostatistical Layer

Available with Geostatistical Analyst license.

Summary

Creates a new geostatistical layer. An existing geostatistical layer or geostatistical model is required to populate the initial values for the new layer. The input to this tool can be created using the Geostatistical Wizard.

Usage

  • The Geostatistical model source is either a geostatistical layer or a geostatistical model (XML). The complete name of the dataset used to create the geostatistical layer is stored within the layer. However, the XML file only contains the model parameters and not the dataset information. Geostatistical models (XML) can be saved from the Method Report screen at the end of the Geostatistical Wizard.

  • If the geostatistical model source uses a normal score transformation, the parameters of the transformation will be recalculated for the input datasets.

  • Layers can be input to the Input dataset(s) parameter. If you specify a layer, the selected features in the layer will be used to create the Geostatistical Layer. If you specify a path to a dataset on disk, all features in the dataset will be used.

  • In Python scripting, the GeostatisticalDatasets ArcPy class will be useful for populating the Input dataset(s) parameter.

  • All the Geostatistical Analyst geoprocessing tools are functional in ArcGlobe or ArcScene. However, a geostatistical layer can only be displayed using ArcMap or ArcCatalog and it is therefore recommended that geostatistical analysis be performed using these products.

  • For data formats that support Null values, such as file 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 should 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

arcpy.ga.GACreateGeostatisticalLayer(in_ga_model_source, in_datasets, out_layer)
ParameterExplanationData Type
in_ga_model_source

The geostatistical model source to be analyzed.

File; Geostatistical Layer
in_datasets

A GeostatisticalDatasets object.

Alternatively, it can be a semicolon-delimited string of elements. Each element is comprised of the following components:

  • The catalog path and name to a dataset or the name of a layer in the current table of contents, followed by a space.
  • A sequence of field names, each field name separated by a space. In the case of a raster, the cell values will be used.
Geostatistical Value Table
out_layer

The geostatistical layer produced by the tool.

Geostatistical Layer

Code sample

CreateGeostatisticalLayer example 1 (Python window)

Use an existing geostatistical layer to create a new geostatistical layer.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GACreateGeostatisticalLayer_ga("C:/gapyexamples/data/kriging.lyr", 
                                     "ca_ozone_pts.shp X=Shape Y=Shape F1=OZONE", 
                                     "outCGL")
CreateGeostatisticalLayer example 2 (stand-alone Python script)

Use an existing geostatistical layer to create a new geostatistical layer.

# Name: CreateGeostatisticalLayer_Example_02.py
# Description: Uses an existing geostatistical layer to create a new layer,
#              which includes a new feature dataset or variable.
# 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"
inData = "ca_ozone_pts.shp X=Shape Y=Shape F1=OZONE"
outLayer = "outCGL"

# Check out the ArcGIS Geostatistical Analyst extension license
arcpy.CheckOutExtension("GeoStats")

# Execute CreateGeostatisticalLayer
arcpy.GACreateGeostatisticalLayer_ga(inLayer, inData, outLayer)

Environments

Licensing information

  • Basic: Requires Geostatistical Analyst
  • Standard: Requires Geostatistical Analyst
  • Advanced: Requires Geostatistical Analyst

Related topics