Desire Lines (Business Analyst)
Zusammenfassung
Creates a series of lines from each customer to an associated store location. These lines are often called spider diagrams.
Abbildung
Verwendung
-
In most cases, the input Store Layer will be a Business Analyst store layer.
-
The Store Layer must be a point feature class.
-
In ArcMap, desire lines will only be drawn to customer points that are within the active study area or analysis extent. If you want to draw desire lines to all customer points, make sure that all customers are within the analysis extent.
-
Creating desire lines with drive time and drive distance will take significantly longer than using the straight-line (Euclidean) distance method.
-
Check the Add Distance to Customer Layer checkbox if you want to append the distance from the customer point to the associated store location for each customer record.
-
Only customers in the active extent or study area will be used in this analysis.
-
Use the Assign By Closest Stores Location or Assign By Trade Area tools in the Customer Setup toolset if your customers are not assigned to a store location.
Syntax
Parameter | Erläuterung | Datentyp |
InputFeatureLayer |
The input feature layer containing the center points for the desire lines. Desire lines are drawn from these features. | Feature Layer |
IDField |
Field used to uniquely identify each store. | Field |
All_Or_Single_Or_Selected |
Runs a desire line analysis on one or more stores.
| String |
CustomerLayer |
Contains the customer points for the desire lines. Desire lines are drawn from the store to these features. | Feature Layer |
LinkField |
The store ID field in the customer layer that assigns each customer to a store. | Field |
DistanceCalculateMethod |
The method used to derive length of each desire line.
| String |
MeasureUnitsForDistanceField |
The units used with the distance values.
| String |
OutputFeatureClass |
The feature class that will contain the desire lines. | Feature Class |
ByID_Or_ByName (optional) |
Field used to select a single point.
| String |
Single_Site (optional) |
ID or name of store that is to be used as the single point. | String |
UseSelectedFeatures (optional) |
Uses only selected features to generate the desire lines.
| Boolean |
ExcludeOutlyingCustomers (optional) |
Allows you to set a cutoff distance to remove outlying points from the analysis.
| Boolean |
CutOffDistance (optional) |
The threshold to exclude outlying customers from the analysis. | Double |
MeasureUnits (optional) |
The units used with the distance values. By default, the units defined in the Business Analyst preferences will be selected.
| String |
AddDistanceToBusiness (optional) |
Adds a new field that will contain the distance calculated to each store for each customer record.
| Boolean |
WayToDefineDistanceField (optional) |
Uses an existing distance field in the customer layer to store the length of each desire line.
| Boolean |
DesireLinesDistanceField (optional) |
The field that will contain the distance calculated in the analysis. | String |
NameField (optional) |
This field contains the store name which is typically in a string format. | Field |
BarrierFeatureClasses [BarrierFeatureClasses,...] (optional) |
Allows a user to place point, line, or polygon barriers when using drive time or drive distance algorithms to calculate distances. | Feature Layer |
Codebeispiel
# Name: DesireLines.py # Description: Creates a spider diagram between stores and customers in San Francisco using a straight line distance calculation. import arcgisscripting # Import system modules import arcview import arcpy arcpy.ImportToolbox("C:\Program Files\ArcGIS\Desktop10.0\ArcToolbox\Toolboxes\Business Analyst Tools.tbx") try: # Acquire extension license arcpy.CheckOutExtension("Business") # Define the parameters for the Desire Lines tool StorePath = "C:/temp/sf_stores.shp" CustPath = "C:/temp/sf_cust.shp" OutPath = "C:/temp/desire_lines.shp" StoreId = "STORE_ID" AssociatedStoreId = "STORE_ID" # Create Desire Line output file arcpy.DesireLines_ba(StorePath, StoreId, "ALL", CustPath, AssociatedStoreId, "STRAIGHT_LINE_DISTANCE", "Miles", OutPath) # Release extension license arcpy.CheckInExtension("Business") except: print arcpy.GetMessages(2)