GA Layer To Points (Geostatisical Analyst)
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 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.
-
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.
- Source_ID
Syntax
| Parameter | Explanation | Data 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, then 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 |
Code Sample
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")
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)