← Back to branch summary

~ubuntu-branches/ubuntu/vivid/grass/vivid-proposed

« back to all changes in this revision

Viewing changes to vector/v.build.polylines/description.html

  • Committer: Package Import Robot
  • Author(s): Bas Couwenberg
  • Date: 2015-02-20 23:12:08 UTC
  • mfrom: (8.2.6 experimental)
  • Revision ID: package-import@ubuntu.com-20150220231208-1u6qvqm84v430b10
Tags: 7.0.0-1~exp1
* New upstream release.
* Update python-ctypes-ternary.patch to use if/else instead of and/or.
* Drop check4dev patch, rely on upstream check.
* Add build dependency on libpq-dev to grass-dev for libpq-fe.h.
* Drop patches applied upstream, refresh remaining patches.
* Update symlinks for images switched from jpg to png.

Show diffs side-by-side

added added

removed removed

Lines of Context:
vector/v.build.polylines/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>v.build.polylines</em> builds polylines from the lines or
4
 
boundaries in a vector map.
5
 
 
6
 
<p>
7
 
A line is defined by one start node, one end node and any number of
8
 
vertices between the start and end node. The shortest possible line
9
 
consists of only two vertices where the coordinates of the start and end
10
 
node are identical to those of the two vertices.
11
 
 
12
 
<p>
13
 
<em>v.build.polyline</em> picks a line and from its start node, walks
14
 
back as long as exactly one other line of the same type is connected to
15
 
this node. Line directions are reversed as required, i.e. it does not
16
 
matter if the next line is connected to the current node by its start or
17
 
end node. Once the start line of a polyline is identified, it walks
18
 
forward and adds all vertices (in reverse order if needed) of
19
 
connected lines to the start line, i.e. the start line and connecting
20
 
lines are reversed as needed. That is, if a line is reversed depends
21
 
on what node is initially picked for building polylines. If the
22
 
direction of lines is important (it's not for boundaries to build
23
 
areas), you have to manually change line directions with
24
 
either <em><a href="v.edit.html">v.edit</a></em>, <em><a href="v.digit.html">v.digit</a></em>,
25
 
or the <em><a href="wxGUI.Vector_Digitizer.html">wxGUI vector
26
 
digitizer</a></em>.
27
 
 
28
 
<p>
29
 
Polylines provide the most appropriate representation of curved lines when it 
30
 
is important that nodes serve to define topology rather than geometry. Curved 
31
 
lines are usually digitized as polylines, but these are sometimes broken into 
32
 
their constituent straight line segments during conversion from one data 
33
 
format to another. <em>v.build.polylines</em> can be used to rebuild such broken 
34
 
polylines. 
35
 
 
36
 
<h2>NOTES</h2>
37
 
 
38
 
<em>v.build.polylines</em> combines only lines of the same type to
39
 
a new polyline, i.e. lines and boundaries are kept separate.
40
 
 
41
 
<p>
42
 
Category number(s) are assigned to a polyline based on <b>cats</b> parameter.
43
 
 
44
 
<ul>
45
 
  <li><b>cats=no</b> - No category number is assigned to a
46
 
  polyline. Also attributes tables linked to the input vector map are
47
 
  not copied to the output vector map.</li>
48
 
  <li><b>cats=first</b> - Assign to a polyline category number of the
49
 
first line. All linked attributes tables are copied to the output
50
 
vector map.</li>
51
 
  <li><b>cats=multi</b> - If the lines that make up a polyline have
52
 
    different category numbers then <em>v.build.polylines</em> will
53
 
    set the multiple catetory numbers to a polyline.  Also all linked
54
 
    attributes tables are copied to the output vector map.</li>
55
 
</ul>
56
 
 
57
 
<em>v.build.polylines</em> correctly handles <b>input</b> vector maps
58
 
containing lines, boundaries, centroids and points. Lines and
59
 
boundaries will be converted to polylines.  Areas
60
 
are guaranteed to be preserved.
61
 
 
62
 
<!-- Points will remain points provided that <b>type</b> has been set
63
 
to `source'.  It is possible to convert lines and area edges to points
64
 
or vice versa, but this is rarely useful.  [type no longer exists,
65
 
other behaviour still true??] -->
66
 
 
67
 
<h2>ACKNOWLEDGEMENTS</h2>
68
 
 
69
 
This program was originally written during Mark Lake's tenure of a 
70
 
Leverhulme Special Research Fellowship at University College London. 
71
 
 
72
 
<h2>SEE ALSO</h2> 
73
 
 
74
 
<em>
75
 
  <a href="v.build.html">v.build</a>,
76
 
  <a href="v.in.ascii.html">v.in.ascii</a>,
77
 
  <a href="v.split.html">v.split</a>,
78
 
  <a href="v.edit.html">v.edit</a>
79
 
</em>
80
 
 
81
 
<h2>AUTHORS</h2>
82
 
Mark Lake, Institute of Archaeology, University College London.<br> 
83
 
Major rewrite by Radim Blazek, October 2002<br>
84
 
Category mode added by Martin Landa, FBK-irst, Trento, Italy, October 2007<br>
85
 
Support for categories, attributes, and different line types by Markus Metz
86
 
 
87
 
<p>
88
 
<i>Last changed: $Date: 2014-02-10 18:24:20 +0100 (Mon, 10 Feb 2014) $</i>