← Back to branch summary

~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to vector/v.out.ascii/description.html

Tags: 7.0.0~rc1+ds1-1~exp1
http://bugs.debian.org/776349
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
vector/v.out.ascii/description.html
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>v.out.ascii</em> converts a GRASS vector map in binary format to a
4
 
GRASS vector map in ASCII format. Using
5
 
flag <b>-o</b> <em>v.out.ascii</em> output will be in old (version 4)
6
 
ASCII format.
7
 
 
8
 
<p>
9
 
If the <b>output</b> parameter is not given then the coordinates of any 
10
 
<em>point</em> data within the vector map is sent to stdout.
11
 
 
12
 
<h2>NOTES</h2>
13
 
 
14
 
The <em><a href="v.in.ascii.html">v.in.ascii</a></em> module performs
15
 
the function of <em>v.out.ascii</em> in reverse; i.e. it converts
16
 
vector maps in ASCII format to their binary format.  These two
17
 
companion module are useful both for importing and exporting vector
18
 
maps between GRASS and other software, and for transferring data
19
 
between machines.
20
 
 
21
 
<p>
22
 
If the <b>format</b> parameter is set to <b>standard</b>, a GRASS
23
 
ASCII vector map will be exported, which may contain a mix of
24
 
primitives including points, lines, boundaries, centroids, areas,
25
 
faces, and kernels. The beginning of the output ascii file will
26
 
contain a header listing any metadata for the input vector map, if
27
 
such metadata exists. An example of the <b>standard</b> format is
28
 
given below.
29
 
 
30
 
<p>The header is similar as the head file of vector binary format but
31
 
contains bounding box also. Key words are:
32
 
 
33
 
<pre>
34
 
ORGANIZATION
35
 
DIGIT DATE
36
 
DIGIT NAME
37
 
MAP NAME
38
 
MAP DATE
39
 
MAP SCALE
40
 
OTHER INFO
41
 
ZONE
42
 
WEST EDGE
43
 
EAST EDGE
44
 
SOUTH EDGE
45
 
NORTH EDGE
46
 
MAP THRESH
47
 
</pre>
48
 
 
49
 
<p>The body begins with the row:
50
 
 
51
 
<pre>
52
 
VERTI:
53
 
</pre>
54
 
 
55
 
followed by records of primitives:
56
 
 
57
 
<pre>
58
 
TYPE NUMBER_OF_COORDINATES [NUMBER_OF_CATEGORIES]
59
 
 X Y [Z]
60
 
....
61
 
 X Y [Z]
62
 
[ LAYER CATEGORY]
63
 
....
64
 
[ LAYER CATEGORY]
65
 
</pre>
66
 
 
67
 
Everything above in <tt>[&nbsp;]</tt> is optional. 
68
 
 
69
 
<p>
70
 
The primitive codes are as follows:
71
 
<ul>
72
 
<li>'P': point</li>
73
 
<li>'L': line</li>
74
 
<li>'B': boundary</li>
75
 
<li>'C': centroid</li>
76
 
<li>'F': face (3D boundary)</li>
77
 
<li>'K': kernel (3D centroid)</li>
78
 
<li>'A': area (boundary) - better use 'B'; kept only for backward compatibility</li>
79
 
</ul>
80
 
 
81
 
The coordinates are listed following the initial line containing the
82
 
primitive code, the total number of vectors in the series, and (optionally)
83
 
the number of categories (1 for a single layer, higher for multiple layers).
84
 
Below that 1 or several lines follow to indicate the layer number and
85
 
the category number (ID).
86
 
<br>
87
 
The order of coordinates is
88
 
<div class="code"><pre>
89
 
  X Y [Z]
90
 
</pre></div>
91
 
 
92
 
In pre-GRASS 6 versions of the ASCII file, the order of coordinates is:
93
 
<div class="code"><pre>
94
 
Y X
95
 
</pre></div>
96
 
 
97
 
If old version is requested, the <b>output</b> files from <em>v.out.ascii</em> is placed 
98
 
in the <tt>$LOCATION/$MAPSET/dig_ascii/</tt> and <tt>$LOCATION/$MAPSET/dig_att</tt> directory.
99
 
 
100
 
<p>
101
 
Only features with a category number will be
102
 
exported. Use <em>v.category</em> to add them if needed.
103
 
 
104
 
<p>
105
 
<em>v.out.ascii</em> does not copy the <em>dig_cats</em> file
106
 
associated with the binary vector <em>input</em> map to the
107
 
new <em>output</em> file name. The user must copy
108
 
the <em>dig_cats</em> file to the new <em>output</em> name if this is
109
 
desired (e.g. using the UNIX <em>cp</em> command).
110
 
 
111
 
<p>
112
 
It is possible to output the coordinates of vertices in a non-points vector
113
 
feature by first converting the vector feature to a points map with 
114
 
<em>v.to.points</em> and then exporting with <em>v.out.ascii</em> in 
115
 
<em>points</em> mode.
116
 
 
117
 
<h2>EXAMPLES</h2>
118
 
 
119
 
<h3>Standard mode</h3>
120
 
 
121
 
<p>
122
 
<div class="code"><pre>
123
 
v.out.ascii input=quads format=standard
124
 
 
125
 
ORGANIZATION: US Army Const. Eng. Rsch. Lab
126
 
DIGIT DATE:   May 1987
127
 
DIGIT NAME:   grass
128
 
MAP NAME:     Quads
129
 
MAP DATE:     May 1987
130
 
MAP SCALE:    24000
131
 
OTHER INFO:
132
 
ZONE:         13
133
 
MAP THRESH:   18.288000
134
 
VERTI:
135
 
B  4
136
 
 599587.1820962 4914067.53414294
137
 
 589639.15126831 4913922.5687301
138
 
 589440.96838162 4927803.62500018
139
 
 599375.87959179 4927959.83330436
140
 
B  2
141
 
 599375.87959179 4927959.83330436
142
 
 599587.1820962 4914067.53414294
143
 
B  4
144
 
 599587.1820962 4914067.53414294
145
 
 609541.5508239 4914236.0597482
146
 
 609316.10665227 4928116.8490555
147
 
 599375.87959179 4927959.83330436
148
 
C  1 1
149
 
 594125.63    4921115.58
150
 
 1     1
151
 
C  1 1
152
 
 604433.84    4921087.1
153
 
 1     2
154
 
</pre></div>
155
 
 
156
 
<h3>Point mode</h3>
157
 
 
158
 
<div class="code"><pre>
159
 
v.out.ascii input=quads format=point
160
 
 
161
 
594125.63|4921115.58|1
162
 
604433.84|4921087.1|2
163
 
</pre></div>
164
 
 
165
 
<div class="code"><pre>
166
 
v.out.ascii input=archsites format=point where="cat > 5 and cat <= 8" columns=str1
167
 
 
168
 
600375|4925235|6|Prairie Site
169
 
606635|4920773|7|Jensen Pass
170
 
595755|4925300|8|No Name
171
 
</pre></div>
172
 
 
173
 
<h2>SEE ALSO</h2>
174
 
 
175
 
<em>
176
 
<a href="v.category.html">v.category</a>,
177
 
<a href="v.in.ascii.html">v.in.ascii</a>,
178
 
<a href="v.to.points.html">v.to.points</a><br>
179
 
<a HREF="sql.html">GRASS SQL interface</a>
180
 
</em>
181
 
 
182
 
<h2>AUTHORS</h2>
183
 
 
184
 
Michael Higgins, 
185
 
U.S. Army Construction Engineering 
186
 
Research Laboratory
187
 
<br>
188
 
James Westervelt, 
189
 
U.S. Army Construction Engineering 
190
 
Research Laboratory
191
 
<br>
192
 
Radim Blazek, ITC-Irst, Trento, Italy
193
 
<br>
194
 
Attribute selection added by Martin Landa, CTU in Prague, Czech Republic (2008/12)
195
 
 
196
 
<p>
197
 
<i>Last changed: $Date: 2010-02-17 08:56:18 +0100 (Wed, 17 Feb 2010) $</i>