Areal Interpolation Layer To Polygons (Geostatistical Analyst)

Available with Geostatistical Analyst license.

Summary

Reaggregates the predictions of an Areal Interpolation layer to a new set of polygons.

Learn more about Areal Interpolation

Usage

  • This tool is used to reaggregate polygonal data. After an Areal Interpolation layer is created in the Geostatistical Wizard, this tool aggregates the predictions to a new set of polygons.

  • This tool can be used in the workflow to downscale or upscale polygonal data, such as predicting population in census blocks from population counts in postal codes.

  • The input geostatistical layer must be the result of performing Areal Interpolation on a dataset. Geostatistical layers resulting from other interpolation techniques cannot be used with this tool.

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

    • Predicted—The predicted value of the polygon. The interpretation of the predicted value depends on the type of data used to create the areal interpolation geostatistical layer:
      • Average (Gaussian)—Predicts the average value of the Gaussian variable in the polygon.
      • Rate (Binomial)—Predicts the proportion of the population of a polygon that has a particular characteristic.
      • Event (Overdispersed Poisson)—Predicts the count in the polygon. If a time field is specified, the tool predicts the count per unit time.
    • StdError—The standard error of predicted values in the polygons.
    • Included—Indicates whether a stable prediction can be made for the polygon. If a prediction cannot be made, a description will indicate why it cannot be made.

Syntax

arcpy.ga.ArealInterpolationLayerToPolygons(in_areal_interpolation_layer, in_polygon_features, out_feature_class, {append_all_fields})
ParameterExplanationData Type
in_areal_interpolation_layer

Input geostatistical layer resulting from an Areal Interpolation model.

Geostatistical Layer
in_polygon_features

The polygons where predictions and standard errors will be aggregated.

Feature Layer
out_feature_class

The output feature class containing the aggregated predictions and standard errors for the new polygons.

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

ArealInterpolationLayerToPolygons example 1 (Python window)

Aggregate areal interpolation predictions to a new set of polygons.

import arcpy
arcpy.env.workspace = "C:/gapyexamples/data"
arcpy.ArealInterpolationLayerToPolygons_ga("AI_layer","new_polys","pred_new_polys","ALL")
ArealInterpolationLayerToPolygons example 2 (stand-alone script)

Aggregate areal interpolation predictions to a new set of polygons.

# Name: ArealInterpolationLayerToPolygons_Example_02.py
# Description: Averages (in the case of Gaussian data) or aggregates (in the cases of Binomial or Poisson)
#    the predictions of an Areal Interpolation layer to a new set of polygons.
# Requirements: Geostatistical Analyst Extension
# Author: Esri

# Import system modules
import arcpy

# Set environment settings
arcpy.env.workspace = "C:/gapyexamples/data"

# Set local variables
inArealInterpolationLayer = "C:/gapyexamples/data/AI_layer.lyr"
inPolygonFeatures = "C:/gapyexamples/data/new_polys.shp"
outFeatureClass = "C:/gapyexamples/output/aiout.shp"
appendAllFields = "FID_ONLY"

# Execute ArealInterpolationLayerToPolygons
arcpy.ArealInterpolationLayerToPolygons_ga(inArealInterpolationLayer, inPolygonFeatures, outFeatureClass, appendAllFields)

Licensing information

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

Related topics