1r.in.poly(1)                  Grass User's Manual                 r.in.poly(1)
2
3
4

NAME

6       r.in.poly   -  Creates  raster  maps from ASCII polygon/line/point data
7       files.
8

KEYWORDS

10       raster, import
11

SYNOPSIS

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

DESCRIPTION

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

NOTES

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

EXAMPLE

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

SEE ALSO

127         r.colors, d.rast.edit, g.region, r.in.xyz, r.patch, v.in.ascii, wxGUI
128       vector digitizer
129

AUTHOR

131       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
132

SOURCE CODE

134       Available at: r.in.poly source code (history)
135
136       Main index | Raster index | Topics index | Keywords index  |  Graphical
137       index | Full index
138
139       © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
140
141
142
143GRASS 7.8.2                                                       r.in.poly(1)
Impressum