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.

Parameters

LabelExplanationData Type
Input areal interpolation geostatistical layer

Input geostatistical layer resulting from an Areal Interpolation model.

Geostatistical Layer
Input polygon features

The polygons where predictions and standard errors will be aggregated.

Feature Layer
Output polygon feature class

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

Feature Class
Append all fields from input features
(Optional)

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

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

arcpy.ga.ArealInterpolationLayerToPolygons(in_areal_interpolation_layer, in_polygon_features, out_feature_class, {append_all_fields})
NameExplanationData 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