Skip To Content

Create Geostatistical Layer

Available with Geostatistical Analyst license.


Creates a new geostatistical layer. An existing geostatistical layer is required to populate the initial values for the new layer.


  • The Geostatistical model must be a geostatistical layer. The complete name of the dataset used to create the geostatistical layer is stored within the layer.

  • 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.

  • 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.


GACreateGeostatisticalLayer_ga (in_ga_model_source, in_datasets, out_layer)
ParameterExplanationData Type

The geostatistical model source to be analyzed.

File; Geostatistical Layer

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

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"
                                     "ca_ozone_pts.shp X=Shape Y=Shape F1=OZONE", 
CreateGeostatisticalLayer example 2 (stand-alone Python script)

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

# Name:
# 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"

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

Licensing information

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

Related topics