Summary
Profiles demographic attributes of customer data based on a selected demographic or custom data layer using the Principal Component Analysis approach.
Learn more about how Customer Prospecting By Using PCA works
Usage
It is recommended that the Boundary PCA Eigenvalue parameter value of 1 be left as the default based on the widely accepted Kaiser criterion.
When choosing the Number of Features to Rank, you can limit the number of features displayed in the output in the analysis. All the features are analyzed with this approach, but only the top N features will be displayed.
Syntax
PCACustomerProspecting_ba (InputBoundaryLayer, InputGeographyLevel, OutputFeatureClass, DMQFile, FSRankFeatNum, {UserDefinedBoundVal})| Parameter | Explanation | Data Type |
InputBoundaryLayer | The boundary layer that defines the extent of the data to be analyzed. | Feature Layer |
InputGeographyLevel | The input feature class that contains the data to be used in the analysis. | Feature Layer |
OutputFeatureClass | The output feature class that will contain the customer prospecting data. The output feature class will be ranked based on similarity to the master site. | Feature Class |
DMQFile | The definition input file generated in Customer Prospecting (Business Analyst) that sets the parameters to filter the geography level. | File |
FSRankFeatNum | Defines the number of features you can rank. For example, if you selected 10 for the number of features to rank, the top 10 features would be ranked, which may include your master site if it is included in your target layer. | Long |
UserDefinedBoundVal (Optional) | The Eigenvalue to use. It is recommended that you use the default value of one. | Double |
Code Sample
PCACustomerProspecting Example (Stand-alone Script)
# Name: PCACusomterProspecting.py
# Description: Creates a geographic output that ranks the top X geographies that match the inputted profile.
# Author: Esri
# Import system modules
import arcview
import arcpy
arcpy.ImportToolbox("C:\Program Files (x86)\ArcGIS\Desktop10.3\Business Analyst\ArcToolbox\Toolboxes\Business Analyst Tools.tbx")
try:
# Acquire extension license
arcpy.CheckOutExtension("Business")
# Define the parameters for the Customer Prospecting using PCA tool
Extent = "C:/temp/Boundary.shp"
GeoLevel = "C:/ArcGIS/Business Analyst/US_2014/Data/Demographic Data/esri_bg.bds"
OutputFile= "C:/temp/PCA_Demo_Prospect.shp"
DmqFile= "C:/temp/DMQ_output.dmq"
# Create Customer Prospecting output file
arcpy.PCACustomerProspecting_ba(Extent, GeoLevel, OutputFile, DmqFile)
# 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