ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

GA Layer To Points

Available with Geostatistical Analyst license.

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Exports a geostatistical layer to points. The tool can also be used to predict values at unmeasured locations or to validate predictions made at measured locations.

Usage

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

  • The fields in the output feature class can include the following (where applicable):

    • Source_ID
      • The feature or object identifier of the input dataset that was used.
    • Included—The values in this field can be one of the following:
      • Yes—There are no problems making a prediction at this point.
      • Not enough neighbors—There are not enough neighbors to make a prediction.
      • Weight parameter is too small—The weight parameter is too small.
      • Overfilling—Overflow of floating point calculations.
      • Problem with data transformation—The value to be transformed is outside of supported range for the selected transformation (only in kriging).
    • Predicted—The prediction value at this location.
    • Error—The predicted value minus the value in the validation field.
    • StdError—The kriging standard error.
    • Stdd_Error—The standardized prediction errors. Ideally, the standardized prediction errors are distributed normally.
    • NormValue—The normal distribution value (x axis) that corresponds to the standardized prediction errors (y axis) in the normal QQplot.
  • If a validation z-field is supplied, the predictions and standard errors are calculated differently than if a validation field is not supplied. For more information, see the following reference:

    • Krivoruchko, K., A. Gribov, and J. M. Ver Hoef, 2006, "A new method for handling the nugget effect in kriging," T. C. Coburn, J. M. Yarus, and R. L. Chambers, Eds., Stochastic modeling and geostatistics: Principles, methods, and case studies, volume II: AAPG Computer Applications and Geology 5, p. 81-89.

Syntax

GALayerToPoints_ga (in_geostat_layer, in_locations, {z_field}, out_feature_class, {append_all_fields})
ParameterExplanationData Type
in_geostat_layer

The geostatistical layer to be analyzed.

Geostatistical Layer
in_locations

Point locations where predictions or validations will be performed.

Feature Layer
z_field
(Optional)

If this field is left blank, predictions are made at the location points. If a field is selected, predictions are made at the location points and compared to their Z_value_field values and a validation analysis is performed.

Field
out_feature_class

The output feature class containing either the predictions or the predictions and the validation results.

Feature Class
append_all_fields
(Optional)

Determines whether all fields will be copied from the input features to the output feature class.

  • ALL — All fields from the input features will be copied to the output feature class. This is the default.
  • FID_ONLY — Only the feature ID will be copied, and it will be named Source_ID on the output feature class.
Boolean

Code Sample

GALayerToPoints (Python window)

Export a geostatistical layer to a point feature class.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.GALayerToPoints_ga("C:/gapyexamples/data/kriging.lyr", 
                         "C:/gapyexamples/data/obs_pts.shp",                   
                         "", "C:/gapyexamples/output/krig_pts")
GALayerToPoints (stand-alone script)

Export a geostatistical layer to a point feature class.

# Name: GALayerToPoints_Example_02.py
# Description: Exports a geostatistical layer to points.
# 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"
inPoints = "C:/gapyexamples/data/obs_pts.shp"
zField = ""
outPoints = "C:/gapyexamples/output/krig_pts"

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

# Execute GALayerToPoints
arcpy.GALayerToPoints_ga(inLayer, inPoints, zField, outPoints)

Environments

  • Current Workspace
  • Extent
  • Geographic Transformations
  • Output Coordinate System
  • Scratch Workspace

Licensing Information

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

Related Topics

  • An overview of the Working With Geostatistical Layers toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal