Skip to content

v.net.bridge

Computes bridges and articulation points in the network.

v.net.bridge input=name output=name [arc_layer=string] [node_layer=string] [arc_column=name] [arc_backward_column=name] [node_column=string] method=string [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.net.bridge input=name output=name method=string

grass.script.run_command("v.net.bridge", input, output, arc_layer="1", node_layer="2", arc_column=None, arc_backward_column=None, node_column=None, method, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.net.bridge", input="name", output="name", method="string")

Parameters

input=name [required]
    Name of input vector map
    Or data source for direct OGR access
output=name [required]
    Name for output vector map
arc_layer=string
    Arc layer
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Default: 1
node_layer=string
    Node layer
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Default: 2
arc_column=name
    Arc forward/both direction(s) cost column (number)
arc_backward_column=name
    Arc backward direction cost column (number)
node_column=string
    Node cost column (number)
method=string [required]
    Feature type
    Allowed values: bridge, articulation
    bridge: Finds bridges
    articulation: Finds articulation points
--overwrite
    Allow output files to overwrite existing files
--help
    Print usage summary
--verbose
    Verbose module output
--quiet
    Quiet module output
--qq
    Very quiet module output
--ui
    Force launching GUI dialog

input : str, required
    Name of input vector map
    Or data source for direct OGR access
    Used as: input, vector, name
output : str, required
    Name for output vector map
    Used as: output, vector, name
arc_layer : str, optional
    Arc layer
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Used as: input, layer
    Default: 1
node_layer : str, optional
    Node layer
    Vector features can have category values in different layers. This number determines which layer to use. When used with direct OGR access this is the layer name.
    Used as: input, layer
    Default: 2
arc_column : str, optional
    Arc forward/both direction(s) cost column (number)
    Used as: input, dbcolumn, name
arc_backward_column : str, optional
    Arc backward direction cost column (number)
    Used as: input, dbcolumn, name
node_column : str, optional
    Node cost column (number)
method : str, required
    Feature type
    Allowed values: bridge, articulation
    bridge: Finds bridges
    articulation: Finds articulation points
overwrite: bool, optional
    Allow output files to overwrite existing files
    Default: False
verbose: bool, optional
    Verbose module output
    Default: False
quiet: bool, optional
    Quiet module output
    Default: False
superquiet: bool, optional
    Very quiet module output
    Default: False

DESCRIPTION

v.net.bridge finds bridges and articulation points in a network.

NOTES

Bridge in a network is an edge/line whose removal would disconnect the (sub-)network. A node is an articulation point if its removal would disconnect the (sub-)network. For more information and formal definitions check the wikipedia entries: bridge and articulation point.

The output of the module contains the selected features. For method=bridge, lines corresponding to bridges are copied from the input map to the output map. On the other hand, for method=articulation, points are created on the positions of articulation points.

In GRASS GIS, line is not always a single line segment. It might be, and often is, a sequence of line segments between two intersections. Also, articulation point is a standard graph theoretic terminology which is slightly misleading in GRASS. An articulation point in graph theory is an articulation node in GRASS terminology.

SEE ALSO

v.net, v.category

AUTHORS

Daniel Bundala, Google Summer of Code 2009, Student
Wolf Bergenheim, Mentor

SOURCE CODE

Available at: v.net.bridge source code (history)
Latest change: Friday Feb 07 19:16:09 2025 in commit a82a39f