Make OD Cost Matrix Layer (Network Analyst) |
|
Release 9.3
Last modified December 23, 2008 |
![]() ![]() ![]() Print all topics in : "Tools" |
Makes an origin-destination (od) cost matrix network analysis layer and sets its navigation properties.
Usage tips
An OD Cost Matrix layer can be made on a network currently added to the ArcMap Table of Contents or on a network dataset on disk.
Hierarchy options can only be set if the input analysis network has a hierarchy attribute.
The following environment setting affects this tool: workspace.
Command line syntax
An overview of the Command Line window
MakeODCostMatrixLayer_na <in_network_dataset> <out_network_analysis_layer> <impedance_attribute> {default_cutoff} {default_number_destinations_to_find} {accumulate_attribute_name;accumulate_attribute_name...} {ALLOW_UTURNS | NO_UTURNS | ALLOW_DEAD_ENDS_ONLY} {restriction_attribute_name;restriction_attribute_name...} {NO_HIERARCHY | USE_HIERARCHY} {hierarchy_settings} {STRAIGHT_LINES | NO_LINES}
Parameter | Explanation | Data Type |
<in_network_dataset> |
The network dataset on which the OD cost matrix will be performed. |
Network Dataset Layer |
<out_network_analysis_layer> |
Name of the OD cost matrix network analysis layer being created. |
String |
<impedance_attribute> |
The cost attribute to be used as impedance in the analysis. |
String |
{default_cutoff} |
Default impedance value at which to cut off searching for destinations for a given origin. If the accumulated impedance becomes higher than the cutoff value, the traversal stops. The default can be overridden by the value of the Cutoff_<impedance> property of the origins. |
Double |
{default_number_destinations_to_find} |
Default number of destinations to find for each origin. The default can be overridden by the value of the TargetDestinationCount property of the origins. |
Long |
{accumulate_attribute_name;accumulate_attribute_name...} |
List of cost attributes to be accumulated during analysis. |
String |
{ALLOW_UTURNS | NO_UTURNS | ALLOW_DEAD_ENDS_ONLY} |
Specifies optional U-turn restrictions.
|
String |
{restriction_attribute_name;restriction_attribute_name...} |
List of restriction attributes to be honored during analysis. |
String |
{NO_HIERARCHY | USE_HIERARCHY} |
Specifies whether or not to use a hierarchy in the analysis.
|
Boolean |
{hierarchy_settings} |
Sets the hierarchy attribute values at which the navigation algorithm should form the highest, middle, and lowest ranks. The value is specified as a space-separated string containing two integers whose values must be greater than zero. The integers indicate low-to-mid and mid-to-high break values. The two integers must have their values in increasing order. For example, a value of "6 8" indicates that the primary roads are defined by the values of one to six, secondary roads by seven, and local roads by eight and higher. |
Network Analyst Hierarchy Settings |
{STRAIGHT_LINES | NO_LINES} |
Specifies the type of line generated from the analysis.
|
String |
MakeODCostMatrixLayer NewYorkNDS ODMatrix Minutes 30 3 Meters;Dollars ALLOW_DEAD_ENDS_ONLY Oneway;NoHazmat NO_HIERARCHY # NO_LINES
Scripting syntax
About getting started with writing geoprocessing scripts
MakeODCostMatrixLayer_na (in_network_dataset, out_network_analysis_layer, impedance_attribute, default_cutoff, default_number_destinations_to_find, accumulate_attribute_name, UTurn_policy, restriction_attribute_name, hierarchy, hierarchy_settings, output_path_shape)
Parameter | Explanation | Data Type |
in_network_dataset (Required) |
The network dataset on which the OD cost matrix will be performed. |
Network Dataset Layer |
out_network_analysis_layer (Required) |
Name of the OD cost matrix network analysis layer being created. |
String |
impedance_attribute (Required) |
The cost attribute to be used as impedance in the analysis. |
String |
default_cutoff (Optional) |
Default impedance value at which to cut off searching for destinations for a given origin. If the accumulated impedance becomes higher than the cutoff value, the traversal stops. The default can be overridden by the value of the Cutoff_<impedance> property of the origins. |
Double |
default_number_destinations_to_find (Optional) |
Default number of destinations to find for each origin. The default can be overridden by the value of the TargetDestinationCount property of the origins. |
Long |
accumulate_attribute_name (Optional) |
List of cost attributes to be accumulated during analysis. |
String |
UTurn_policy (Optional) |
Specifies optional U-turn restrictions.
|
String |
restriction_attribute_name (Optional) |
List of restriction attributes to be honored during analysis. |
String |
hierarchy (Optional) |
Specifies whether or not to use a hierarchy in the analysis.
|
Boolean |
hierarchy_settings (Optional) |
Sets the hierarchy attribute values at which the navigation algorithm should form the highest, middle, and lowest ranks. The value is specified as a space-separated string containing two integers whose values must be greater than zero. The integers indicate low-to-mid and mid-to-high break values. The two integers must have their values in increasing order. For example, a value of "6 8" indicates that the primary roads are defined by the values of one to six, secondary roads by seven, and local roads by eight and higher. |
Network Analyst Hierarchy Settings |
output_path_shape (Optional) |
Specifies the type of line generated from the analysis.
|
String |
import arcgisscripting gp = arcgisscripting.create() gp.MakeODCostMatrixLayer(NewYorkNDS,"ODMatrix", "Minutes", 30, 3, "Meters;Dollars", "ALLOW_DEAD_ENDS_ONLY", "Oneway;NoHazmat", "NO_HIERARCHY", "#", "NO_LINES")