Create Geostatistical Layer (Geostatistical Analyst)

Available with Geostatistical Analyst license.

Summary

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

Usage

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

Parameters

LabelExplanationData Type
Input geostatistical model source

The geostatistical model source to be analyzed.

File; Geostatistical Layer
Input dataset(s)

The name of the input datasets and field names used in the creation of the output layer.

Geostatistical Value Table
Output geostatistical layer

The geostatistical layer produced by the tool.

Geostatistical Layer

arcpy.ga.GACreateGeostatisticalLayer(in_ga_model_source, in_datasets, out_layer)
NameExplanationData 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"

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

Licensing information

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

Related topics