NetworkQuery
Summary
This object provides access to a network dataset's properties, attributes, attribute values, and elements.
Discussion
A NetworkQuery object is provided as a parameter to the attach method, and other methods can use self.networkQuery to this object. A NetworkQuery object can be used to get various properties of a network dataset or query a network dataset for attributes, elements, and so on.
Properties
| Name | Explanation | Data type |
|---|---|---|
|
networkName (Read only) |
The name of the network. |
String |
|
sourceNames (Read only) |
The names of the sources referenced by the network. This is of type string. |
Iterable |
Methods
attribute(attribute_name)
Returns an attribute of the specified attribute name.
| Name | Explanation | Data type |
|---|---|---|
|
attribute_name |
The name of the network attribute. |
String |
Return value
| Data type | Explanation |
|---|---|
|
Attribute |
An attribute object. If the attribute name is not found, |
attributeUsage(attribute)
Returns the usage type of the specified attribute.
| Name | Explanation | Data type |
|---|---|---|
|
attribute |
The attribute ID as an attribute object. |
Attribute |
Return value
| Data type | Explanation |
|---|---|
|
AttributeUsage |
An attribute usage enumeration. |
attributeParameters(attribute)
Returns the parameters of the specified attribute.
| Name | Explanation | Data type |
|---|---|---|
|
attribute |
The attribute ID as an attribute object. |
Attribute |
Return value
| Data type | Explanation |
|---|---|
|
AttributeParameter |
An iterable of attribute parameters. |
fromJunction(edge)
Returns the from junction for the specified edge.
| Name | Explanation | Data type |
|---|---|---|
|
edge |
The edge that will get the from junction. |
Edge |
Return value
| Data type | Explanation |
|---|---|
|
Junction |
The from junction for the specified edge. |
toJunction(edge)
Returns the to junction for the specified edge.
| Name | Explanation | Data type |
|---|---|---|
|
edge |
The edge that will get the to junction. |
Edge |
Return value
| Data type | Explanation |
|---|---|
|
Junction |
The to junction for the specified edge. |
atJunction(turn)
Returns the junction that connects the first and second edges of the turn.
| Name | Explanation | Data type |
|---|---|---|
|
turn |
An iterable consisting of turn with the first and second edges. |
Turn |
Return value
| Data type | Explanation |
|---|---|
|
Junction |
The junction that connects the first and second edges of the turn. |
turns(junction)
Returns the turns for the specified junction where the junction connects the first and second edges of each turn.
| Name | Explanation | Data type |
|---|---|---|
|
junction |
The junction that will get the turns. |
Junction |
Return value
| Data type | Explanation |
|---|---|
|
Turn |
An iterable of turns for the specified junction where the junction connects the first and second edges of each turn. |
edges(element)
Returns the edges that are connected to the specified element.
| Name | Explanation | Data type |
|---|---|---|
|
element |
The element the edges are connected to. The element can be a junction or a turn. |
Object |
Return value
| Data type | Explanation |
|---|---|
|
Edge |
An iterable of edges that are connected to the specified element. |
edgePositions(edge)
Returns the from and to positions along the source feature for the specified edge. This method uses the digitization direction of the source feature.
The values can range from 0.0 to 1.0
| Name | Explanation | Data type |
|---|---|---|
|
edge |
The edge that will get the from and to positions. |
Edge |
Return value
| Data type | Explanation |
|---|---|
|
tuple |
The from and to positions along the source feature for the specified edge. The tuple consists of float values. |
edgeAzimuths(edge)
Returns the from and to azimuths for the specified edge.
| Name | Explanation | Data type |
|---|---|---|
|
edge |
The edge that will get the from and to azimuths. |
Edge |
Return value
| Data type | Explanation |
|---|---|
|
tuple |
The from and to azimuths for the specified edge. The tuple consists of float values. |
sourceInfo(element)
Returns source information for the specified network element.
| Name | Explanation | Data type |
|---|---|---|
|
element |
The element that will get the source information. The element can be a Junction, an edge, or a turn. |
Object |
Return value
| Data type | Explanation |
|---|---|
|
Integer |
A tuple of network source ID and network source object ID. |
attributeValue(element, attribute, time_usage, local_time)
The attribute value for a specified element, with optional time.
| Name | Explanation | Data type |
|---|---|---|
|
element |
The element that the attribute value will be applied to. The element can be an edge, a junction, or a turn. |
Object |
|
attribute |
The attribute that the value will be applied to. |
Attribute |
|
time_usage |
The time usage type. The default value is NetworkTimeUsage.Unused. |
NetworkTimeUsage |
|
local_time |
The time that will be used with the specified element. The default value is None. |
DateTime |
Return value
| Data type | Explanation |
|---|---|
|
Object |
The attribute value for a specified element at a given time. This could be an integer, a float or a boolean. |