createBidirectionalNetwork

Create Bidirectional Network

Creates from a polyline dataset a Biderectional Network. This is a network in which any direction of travel is allowed. This might be restricted for specific edges by the attributes in the "Direction" field in the attribute table of the input dataset.

Inputs:

A polyline feature layer
Direction filed which values define the restrictions in the direction of travel for each edge. This is optional parameter. The default is that travel in both directions is allowed.

Two Elevation fileds which values define the relative elevation of the start and end node of each edge. These are optional parameters. The default is all intersections are on the same level.

Two Cost fileds which values define the cost of travel for each edge (along and oposite of the physical direction of the polyline represented by the edge). These are optional parameters. The default cost of travel in both directions is the length of the polyline represented by this link.

Outputs:

A Network stored in a single file with .etn extension

Notes :

After the network is created it is not dependent on the source layer from which it was created. It however keeps a reference to the source file which is important for the analysis.
If you edit the source polyline layer, you need to rebuild the Network in order the changes to be reflected in the consequent analysis.

Running Programmatically

(Go to TOP)

Parameters

Expression	Explanation
Function Name	BuildBidirectionalNetwork
<input dataset>	A String representing the input layer. Must be of Polyline type.
<output network>	A String - the full name of the output network file.
{Direction Field}	A String representing the Name of the field defining the Direction. If not specified travel in both directions will be set for all edges. Valid values: "FT" (meaning From => To ) - traveling only along the direction of the polyline is allowed. "TF" (meaning To => From ) - traveling only against the direction of the polyline is allowed. "N" - No traveling is allowed. All other strings mean that traveling in both directions is allowed.
{From Level Field}	A String representing the Name of the field defining the elevation of the FROM Node of the polylines. If not specified a level of 1 will be set for the FROM Nodes of all edges.
{To Level Field}	A String representing the Name of the field defining the elevation of the TO Node of the polylines. If not specified a level of 1 will be set for the TO Nodes of all edges.
{FromTo Cost Field}	A String representing the Name of the field defining the cost of the edge for each polyline in the direction of the polyline. If not specified the cost for all edges will be the length of the corresponding polylines.
{ToFrom Cost Field}	A String representing the Name of the field defining the cost of the edge for each polyline against the direction of the polyline. If not specified the cost for all edges will be the length of the corresponding polylines.

Running the function

ETGWPath used in the table below is the full path to ETGWRun.exe (E.G. "C:\Program Files\ETSpatial Techniques\ETGeo Wizards\ETGWRun.exe")

Language	Syntax
Python	subprocess.call([ETGWPath, "BuildBidirectionalNetwork", "input dataset", "output network", "Direction Field", "From Level Field" "To Level Field" "FromTo Cost Field" "ToFrom Cost Field"])
.NET using ETGWRun.exe	StartInfo.FileName = ETGWPath StartInfo.Arguments = "BuildBidirectionalNetwork" "input dataset" "output network" "Direction Field" "From Level Field" "To Level Field" "FromTo Cost Field" "ToFrom Cost Field"
.NET using ETGWOutX.dll	BuildBidirectionalNetwork(input dataset, output network, Direction Field, From Level Field,To Level Field, FromTo Cost Field, ToFrom Cost Field)
ArcPy	arcpy.BuildBidirectionalNetwork(input dataset, output network, "Direction Field", "From Level Field", "To Level Field", "FromTo Cost Field", "ToFrom Cost Field")

Notes:

<> - required parameter
{} - optional parameter
See examples for Python , .NET or ArcPy
The argument separator for StartInfo.Arguments is space. If a string might contain a space, you need to double quote it.

(Go to TOP)