ArcGIS for Desktop

  • Documentation
  • Pricing
  • Support

  • My Profile
  • Help
  • Sign Out
ArcGIS for Desktop

ArcGIS Online

The mapping platform for your organization

ArcGIS for Desktop

A complete professional GIS

ArcGIS for Server

GIS in your enterprise

ArcGIS for Developers

Tools to build location-aware apps

ArcGIS Solutions

Free template maps and apps for your industry

ArcGIS Marketplace

Get apps and data for your organization

  • Documentation
  • Pricing
  • Support
Esri
  • Sign In
user
  • My Profile
  • Sign Out

Help

  • Home
  • Get Started
  • Map
  • Analyze
  • Manage Data
  • Tools
  • More...

Create Profile by Area Summation

  • Summary
  • Usage
  • Syntax
  • Code Sample
  • Environments
  • Licensing Information

Summary

Creates segmentation area profiles with standard geography units, study areas, trade areas, and other polygon layers.

Learn more about how Create Profile By Area Summation (Business Analyst) works

Usage

  • The Analysis Extent must be a polygon feature class.

  • In most cases, the Analysis Extent will be a Business Analyst trade area layer.

  • If the Create profile for each separate area is used, the Segmentation Module will create one profile for each polygon in your Profile Base.

  • If you choose to create a profile for each area, the Segmentation module will create each profile and name it based on the ID. For example, if you had CBSA_ for the name of the profile and the ID field was the name of each area, then all your profiles would start with CBSA_ and be followed by the name contained in the area ID field.

Syntax

CreateProfileByAreaSummation_ba (InputFeatureLayer, SegmentationBase, ProfileFolder, {UseSelectedFeatures}, {InputProfileComments}, {CreateProfileForEachArea}, {FieldNameValueToAddToItemName}, {UseOnlineData})
ParameterExplanationData Type
InputFeatureLayer

The polygon feature class or layer used to create a segmentation area profile.

Feature Layer
SegmentationBase

Population or household base for the profile being created.

String
ProfileFolder

The folder where the output profile will be created. The folder name corresponds to the name of the profile used in Business Analyst. For example, a profile created in the folder (C:\My Output Data\Projects\Default Project\Segmentation\Profiles\NewProfile) would be referred to as NewProfile in Business Analyst.

Folder
UseSelectedFeatures
(Optional)

Determines if profiles will be created for all features, or only selected features.

  • USE_ALL —Profile created for all features in an input layer.
  • USE_SELECTED —Profile created for selected features in an input layer.
Boolean
InputProfileComments
(Optional)

Optional comments for profile. These comments can include information such as author, source, date, and vintage.

String
CreateProfileForEachArea
(Optional)

Creates a profile for each separate polygon in your shapefile.

  • CREATE_WITH_ID —Generates a profile for each area.
  • CREATE_NO_ID —Does not generate a profile for each area.
Boolean
FieldNameValueToAddToItemName
(Optional)

Each profile generated will be named based on the values in this field.

Field
UseOnlineData
(Optional)

Determines if online Business Analyst data will be used in the analysis.

  • Checked—use online Business Analyst data.
  • Unchecked—use only locally loaded Business Analyst data.

Select to access online Business Analyst data to use in the analysis.

  • True —Allows a user to acess online Business Analyst data.
  • False —A user will only have access to locally loaded Business Analyst data.
Boolean

Code Sample

CreateProfileByAreaSummation Example (Stand-alone Script)
# Name: AssignCustomersByLocation.py
# Description: Creates a geographic based profile.
# Author: Esri

# Import system modules

import arview
import arcpy

arcpy.AddToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")

try:
# Acquire extension license 
  arcpy.CheckOutExtension("Business")
 
# Define input and output parameters for the Create Profile by Area Summation tool
  TAPath = "C:/temp/TradeArea.shp"
  OutPath = "C:/temp/NewProfile.xml"
 
# Create Profile by Area Summation
  arcpy.CreateProfileByAreaSummation_ba(TAPath, "Total Households", "CENTROIDS_IN_TA", OutPath, "USE_ALL", "#")
 
# Release extension license 
  arcpy.CheckInExtension("Business")
 
except:
  print arcpy.GetMessages(2)

Environments

This tool does not use any geoprocessing environments

Licensing Information

  • ArcGIS for Desktop Basic: Requires Business Analyst
  • ArcGIS for Desktop Standard: Requires Business Analyst
  • ArcGIS for Desktop Advanced: Requires Business Analyst

Related Topics

  • An overview of the Segmentation Profiles toolset
Feedback on this topic?

ArcGIS for Desktop

  • Home
  • Documentation
  • Pricing
  • Support

ArcGIS Platform

  • ArcGIS Online
  • ArcGIS for Desktop
  • ArcGIS for Server
  • ArcGIS for Developers
  • ArcGIS Solutions
  • ArcGIS Marketplace

About Esri

  • About Us
  • Careers
  • Insiders Blog
  • User Conference
  • Developer Summit
Esri
© Copyright 2016 Environmental Systems Research Institute, Inc. | Privacy | Legal