r.in.poly(1)

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"]    [rows=integer]
16       [--overwrite]  [--verbose]  [--quiet]
17
18   Flags:
19       --overwrite
20           Allow output files to overwrite existing files
21
22       --verbose
23           Verbose module output
24
25       --quiet
26           Quiet module output
27
28   Parameters:
29       input=name
30           Name of input file
31
32       output=name
33           Name for output raster map
34
35       title=
36           Title for resultant raster map
37
38       rows=integer
39           Number of rows to hold in memory
40           Default: 4096
41

DESCRIPTION

43       r.in.poly  allows  the  creation of GRASS binary raster maps from ASCII
44       files in the current directory containing polygon,  linear,  and  point
45       features.
46
47       The  input  file  is an ASCII text file containing the polygon, linear,
48       and point feature definitions.  The format of this file is described in
49       the INPUT FORMAT section below.
50
51       The  number of raster rows to hold in memory is per default 4096.  This
52       parameter allows users with less memory (or more) on  their  system  to
53       control  how  much memory r.in.poly uses.  Usually the default value is
54       fine.
55

NOTES

57       The data will be imported using the current region settings to set  the
58       new  raster  map's  bounds and resolution. Any features falling outside
59       the current region will be cropped. The region settings  are  contolled
60       with the g.region module.
61
62       The  format  is a simplified version of the standard GRASS vector ASCII
63       format used by v.in.ascii.
64
65       Polygons are filled, i.e. they define an area.
66

INPUT FORMAT

68       The input format for the input file  consists  of  sections  describing
69       either  polygonal  areas, linear features, or point features. The basic
70       format is:
71       A                      <for polygonal areas>
72           easting northing
73           .
74           .
75           .
76       =   cat# label
77       L                      <for linear features>
78           easting northing
79           .
80           .
81           .
82       =   cat# label
83       P                      <for single cell point features>
84           easting northing
85       =   cat# label
86        The A signals the beginning of a filled polygon.  It  must  appear  in
87       the first column.  The L signals the beginning of a linear feature.  It
88       also must appear in the first column.  The P signals the beginning of a
89       single  cell point feature.  Again, it must appear in the first column.
90       The coordinates of the vertices of  the  polygon,  or  the  coordinates
91       defining  the  linear  or point feature follow and must have a space in
92       the first column and at least one space between  the  easting  and  the
93       northing.  To  give meaning to the features, the "=" indicates that the
94       feature currently being processed has category value cat#  (which  must
95       be  an  integer) and a label (which may be more than one word, or which
96       may be omitted).
97

EXAMPLE

99       An area described by four points:
100       A
101         591316.80   4926455.50
102         591410.25   4926482.40
103         591434.60   4926393.60
104         591341.20   4926368.70
105       = 42 stadium
106
107

AUTHOR

117       Michael Shapiro, U.S.Army Construction Engineering Research Laboratory
118
119       Last changed: $Date: 2007-06-14 09:51:30 +0200 (Thu, 14 Jun 2007) $
120
121       Full index
122
123       © 2003-2008 GRASS Development Team
124
125
126
127GRASS 6.3.0                                                       r.in.poly(1)