GRASS logo

NAME

v.net - Performs network maintenance.

KEYWORDS

vector, networking

SYNOPSIS

v.net
v.net help
v.net [-c] [input=name] [points=name] [output=name] operation=string alayer=string nlayer=string [thresh=float] [file=name] [--overwrite] [--verbose] [--quiet]

Flags:

-c
Assign unique categories to new points
For operation 'nodes'
--overwrite
Allow output files to overwrite existing files
--verbose
Verbose module output
--quiet
Quiet module output

Parameters:

input=name
Name of input vector line map (arcs)
Required for operation 'nodes', 'connect', 'report' and 'nreport'
points=name
Name of input vector point map (nodes)
Required for operation 'connect' and 'arcs'
output=name
Name for output vector map
operation=string
Operation to be performed
Options: nodes,connect,arcs,report,nreport
nodes: new point is placed on each node (line end) if doesn't exist
connect: connect still unconnected points to vector network by inserting new line(s)
arcs: new line is created from start point to end point
report: print to standard output {line_category start_point_category end_point_category}
nreport: print to standard output {point_category line_category[,line_category...]}
alayer=string
Arc layer
A single vector map can be connected to multiple database tables. This number determines which table to use. Layer name for direct OGR access.
Default: 1
nlayer=string
Node layer
A single vector map can be connected to multiple database tables. This number determines which table to use. Layer name for direct OGR access.
Default: 2
thresh=float
Threshold
Required for operation 'connect'. Connect points in given threshold.
file=name
Name of input file
Required for operation 'arcs'. '-' for standard input.

DESCRIPTION

v.net is used for vector network maps maintenance. It reports the current network graph status. It also permits to globally insert missing nodes or arcs and to connect unconnected nodes to the graph within a given distance threshold.

NOTES

If vector editing is required to modify the graph, wxGUI vector digitizer or v.edit can be used. Separately, Linear Referencing System is available in GRASS.

EXAMPLES

NC dataset based examples.

Create nodes globally for all line ends and intersections:

v.net input=streams output=streams_node operation=nodes
Merge in nodes from a separate map within given threshold:
v.net input=streams points=firestations out=streems_net operation=connect thresh=500
For generating network for given vector point map is required input file in format
[category of edge] [category of start node] [category of end node]
v.net points=geodetic_swwake_pts output=geodetic_swwake_pts_net operation=arcs file=- << EOF
> 1 28000 28005
> 2 27945 27958
> 3 27886 27897
> EOF

SEE ALSO

wxGUI vector digitizer, v.edit
v.net.iso, v.net.path, v.net.steiner, v.net.salesman

AUTHORS

Radim Blazek, ITC-irst, Trento, Italy
Martin Landa, FBK-irst (formerly ITC-irst), Trento, Italy and CTU in Prague, Czech Republic (operation 'connect' and 'arcs')

Last changed: $Date: 2009-01-19 14:31:57 -0800 (Mon, 19 Jan 2009) $


Main index - vector index - Full index

© 2003-2011 GRASS Development Team