Create Geostatistical Layer (Geostatisical Analyst)

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.

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

GACreateGeostatisticalLayer_ga (in_ga_model_source, in_datasets, out_layer)

Parameter	Explanation	Data Type
in_ga_model_source	The geostatistical model source to be analyzed.	File; Geostatistical Layer
in_datasets "feature_class field {field}; feature_class field {field}; ..."	A semicolon-delimited string of elements. Each element contains: The path to a dataset or the name of a layer in the current table of contents, followed by a space. A list of fields, each field name separated by a space, unless the dataset is a raster.	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

Coincident Points, Current Workspace, Extent

Licensing Information

ArcView: Requires Geostatistical Analyst

ArcEditor: Requires Geostatistical Analyst

ArcInfo: Requires Geostatistical Analyst