← Back to branch summary

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

« back to all changes in this revision

Viewing changes to raster/r.in.poly/r.in.poly.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:
raster/r.in.poly/r.in.poly.html
 
1
<h2>DESCRIPTION</h2>
 
2
 
 
3
<em>r.in.poly</em> allows the creation of GRASS binary
 
4
raster maps from ASCII files in the current directory
 
5
containing polygon, linear, and point features.
 
6
 
 
7
<p>
 
8
The <b>input</b> file is an ASCII text file containing the
 
9
polygon, linear, and point feature definitions.
 
10
The format of this file is described in the
 
11
<a href="#format.html"><i>INPUT FORMAT</i></a> section below.
 
12
 
 
13
<p>
 
14
The number of raster <b>rows</b> to hold in memory is per default 4096.
 
15
This parameter allows users with less memory (or more) on their
 
16
system to control how much memory <em>r.in.poly</em> uses.
 
17
Usually the default value is fine.
 
18
 
 
19
 
 
20
<h2>NOTES</h2>
 
21
 
 
22
<p>
 
23
The data will be imported using the current region settings to set the
 
24
new raster map's bounds and resolution. Any features falling outside
 
25
the current region will be cropped. The region settings are contolled
 
26
with the <em>g.region</em> module.
 
27
 
 
28
<p>
 
29
The format is a simplified version of the standard GRASS vector ASCII
 
30
format used by <em>v.in.ascii</em>.
 
31
 
 
32
<p>
 
33
Polygons are filled, i.e. they define an area.
 
34
 
 
35
<A NAME="format.html"></a>
 
36
<h3>Input Format</h3>
 
37
 
 
38
The input format for the <b>input</b> file consists of
 
39
sections describing either polygonal areas, linear features, or
 
40
point features. The basic format is:
 
41
 
 
42
<div class="code"><pre>
 
43
A                      &lt;for polygonal areas&gt;
 
44
    easting northing
 
45
    .
 
46
    .
 
47
    .
 
48
=   cat# label
 
49
L                      &lt;for linear features&gt;
 
50
    easting northing
 
51
    .
 
52
    .
 
53
    .
 
54
=   cat# label
 
55
P                      &lt;for single cell point features&gt;
 
56
    easting northing
 
57
=   cat# label
 
58
</pre></div>
 
59
 
 
60
 
 
61
The <tt>A</tt> signals the beginning of a filled polygon.
 
62
It must appear in the first column.
 
63
 
 
64
The <tt>L</tt> signals the beginning of a linear feature.
 
65
It also must appear in the first column.
 
66
 
 
67
The <tt>P</tt> signals the beginning of a single cell point feature.
 
68
Again, it must appear in the first column.
 
69
 
 
70
The coordinates of the vertices of the polygon, or the coordinates defining
 
71
the linear or point feature follow and must have a space in the first
 
72
column and at least one space between the <em>easting</em> and the
 
73
<em>northing.</em> To give meaning to the features, the
 
74
"<tt>=</tt>" indicates that the feature currently being
 
75
processed has category value <em>cat#</em> (which must be
 
76
an integer) and a <em>label</em> (which may be more than
 
77
one word, or which may be omitted).
 
78
 
 
79
 
 
80
<h2>EXAMPLE</h2>
 
81
 
 
82
An area described by four points:
 
83
 
 
84
<div class="code"><pre>
 
85
A
 
86
  591316.80   4926455.50
 
87
  591410.25   4926482.40
 
88
  591434.60   4926393.60
 
89
  591341.20   4926368.70
 
90
= 42 stadium
 
91
</pre></div>
 
92
 
 
93
<h2>SEE ALSO</h2>
 
94
 
 
95
<em>
 
96
<a href="r.colors.html">r.colors</a>,
 
97
<a href="d.rast.edit.html">d.rast.edit</a>,
 
98
<a href="g.region.html">g.region</a>,
 
99
<a href="r.in.xyz.html">r.in.xyz</a>,
 
100
<a href="r.patch.html">r.patch</a>,
 
101
<a href="v.in.ascii.html">v.in.ascii</a>,
 
102
<a href="wxGUI.vdigit.html">wxGUI vector digitizer</a>
 
103
</em>
 
104
 
 
105
<h2>AUTHOR</h2>
 
106
 
 
107
Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
 
108
 
 
109
<p><i>Last changed: $Date: 2014-11-01 11:11:04 +0100 (Sat, 01 Nov 2014) $</i>