3
3
<em>v.build.polylines</em> builds polylines from the lines or
4
boundaries in a vector map. <!-- ???? and copies the attribute
5
and category files from the original file. -->
4
boundaries in a vector map.
7
7
A line is a single straight line segment defined by one start node, one end
8
8
node and no other nodes. A polyline is also defined by one start node, one end
9
9
node and no other nodes, but is made of two or more consecutive straight line
10
10
segments. The connections between the constituent line segments of a polyline
11
11
do not appear as nodes in the vector map.
14
<em>v.build.polyline</em> picks a line and from its start node, walks
15
back as long as exactly one other line is connected to this node. Line
16
directions are reversed as required, i.e. it does not matter if the
17
next line is connected to the current node by its start or end
18
node. Once the start line of a polyline is identified, it walks
19
forward and adds all vertices (in reverse order if needed) of
20
connected lines to the start line, i.e. the start line and connecting
21
lines are reversed as needed. That is, if a line is reversed depends
22
on what node is initially picked for building polylines. If the
23
direction of lines is important (it's not for boundaries to build
24
areas), you have to manually change line directions with
25
either <em><a href="v.edit.html">v.edit</a></em>, <em><a href="v.digit.html">v.digit</a></em>,
26
or the <em><a href="wxGUI.Vector_Digitizing_Tool.html">wxGUI vector
13
30
Polylines provide the most appropriate representation of curved lines when it
14
31
is important that nodes serve to define topology rather than geometry. Curved
15
32
lines are usually digitized as polylines, but these are sometimes broken into
23
39
If the lines that make up a polyline are of different types, then
24
<i>v.build.polylines</i> will set the type from the first constituent line.
26
<i>v.build.polylines </i> will issue a warning unless the flag <b>-q</b> has
27
been set. It is possible to keep a list of all such warnings by redirecting
28
standard output to a file.
40
<em>v.build.polylines</em> will set the type from the first constituent line.
32
43
Category number(s) are assigned to a polyline based on <b>cats</b> parameter.
35
<li>cats=no - No category number is assigned to a polyline. Also
36
attributes tables linked to the input vector map are not copied to
37
the output vector map.</li>
38
<li>cats=first - Assign to a polyline category number of the first
39
line. All linked attributes tables are copied to the output vector map.</li>
40
<li>cats=multi - If the lines that make up a polyline have different category numbers
41
then <em>v.build.polylines</em> will set the multiple catetory numbers to a polyline.
42
Also all linked attributes tables are copied to the output vector map.</li>
46
<li><b>cats=no</b> - No category number is assigned to a
47
polyline. Also attributes tables linked to the input vector map are
48
not copied to the output vector map.</li>
49
<li><b>cats=first</b> - Assign to a polyline category number of the
50
first line. All linked attributes tables are copied to the output
52
<li><b>cats=multi</b> - If the lines that make up a polyline have
53
different category numbers then <em>v.build.polylines</em> will
54
set the multiple catetory numbers to a polyline. Also all linked
55
attributes tables are copied to the output vector map.</li>
46
58
<em>v.build.polylines</em> correctly handles <b>input</b> vector maps
47
59
containing lines, boundaries, centroids and points. Lines and
48
60
boundaries will be converted to polylines of the desired type. Areas
49
61
are only guaranteed to be preserved if the constituent lines of the
50
62
polylines that define them are all boundaries in the input vector map.
52
<!-- Points will remain points provided that <b>type</b> has been set to `source'.
53
It is possible to convert lines and area edges to points or vice versa, but this
54
is rarely useful. [type no longer exists, other behaviour still true??] -->
64
<!-- Points will remain points provided that <b>type</b> has been set
65
to `source'. It is possible to convert lines and area edges to points
66
or vice versa, but this is rarely useful. [type no longer exists,
67
other behaviour still true??] -->
57
69
<h2>ACKNOWLEDGEMENTS</h2>
58
71
This program was originally written during Mark Lake's tenure of a
59
72
Leverhulme Special Research Fellowship at University College London.
63
<a href=v.build.html>v.build</a>,
64
<a href=v.in.ascii.html>v.in.ascii</a>,
65
<a href="v.split.html">v.split</a>,
66
<a href="v.edit.html">v.edit</a>
77
<a href="v.build.html">v.build</a>,
78
<a href="v.in.ascii.html">v.in.ascii</a>,
79
<a href="v.split.html">v.split</a>,
80
<a href="v.edit.html">v.edit</a>