Skip to content

v.parallel

Creates parallel line to input vector lines.

v.parallel [-rb] input=name [layer=string] output=name distance=float [minordistance=float] [angle=float] side=string [tolerance=float] [--overwrite] [--verbose] [--quiet] [--qq] [--ui]

Example:

v.parallel input=name output=name distance=float side=right

grass.script.run_command("v.parallel", input, layer="-1", output, distance, minordistance=None, angle=0, side="right", tolerance=None, flags=None, overwrite=False, verbose=False, quiet=False, superquiet=False)

Example:

gs.run_command("v.parallel", input="name", output="name", distance=float, side="right")

Parameters

input=name [required]
    Name of input vector map
    Or data source for direct OGR access
layer=string
    Layer number or name ('-1' for all layers)
    A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
    Default: -1
output=name [required]
    Name for output vector map
distance=float [required]
    Offset along major axis in map units
    Allowed values: 0-100000000
minordistance=float
    Offset along minor axis in map units
    Allowed values: 0-100000000
angle=float
    Angle of major axis in degrees
    Default: 0
side=string [required]
    Side
    Allowed values: left, right, both
    Default: right
    left: Parallel line is on the left
    right: Parallel line is on the right
    both: Parallel lines on both sides
tolerance=float
    Tolerance of arc polylines in map units
    Allowed values: 0-100000000
-r
    Make outside corners round
-b
    Create buffer-like parallel lines
--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
layer : str, optional
    Layer number or name ('-1' for all layers)
    A single vector map can be connected to multiple database tables. This number determines which table to use. When used with direct OGR access this is the layer name.
    Used as: input, layer
    Default: -1
output : str, required
    Name for output vector map
    Used as: output, vector, name
distance : float, required
    Offset along major axis in map units
    Allowed values: 0-100000000
minordistance : float, optional
    Offset along minor axis in map units
    Allowed values: 0-100000000
angle : float, optional
    Angle of major axis in degrees
    Default: 0
side : str, required
    Side
    Allowed values: left, right, both
    left: Parallel line is on the left
    right: Parallel line is on the right
    both: Parallel lines on both sides
    Default: right
tolerance : float, optional
    Tolerance of arc polylines in map units
    Allowed values: 0-100000000
flags : str, optional
    Allowed values: r, b
    r
        Make outside corners round
    b
        Create buffer-like parallel lines
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.parallel creates parallel lines to the input vector lines which can be used as half-buffers.

NOTES

Usage of -b flag will overrule the side parameter.

KNOWN ISSUES

There is a problem with side-offset parallel line generation for inside corners. To avoid this problem, the -b flag might be used.

SEE ALSO

v.buffer

AUTHORS

Radim Blazek
Rewritten by Rosen Matev (with support through the Google Summer of Code program 2008)

SOURCE CODE

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