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.

  • A value of 0 (zero) indicates the line begins at the from-point of the underlying source feature.
  • A value of 1 indicates the line begins at the to-point of the source feature.
  • A value between 0 and 1 indicates the line begins at a point along the underlying source feature; for example, a value of 0.25 means the line begins 25 percent along 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.

  • A value of 0 (zero) indicates the line ends at the from-point of the underlying source feature.
  • A value of 1 indicates the line ends at the to-point of the source feature.
  • A value between 0 and 1 indicates the line ends at a point along the underlying source feature; for example, a value of 0.25 means the line ends 25 percent along 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.

Value

Description

0

The traversed edge didn't use the restriction.

1

The traversed edge used the restriction.

NoteNote:

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.

NoteNote:

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.

Value

Description

Stops

The point was created from a stop in a route analysis.

Facilities

The point was created from a facility in a closest facility or service area analysis.

Incidents

The point was created from an incident in a closest facility analysis.

Orders

The point was created from an order in a vehicle routing problem analysis.

Depots

The point was created from a depot in a vehicle routing problem analysis.

Breaks

The point was created from a break in a vehicle routing problem analysis.

MidspanJunctions

The point was created from a break border in a service area analysis, traversed additive cost barrier, or traversed scaled-cost line or polygon barrier.

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:

Value

Description

NETWORK

The feature represents a traversed network dataset element.

NA_CLASS

The feature represents a traversed feature from the network analysis layer.

VIRTUAL

The feature represents a traversed barrier or the end of a break in a service area analysis or a traversed junction in the streemap dataset.

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.

Value

Description

0

The traversed junction didn't use the restriction.

1

The traversed junction used the restriction.

NoteNote:

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:

Value

Description

NETWORK

The record represents a traversed network dataset element.

VIRTUAL

The record represents a global turn that was traversed.

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.

Value

Description

0

The traversed turn didn't use the restriction.

1

The traversed turn used the restriction.

NoteNote:

Elements that use prohibit-restrictions are never traversed; however, those that use prefer- or avoid-restrictions can be traversed.

Related Topics

1/20/2015