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 installed Business Analyst dataset.

Note:

  • The Enrich Layer tool uses detailed aggregation and apportionment settings to summarize data.
  • The Apportion Polygon tool is similar to the Enrich Layer. 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 Enrich Layer can come from ArcGIS Online or locally installed Business Analyst data. This tool will consume credits if ArcGIS Online is set as the Business Analyst Data Source.

  • The Enrich Layer 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 Feature Class value is a duplicate of the Input Features value with additional attribute fields.

  • The demographic and landscape information can come from ArcGIS Online or locally installed Business Analyst data.

  • You must be signed in to ArcGIS Online or have Business Analyst Data installed.

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

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

  • If you're signed in to ArcGIS Online, Enrich Layer 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

One or more variables that will be summarized and added to the output feature class.

String
Define areas to enrich
(Optional)

Defines 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 method.

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 Kilometers.

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,...]

One or more variables that will be summarized and added to the output feature class.

String
buffer_type
(Optional)

Defines 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 method.

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 Kilometers.

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