1r.in.poly(1) Grass User's Manual r.in.poly(1)
2
3
4
6 r.in.poly - Creates raster maps from ASCII polygon/line/point data
7 files.
8
10 raster, import
11
13 r.in.poly
14 r.in.poly --help
15 r.in.poly input=name output=name [title=phrase] [type=string]
16 [null=integer] [rows=integer] [--overwrite] [--help] [--verbose]
17 [--quiet] [--ui]
18
19 Flags:
20 --overwrite
21 Allow output files to overwrite existing files
22
23 --help
24 Print usage summary
25
26 --verbose
27 Verbose module output
28
29 --quiet
30 Quiet module output
31
32 --ui
33 Force launching GUI dialog
34
35 Parameters:
36 input=name [required]
37 Name of input file; or "-" to read from stdin
38
39 output=name [required]
40 Name for output raster map
41
42 title=phrase
43 Title for resultant raster map
44
45 type=string
46 Type of raster map to be created
47 Storage type for resultant raster map
48 Options: CELL, FCELL, DCELL
49 Default: CELL
50 CELL: Integer
51 FCELL: Single precision floating point
52 DCELL: Double precision floating point
53
54 null=integer
55 Integer representing NULL value data cell
56
57 rows=integer
58 Number of rows to hold in memory
59 Default: 4096
60
62 r.in.poly allows the creation of GRASS binary raster maps from ASCII
63 files in the current directory containing polygon, linear, and point
64 features.
65
66 The input file is an ASCII text file containing the polygon, linear,
67 and point feature definitions. The format of this file is described in
68 the INPUT FORMAT section below.
69
70 The number of raster rows to hold in memory is per default 4096. This
71 parameter allows users with less memory (or more) on their system to
72 control how much memory r.in.poly uses. Usually the default value is
73 fine.
74
76 The data will be imported using the current region settings to set the
77 new raster map’s bounds and resolution. Any features falling outside
78 the current region will be cropped. The region settings are contolled
79 with the g.region module.
80
81 The format is a simplified version of the standard GRASS vector ASCII
82 format used by v.in.ascii.
83
84 Polygons are filled, i.e. they define an area.
85
86 Input Format
87 The input format for the input file consists of sections describing
88 either polygonal areas, linear features, or point features. The basic
89 format is:
90 A <for polygonal areas>
91 easting northing
92 .
93 .
94 .
95 = cat# label
96 L <for linear features>
97 easting northing
98 .
99 .
100 .
101 = cat# label
102 P <for single cell point features>
103 easting northing
104 = cat# label
105 The A signals the beginning of a filled polygon. It must appear in the
106 first column. The L signals the beginning of a linear feature. It
107 also must appear in the first column. The P signals the beginning of a
108 single cell point feature. Again, it must appear in the first column.
109 The coordinates of the vertices of the polygon, or the coordinates
110 defining the linear or point feature follow and must have a space in
111 the first column and at least one space between the easting and the
112 northing. To give meaning to the features, the "=" indicates that the
113 feature currently being processed has category value cat# (which must
114 be an integer) and a label (which may be more than one word, or which
115 may be omitted).
116
118 An area described by four points:
119 A
120 591316.80 4926455.50
121 591410.25 4926482.40
122 591434.60 4926393.60
123 591341.20 4926368.70
124 = 42 stadium
125
127 r.colors, d.rast.edit, g.region, r.in.xyz, r.patch, v.in.ascii, wxGUI
128 vector digitizer
129
131 Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
132
133 Last changed: $Date: 2014-11-01 11:07:51 +0100 (Sat, 01 Nov 2014) $
134
136 Available at: r.in.poly source code (history)
137
138 Main index | Raster index | Topics index | Keywords index | Graphical
139 index | Full index
140
141 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
142
143
144
145GRASS 7.4.4 r.in.poly(1)