Areal Interpolation Layer To Polygons (Geostatistical Analyst Tools)

Summary

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

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.

Label	Explanation	Data 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 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})

Name	Explanation	Data 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.ga.ArealInterpolationLayerToPolygons("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

# 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"

# Run ArealInterpolationLayerToPolygons
arcpy.ga.ArealInterpolationLayerToPolygons(inArealInterpolationLayer, inPolygonFeatures, outFeatureClass, appendAllFields)

Environments

Current Workspace, Extent, Geographic Transformations, Output Coordinate System, Parallel Processing Factor, Scratch Workspace

Licensing information