Output from Copy Traversed Source Features
The Copy Traversed Source Features tool creates two feature classes and a table containing the edges, junctions, and turns that are traversed while solving a network analysis layer. The fields of the three types of output are described in the three sections below.
Edges feature class
Field name | Description | ||||||
---|---|---|---|---|---|---|---|
ObjectID | The system-managed ID field. | ||||||
Shape | The geometry of the line. | ||||||
SourceName | The name of the edge source feature class from which the line was generated. For StreetMap network datasets, the name of the edge source is the name of the feature class referencing the edge source layer. One way to identify edge source names is by accepting the option to add sources when adding a streetmap network dataset layer to ArcMap. | ||||||
SourceOID | The object ID of the traversed source feature. This value is an object ID from the feature class that is identified in the SourceName field. | ||||||
SourceType | The value of SourceType is always NETWORK, which indicates the line feature represents a traversed network dataset element. | ||||||
EID | This field indicates the element ID (EID) of the traversed network edge. An EID uniquely describes a network element. The EID of a network element is independent of the ObjectID of the feature. One feature may be stored as many different elements in the network. | ||||||
FromPosition | Specifies where the output line feature begins in reference to the digitized direction of the underlying source feature.
| ||||||
ToPosition | Specifies where the output line feature ends in reference to the digitized direction of the underlying source feature.
| ||||||
FromJunctionID | Copy Traversed Source Features outputs a junctions feature class along with the edges feature class. The endpoints of the lines in the edges feature class are coincident with points in the junctions feature class. FromJunctionID indicates the object ID of the point feature in the junctions feature class that is coincident with the beginning of the line feature. | ||||||
ToJunctionID | Copy Traversed Source Features outputs a junctions feature class along with the edges feature class. The endpoints of the lines in the edges feature class are coincident with points in the junctions feature class. ToJunctionID indicates the object ID of the point feature in the junctions feature class that is coincident with the end of the line feature. | ||||||
RouteID or FacilityID | If your input network analysis layer is a route, closest facility, or vehicle routing problem, this field is named RouteID and uniquely identifies the route that traversed the edge. The value refers to the object ID from the Routes sublayer within the input network analysis layer. If your input network analysis layer is a service area, the field is named FacilityID and uniquely identifies the facility whose service area traversed the edge. The value refers to the object ID from the Facilities sublayer within the input network analysis layer. | ||||||
Attr_[CostAttributeName] (for instance, Attr_Minutes, where Minutes is the impedance for the network) | The cost of the underlying edge. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||
Cumul_[CostAttributeName] (for instance, Cumul_Minutes, where Minutes is the impedance for the network) | The cumulative cost of the underlying network elements from the beginning of the route or service area to the end of the edge represented by the line feature. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||
Attr_[RestrictionAttributeName] (for instance, Attr_Avoid_Toll_Roads, where "Avoid Toll Roads" is the restriction attribute for the network) | Specifies whether the traversed edge used the restriction attribute referred to in this field's name.
Note: Elements that use prohibit-restrictions are never traversed; however, those that use prefer- or avoid-restrictions can be traversed. |
Junctions feature class
The junctions feature class contains points representing traversed junctions; traversed network locations, such as stops, depots, and facilities; and, for service areas, the locations where break values were reached.
Barriers are network locations; however, there are cases when barriers aren't included in the junctions feature class. These cases are outlined below.
- Copy Traversed Source Features never outputs restriction barriers, since they cannot be traversed.
- Added-cost point barriers that were traversed in the analysis are included in the junctions feature class; however, if a barrier's added cost is set to 0 (that is, the underlying impedance is unaffected), the barrier is excluded from this feature class.
- Points that represent where scaled-cost line or polygon barriers were entered or exited are included as features in the junction feature class, but only if the barrier scales impedance by a value other than 1.
ObjectID | The system-managed ID field. | ||||||||||||||||
Shape | The geometry of the point. | ||||||||||||||||
SourceName | The name of the source from which the point was created. When points are generated from traversed network dataset junctions, the SourceName value matches the name of the junction source feature class. For streetmap network datasets, the SourceName value is ND_SDC Junction Source as they do not have a junction source feature class. When points are generated from other sources, the SourceName value identifies the source with one of the values below.
| ||||||||||||||||
SourceOID | The object ID of the traversed source feature. This value refers to an object ID of a feature in the feature class that is identified in the SourceName field. SourceOID is -1 if the SourceName value is MidspanJunctions or SourceType value is VIRTUAL. | ||||||||||||||||
SourceType | There are three possible values for this field:
| ||||||||||||||||
EID | An element ID (EID) uniquely describes a network element. This field indicates the EID of the traversed network element. The EID of a network element is independent of the ObjectID of the feature. One feature may be stored as many different elements in the network. EID is -1 if the feature doesn't represent a junction from the network dataset; for example, it is -1 if the point represents a stop on a route. | ||||||||||||||||
RouteID or FacilityID | If your input network analysis layer is a route, closest facility, or vehicle routing problem, this field is named RouteID and uniquely identifies the route feature that traversed the junction. The value refers to the object ID from the Routes sublayer within the input network analysis layer. If your input network analysis layer is a service area, the field is named FacilityID and uniquely identifies the facility whose service area traversed the junction. The value refers to the object ID from the Facilities sublayer within the input network analysis layer. | ||||||||||||||||
Attr_[CostAttributeName] (for instance, Attr_Minutes, where Minutes is the impedance for the network) | The cost of the underlying junction. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||||||||||||
Cumul_[CostAttributeName] (for instance, Cumul_Minutes, where Minutes is the impedance for the network) | The cumulative cost of the underlying network elements from the beginning of the route or service area through the location of the current point feature. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||||||||||||
Attr_[RestrictionAttributeName] (for instance, Attr_Avoid_Toll_Roads, where "Avoid Toll Roads" is the restriction attribute for the network) | Specifies whether the traversed junction used the restriction attribute referred to in this field's name.
Note: Elements that use prohibit-restrictions are never traversed; however, those that use prefer- or avoid-restrictions can be traversed. |
Turns attribute table
ObjectID | The system-managed ID field. | ||||||
SourceName | The name of the source from which the turn record was created. When the record is generated from a turn in the network dataset, the SourceName value matches the name of the source feature class. For streetmap network datasets, the name of the turn source is the name of the feature class referencing the turn source layer. One way to identify turn source names is by accepting the option to add the source layers when adding a streetmap network dataset layer to ArcMap. When the record is generated from a global turn, the SourceName value is ImplicitTurns. | ||||||
SourceOID | The object ID of the traversed source feature. This value refers to an object ID from the feature class that is identified in the SourceName field. SourceOID is -1 if the SourceName value is ImplicitTurns. | ||||||
SourceType | There are two possible values for this field:
| ||||||
EID | An element ID (EID) uniquely describes a network element. This field indicates the EID of the traversed network element. The EID of a network element is independent of the ObjectID of the feature. One feature may be stored as many different elements in the network. EID is -1 if the record represents a traversed global turn. | ||||||
FromEdgeID | Copy Traversed Source Features outputs an edges feature class along with the turns attribute table which is described here. The endpoints of lines in the turn attribute table are coincident with lines in the edges feature class. FromEdgeID indicates the object ID of the line feature in the edges feature class that is coincident with the turn. | ||||||
ToEdgeID | Copy Traversed Source Features outputs an edges feature class along with the turns feature class which is described here. The endpoints of lines in the turn feature class are coincident with lines in the edges feature class. ToEdgeID indicates the object ID of the line feature in the edges feature class that is coincident with the end of the turn. | ||||||
RouteID or FacilityID | If your input network analysis layer is a route, closest facility, or vehicle routing problem, this field is named RouteID and uniquely identifies the route that traversed the turn. The value refers to the object ID from the Routes sublayer within the input network analysis layer. If your input network analysis layer is a service area, the field is named FacilityID and uniquely identifies the facility whose service area traversed the turn. The value refers to the object ID from the Facilities sublayer within the input network analysis layer. | ||||||
Attr_[CostAttributeName] (for instance, Attr_Minutes, where Minutes is the impedance for the network) | The cost of the underlying turn. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||
Cumul_[CostAttributeName] (for instance, Cumul_Minutes, where Minutes is the impedance for the network) | The cumulative cost of the underlying network elements from the beginning of the route or service area through the location of the current turn. The units of this field are the same as the units of the cost attribute referred to in the field name. | ||||||
Attr_[RestrictionAttributeName] (for instance, Attr_Avoid_Toll_Road, where "Avoid Toll Roads" is the restriction attribute for the network) | Specifies whether the traversed turn used the restriction attribute referred to in this field's name.
Note: Elements that use prohibit-restrictions are never traversed; however, those that use prefer- or avoid-restrictions can be traversed. |