Enrich Layer (Business Analyst)

Available with Business Analyst license.

Summary

Enriches data by adding demographic and landscape facts about the people and places that surround or are inside data locations.

The output is a duplicate of the input with additional attribute fields. This tool requires an ArcGIS Online organizational account or a locally stored or installed dataset.

Note:

  • This tool uses detailed aggregation and apportionment settings to summarize data.
  • The Apportion Polygon tool is similar to this tool. However, Apportion Polygon uses user-specified apportionment. Enrich Layer uses U.S. Census Block points or global settlement points for apportionment. For more information, see Data apportionment.

Illustration

Enrich Layer tool illustration

Usage

  • The demographic and landscape information available with this tool can come from ArcGIS Online or a locally stored dataset. This tool will consume credits if ArcGIS Online is set for the Data Source environment.

  • This tool supports any Business Analyst data variable and statistical data collections (SDCX) as enrichment variables. For more information about SDCX layers, see Create Business Analyst custom data.

  • Input point features must have an associated boundary polygon to enrich.

  • The output is a copy of all features and attributes from the input with selected attributes appended.

  • Business Analyst Data, used in summarizations and reports, is specified through the Data Source environment.

  • If you're signed in to ArcGIS Online, this tool supports dynamic travel modes when using points as input features. Travel modes are used to build polygons, such as drive times or walk times, and are then enriched with data. For more information, see Travel modes in the Network Analyst help.

  • Statistical data collections (custom data) and custom calculations are supported.

Parameters

LabelExplanationData Type
Input Features

The features that will be enriched.

Feature Layer
Output Feature Class

The output layer containing both the input attributes and user-selected attributes. Selected attributes are summarized from underlying demographic boundaries. Only the area inside the input boundary is considered.

Feature Class
Variables

The variables that will be summarized and added to the output feature class.

String
Define areas to enrich
(Optional)

Specifies the area that will be enriched. The default value is Straight Line.

When you're signed in to ArcGIS Online, travel mode options are dynamically populated. Input line features can only use the Straight Line distance option.

String
Distance or time
(Optional)

The distance or size of an area to enrich, for example, a 1-mile buffer or 5-minute walk time. Units correspond to the polygon type. The default value is 1.

Double
Unit
(Optional)

The units associated with the Distance or time parameter. The default value is Miles.

String

arcpy.ba.EnrichLayer(in_features, out_feature_class, variables, {buffer_type}, {distance}, {unit})
NameExplanationData Type
in_features

The features that will be enriched.

Feature Layer
out_feature_class

The output layer containing both the input attributes and user-selected attributes. Selected attributes are summarized from underlying demographic boundaries. Only the area inside the input boundary is considered.

Feature Class
variables
[variables,...]

The variables that will be summarized and added to the output feature class.

String
buffer_type
(Optional)

Specifies the area that will be enriched. The default value is STRAIGHT_LINE_DISTANCE.

Input line features can only use the STRAIGHT_LINE_DISTANCE distance option.

String
distance
(Optional)

The distance or size of an area to enrich, for example, a 1-mile buffer or 5-minute walk time. Units correspond to the polygon type. The default value is 1.

Double
unit
(Optional)

The units associated with the distance parameter. The default value is MILES.

String

Code sample

EnrichLayer example 1 (Python window)

The following Python window script demonstrates how to use the EnrichLayer function.

import arcpy
arcpy.env.baDataSource = "ONLINE;US;"
arcpy.ba.EnrichLayer("TradeArea75pct", r"C:\Temp\Output.gdb\Trade_Area75_Enriched", "populationtotals.totpop_cy", None, 1, None)
EnrichLayer example 2 (Python window)

The following Python window script demonstrates how to use the EnrichLayer function with Statistical Data Collection variables.

import arcpy
arcpy.env.baDataSource = "USA_ESRI_<year>"
arcpy.ba.EnrichLayer("TradeArea1", "TradeArea1_Enrich", r" C:\Users\<USER ID>\Documents\ArcGIS\Projects\My_Project\BayArea_ProprietaryData.sdcx/sales_s01_sales", None, 1, None)

Licensing information

  • Basic: Yes
  • Standard: Yes
  • Advanced: Yes

Related topics