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

Find Similar

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

Summary

Scores potential sites or trade areas against an existing well-performing master site.

Learn more about how Find Similar works

Usage

  • When using the conventional Find Similar approach (the Use Conventional Find Similar Approach parameter is checked), set your ranges (expressed as percentages) for each variable at 25 percent for your initial analysis. This will give you a better chance to score your potential sites at a ranking of more than zero.

  • If you are unsure of the variables needed to properly score your master and potential sites, run the Find Similar analysis using the Principal Component Analysis (PCA) (the Use Conventional Find Similar Approach parameter is unchecked). This approach allows you to enter as many variables as desired and lets Business Analyst determine the best variables to score the sites.

  • The conventional Find Similar approach is limited to a maximum of five variables.

  • When using PCA, you have the option of running the analysis on points or polygons.

  • If a point layer is selected, you must select a radius that will contain the extent at which the site-scoring variables will be selected and analyzed.

  • If a polygon layer is selected, the extent at which the site-scoring variables will be selected and analyzed is contained within each polygon.

  • The master site can be chosen from one of the features in the target layer.

  • It is recommended that the Boundary PCA eigenvalue 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 x features will be displayed.

  • Only target sites or polygons in the active extent or study area will be used in the analysis.

  • The Field Mapping file option is only necessary when you have a master site that is different from the potential sites and contains ID fields that are different that the potential sites layer. If the ID fields are the same, then this option is not necessary.

  • The Field Mapping file must be created using the Find Similar wizard in Business Analyst and exported in order to be imported in the Find Similar GP tool.

Syntax

FindSimilar_ba (InputFeatureLayer, MasterSite, OutputFeatureClass, {UserDefineRadiuses}, {MeasureUnits}, {BDSFeatureClass}, {UseOrdinaryFS}, {UseOrdinaryFSVals}, {PCAFields}, {UserDefinedBoundVal}, {FSRankFeatNum}, {FSUseMasterSitesLayer}, {FSMasterSitesLayer}, {FSFieldMap}, {UseOnlineData})
ParameterExplanationData Type
InputFeatureLayer

The input features containing the data to be ranked based on similarity. The input features class points (stores) or polygons (trade areas).

Feature Layer
MasterSite

The primary feature that will determine how the site-scoring variables are ranked against other features in the target layer. The master site is chosen from one of the target layers.

String
OutputFeatureClass

The output feature class that will contain the Find Similar features. The output feature class will be ranked based on similarity to the master site.

Feature Class
UserDefineRadiuses
(Optional)

Defines the extent at which the demographics will be queried around the master site and the points in the target layer. This is only used if you have selected a point layer as the target layer.

Double
MeasureUnits
(Optional)

Defines how distance is measured in the Radius.

  • Decimal Degrees
  • Feet
  • Kilometers
  • Meters
  • Miles —This is the default
  • Nautical Miles
  • Yards
String
BDSFeatureClass
(Optional)

The data layer containing the variables (commonly ESRI demographic data) that will be used to determine how each site is ranked.

Feature Layer
UseOrdinaryFS
(Optional)

Determines if the conventional Find Similar approach is used.

  • True —Uses the conventional Find Similar approach.
  • False —Uses the Principal Component Analysis approach. This is the default
Boolean
UseOrdinaryFSVals
[[Layer, {Variable}, {Percentage}, {Category}],...]
(Optional)

The variables that will be used in the conventional Find Similar approach selected from the analysis data layer. In the conventional approach, you can add up to five variables.

Value Table
PCAFields
[[Layer, {Variable}, {Category}],...]
(Optional)

The variables that will be used in the Principal Component Analysis approach selected from the analysis data layer.

Value Table
UserDefinedBoundVal
(Optional)

Allows you to define an Eigenvalue other than the recommended value of one.

Double
FSRankFeatNum
(Optional)

Defines the number of features you can rank in the target layer based on similarity to the master site.

Long
FSUseMasterSitesLayer
(Optional)

Determines if you can select the master site from a different layer file than the target layer.

  • True —Allows a seperate layer to be selected as the master site.
  • False —The master is selected from the Target Layer. This is the default.
Boolean
FSMasterSitesLayer
(Optional)

The features containing the master site. This option is used if you would like to select the master site from a different layer than the layer that will be used to rank the results of the Find Similar tool.

Feature Layer
FSFieldMap
(Optional)

The file containing the fields that will be used to map the Master Site to the Target Layer.

File
UseOnlineData
(Optional)

Access online Business Analyst data to use in the analysis.

  • Checked—Allows you to acess online Business Analyst data.
  • Unchecked—You will only have access to locally loaded Business Analyst data.

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

  • True —Allows you to acess online Business Analyst data.
  • False —You will only have access to locally loaded Business Analyst data. This is the default.
Boolean

Code Sample

FindSimilar Example (Stand-alone Script)
# Name: FindSimilar.py
# Description: Ranks the top ten customers using a 1 mile buffer around each customer based on current total population in the San Francisco area.
# 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 input and output parameters for the Find Similar tool
  Target = "C:/temp/sf_cust.shp"
  Master = "1 : Customer  2"
  Output = "C:/temp/findsimilar.shp"
  Data = "C:/ArcGIS/Business Analyst/US_2014/Data/Demographic Data/esri_bg"
  numRadius = 1
  numEigen = 1
  numRank = 10
  Params = "C:\\ArcGIS\\Business Analyst\\US_2014\\Data\\Demographic Data\\esri_bg.bds TOTPOP_CY TARGET_LAYER"
 
# Create a Find Similar ouput
  arcpy.FindSimilar_ba(Target, Master, Output, "1", "Miles", Data , "false" , "#", Params, numEigen, numRank)
 
# 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 Business Analyst Analysis 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