v.split(1grass)

1v.split(1)                    Grass User's Manual                   v.split(1)
2
3
4

NAME

6       v.split  - Splits vector lines to shorter segments.
7

KEYWORDS

9       vector, geometry, densification, node, segment, vertex
10

SYNOPSIS

12       v.split
13       v.split --help
14       v.split  [-nf]  input=name  [layer=string]  output=name  [length=float]
15       [units=string]   [vertices=integer]   [--overwrite]  [--help]   [--ver‐
16       bose]  [--quiet]  [--ui]
17
18   Flags:
19       -n
20           Add new vertices, but do not split
21           Applies only to ’length’ option
22
23       -f
24           Force segments to be exactly of given length, except for last one
25           Applies only to ’length’ option
26
27       --overwrite
28           Allow output files to overwrite existing files
29
30       --help
31           Print usage summary
32
33       --verbose
34           Verbose module output
35
36       --quiet
37           Quiet module output
38
39       --ui
40           Force launching GUI dialog
41
42   Parameters:
43       input=name [required]
44           Name of input vector map
45           Or data source for direct OGR access
46
47       layer=string
48           Layer number or name (’-1’ for all layers)
49           A  single  vector map can be connected to multiple database tables.
50           This number determines which table to use. When  used  with  direct
51           OGR access this is the layer name.
52           Default: -1
53
54       output=name [required]
55           Name for output vector map
56
57       length=float
58           Maximum segment length
59
60       units=string
61           Length units
62           Options:  map,  meters,  kilometers, feet, surveyfeet, miles, naut‐
63           miles
64           Default: map
65
66       vertices=integer
67           Maximum number of vertices in segment
68

DESCRIPTION

70       v.split splits vector lines into shorter segments using a maximal  dis‐
71       tance  between  nodes. The resulting length of all segments is expected
72       to be equal and not higher than the given length parameter.
73

EXAMPLES

75       The examples are based on the North Carolina sample data location.
76
77   Example 1: Inserting nodes to railroad lines map
78       # extract one railroad line for this example
79       v.extract input=railroads output=myrr cats=1
80       # show line, category, direction (to find the beginning)
81       g.region vector=myrr
82       d.erase
83       d.vect myrr display=shape,cat,dir
84       # insert nodes at a distance not longer than 1000m
85       v.split input=myrr output=myrr_split_1km length=1000
86       d.vect myrr_split_1km display=shape,topo
87
88       Note: In case that the vector line data  are  not  polylines,  generate
89       first polylines as the second step, eg.:
90       # join segments into polyline
91       v.build.polylines input=myrr output=myrr_polylines
92       # regenerate categories
93       v.category input=myrr_polylines output=myrailroads option=add
94
95   Example 2: Inserting vertices to railroad lines map
96       Note: first run the two steps from example 1.
97       # insert vertices at a distance not longer than 1000m
98       v.split -n input=myrr output=myrr_split length=1000
99       d.vect myrr_split display=shape,topo
100

AUTHOR

105       Radim Blazek
106
107       Last changed: $Date: 2016-03-10 18:02:58 +0100 (Thu, 10 Mar 2016) $
108

SOURCE CODE

110       Available at: v.split source code (history)
111
112       Main  index  | Vector index | Topics index | Keywords index | Graphical
113       index | Full index
114
115       © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
116
117
118
119GRASS 7.4.4                                                         v.split(1)