Generate Desire Lines (Business Analyst)

This ArcGIS 2.8 documentation has been archived and is no longer updated. Content and links may be outdated. See the latest documentation.

Available with Business Analyst license.

Summary

Generates a series of lines from each customer to an associated store location. These lines are often called spider diagrams.

Note:

This tool is similar to the Generate Origin-Destination Links tool in the Analysis toolbox Proximity toolset.

Illustration

Generate Desire Lines tool illustration

Usage

  • The store layer and customer layer must be a point feature class.

  • Generating desire lines with drive time and drive distance will take longer than using the straight-line (Euclidean) distance method.

  • The output shows the spatial distribution between the Store Layer and the Customer Layer parameter values and calculates the distance values between each store and customer.

Parameters

LabelExplanationData Type
Store Layer

The input point layer representing store or facility locations.

Feature Layer
Customer Layer

The input point layer representing customers or patrons.

Feature Layer
Output Feature Class

The resultant feature class that will be added to the Contents pane.

Feature Class
Store ID Field

A unique ID field representing a store or facility location.

Field
Associated Store ID Field

An ID field used to assign individual customers to stores.

Field
Distance Type
(Optional)

The method of travel that will be used for distance calculation. Straight Line is the default value.

When using Portal for ArcGIS or local data sources, travel mode options are dynamically populated.

String
Measure Units
(Optional)

The type of distance- or time-measuring units that will be used when calculating minimal distance.

String
Cutoff
(Optional)

The distance beyond which customers will be considered outliers and excluded from consideration during desire line generation.

Double
Travel Direction
(Optional)

Specifies the direction of travel that will be used between stores and demand points.

  • Toward Stores —The direction of travel will be from demand points to stores. This is the default.
  • Away from Stores —The direction of travel will be from stores to demand points.
String
Time of Day
(Optional)

The time at which travel begins.

Date
Time Zone
(Optional)

Specifies the time zone that will be used for the Time of Day parameter.

  • UTC —Coordinated universal time (UTC) will be used. Choose this option if you want to choose the best location for a specific time, such as now, but aren't certain in which time zone the stores or demand points will be located.
  • Local time at locations —The time zone in which the stores or demand points are located will be used. If Travel Direction is Away from Stores, this is the time zone of the stores. If Travel Direction is Toward Stores, this is the time zone of the demand points. This is the default.
  • UTC —Coordinated universal time (UTC) will be used. Choose this option if you want to choose the best location for a specific time, such as now, but aren't certain in which time zone the stores or demand points will be located.
  • Local time at locations —The time zone in which the stores or demand points are located will be used. If travel_direction is AWAY_FROM_STORES, this is the time zone of the stores. If travel_direction is TOWARD_STORES, this is the time zone of the demand points. This is the default.
String

Licensing information

  • Basic: Requires Business Analyst, ArcGIS Network Analyst extension
  • Standard: Requires Business Analyst, ArcGIS Network Analyst extension
  • Advanced: Requires Business Analyst, ArcGIS Network Analyst extension

Related topics