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
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 | A GeostatisticalDatasets object. Alternatively, it can be a semicolon-delimited string of elements. Each element is comprised of the following components:
| 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
- ArcGIS for Desktop Basic: Requires Geostatistical Analyst
- ArcGIS for Desktop Standard: Requires Geostatistical Analyst
- ArcGIS for Desktop Advanced: Requires Geostatistical Analyst