Main menu

Pages

Generate Origin Destination Cost Matrix Tool

Generate Origin Destination Cost Matrix Tool

How to use Generate Origin Destination Cost Matrix Tool in Arc Toolbox ArcMap ArcGIS??

Generate Origin Destination Cost Matrix Tool
Generate Origin Destination Cost Matrix


Path to access the tool

:

Generate Origin Destination Cost Matrix Tool, Server Toolset, Network Analyst Tools Toolbox

 

Generate Origin Destination Cost Matrix

Creates an origin-destination (OD) cost matrix from multiple origins to multiple destinations. An OD cost matrix is a table that contains the travel time and travel distance from each origin to each destination. Additionally, it ranks the destinations that each origin connects to in ascending order based on the minimum time or distance required to travel from that origin to each destination.

The best path on the street network is discovered for each origin-destination pair, and the travel times and travel distances are stored as attributes of the output lines. Even though the lines are straight for performance reasons, they always store the travel time and travel distance along the street network, not straight-line distance.

1.    Origins

Specify locations that function as starting points in generating the paths to destinations. Up to 200 origins can be added.

When specifying the origins, you can set properties for each one, such as its name or the number of destinations to find from the origin, by using attributes. The origins can be specified with the following attributes:

Name—The name of the origin. The name can be a unique identifier for the origin. The name is included in the output lines (as the OriginName field) and in the output origins (as the Name field) and can be used to join additional information from the tool outputs to the attributes of your origins.

If the name is not specified, a unique name prefixed with Location is automatically generated in the output origins. An autogenerated origin name is not included in the output lines.

TargetDestinationCount—The maximum number of destinations that must be found for the origin. If a value is not specified, the value from the Number of Destinations to Find parameter is used.

Cutoff—Specify the travel time or travel distance value at which to stop searching for destinations from the origin. Any destination beyond the cutoff value will not be considered.

The value needs to be in the units specified by the Time Units parameter if the impedance attribute in your travel mode is time based or in the units specified by the Distance Units parameter if the impedance attribute in your travel mode is distance based. If a value is not specified, the value from the Cutoff parameter is used.

CurbApproach—Specify the direction a vehicle may depart from the origin. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses):

  1. 0 (Either side of vehicle)—The vehicle can depart the origin in either direction, so a U-turn is allowed at the origin. This setting can be chosen if it is possible and practical for your vehicle to turn around at the origin. This decision may depend on the width of the road and the amount of traffic or whether the origin has a parking lot where vehicles can enter and turn around.
  2. 1 ( Right side of vehicle)—When the vehicle departs the origin, the origin must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must depart from the bus stop on the right-hand side.
  3. 2 (Left side of vehicle)—When the vehicle departs the origin, the curb must be on the left side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must depart from the bus stop on the left-hand side.
  4. 3 (No U-Turn)—For this tool, the No U-turn (3) value functions the same as Either side of vehicle.

The CurbApproach property is designed to work with both kinds of national driving standards: right-hand traffic (United States) and left-hand traffic (United Kingdom). First, consider a stop on the left side of a vehicle. It is always on the left side regardless of whether the vehicle travels on the left or right half of the road. What may change with national driving standards is your decision to approach a stop from one of two directions, that is, so it ends up on the right or left side of the vehicle. For example, if you want to arrive at a stop and not have a lane of traffic between the vehicle and the stop, you would choose Right side of vehicle (1) in the United States but Left side of vehicle (2) in the United Kingdom.

2.    Destinations

Specify locations that function as ending points in generating the paths from origins. Up to 200 destinations can be added.

When specifying the destinations, you can set properties for each one, such as its name, by using attributes. The destinations can be specified with the following attributes:

Name—The name of the destination. The name can be a unique identifier for the destination. The name is included in the output lines (as the DestinationName field) and in the output destinations (as the Name field) and can be used to join additional information from the tool outputs to the attributes of your destinations.

If the name is not specified, a unique name prefixed with Location is automatically generated in the output destinations. An autogenerated destination name is not included in the output lines.

CurbApproach—Specifies the direction a vehicle may arrive at the destination. The field value is specified as one of the following integers (use the numeric code, not the name in parentheses):

  1. 0 (Either side of vehicle)—The vehicle can depart the origin in either direction, so a U-turn is allowed at the origin. This setting can be chosen if it is possible and practical for your vehicle to turn around at the origin. This decision may depend on the width of the road and the amount of traffic or whether the origin has a parking lot where vehicles can enter and turn around.
  2. 1 ( Right side of vehicle)—When the vehicle departs the origin, the origin must be on the right side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must depart from the bus stop on the right-hand side.
  3. 2 (Left side of vehicle)—When the vehicle departs the origin, the curb must be on the left side of the vehicle. A U-turn is prohibited. This is typically used for vehicles such as buses that must depart from the bus stop on the left-hand side.
  4. 3 (No U-Turn)—For this tool, the No U-turn (3) value functions the same as Either side of vehicle.

3.    Network Dataset

The network dataset on which the analysis will be performed. Network datasets most often represent street networks but may represent other kinds of transportation networks as well. The network dataset needs at least one time-based and one distance-based cost attribute.

4.    Output Geodatabase

The output workspace. This workspace must already exist.

5.    Output Origin Destination Lines Name

The name of the output feature class that stores the lines connecting the origin and destination points.

Output from Generate Origin Destination Cost Matrix describes the schema of this output feature class.

6.    Output Origins Name

The name of the output feature class containing origin points.

Output from Generate Origin Destination Cost Matrix describes the schema of this output feature class.

7.    Output Destinations Name

The name of the output feature class containing destination points.

Output from Generate Origin Destination Cost Matrix describes the schema of this output feature class.

8.    Travel Mode (optional)

Choose the mode of transportation for the analysis. Custom is always a choice. For other travel mode names to appear, they must be present in the network dataset specified in the Network Dataset parameter.

A travel mode is defined on a network dataset and provides override values for parameters that, together, model cars, trucks, pedestrians, or other modes of travel. By choosing a travel mode here, you don't need to provide values for the following parameters, which are overridden by values specified in the network dataset:

  1. UTurn Policy
  2. Time Attribute
  3. Time Attribute Units
  4. Distance Attribute
  5. Distance Attribute Units
  6. Use Hierarchy in Analysis
  7. Restrictions
  8. Attribute Parameter Values
  9. Route Line Simplification Tolerance
  10. CUSTOM—Define a travel mode that fits your specific needs. When Custom is chosen, the tool does not override the travel mode parameters listed above. This is the default value.

9.    Time Units (optional)

Specify the units that should be used to measure and report the total travel time between each origin-destination pair. The choices include the following:

  1. Seconds
  2. Minutes
  3. Hours
  4. Days

10. Distance Units (optional)

Specify the units that should be used to measure and report the total travel distance between each origin-destination pair.

The choices include the following:

  1. Miles
  2. Kilometers
  3. Meters
  4. Feet
  5. Yards
  6. Nautical Miles

11.  Advanced Analysis

12.  Barriers

13.  Custom Travel Mode

14.  Network Dataset

15.  Network Location

16.  Output

17.  Service Capabilities

All the seven additional categories are explained in detail, click here to access their explanation

Comments

table of contents title