1r.in.ascii(1) Grass User's Manual r.in.ascii(1)
2
3
4
6 r.in.ascii - Converts a GRASS ASCII raster file to binary raster map.
7
9 raster, import, conversion, ASCII
10
12 r.in.ascii
13 r.in.ascii --help
14 r.in.ascii [-s] input=name output=name [type=string] [title=phrase]
15 [multiplier=float] [null_value=string] [--overwrite] [--help]
16 [--verbose] [--quiet] [--ui]
17
18 Flags:
19 -s
20 SURFER (Golden Software) ASCII file will be imported
21
22 --overwrite
23 Allow output files to overwrite existing files
24
25 --help
26 Print usage summary
27
28 --verbose
29 Verbose module output
30
31 --quiet
32 Quiet module output
33
34 --ui
35 Force launching GUI dialog
36
37 Parameters:
38 input=name [required]
39 Name of input file to be imported
40 ’-’ for standard input
41
42 output=name [required]
43 Name for output raster map
44
45 type=string
46 Type of raster map to be created
47 Default: CELL for integer values, DCELL for floating-point values
48 Options: CELL, FCELL, DCELL
49 CELL: Integer
50 FCELL: Single precision floating point
51 DCELL: Double precision floating point
52
53 title=phrase
54 Title for resultant raster map
55
56 multiplier=float
57 Multiplier for ASCII data
58 Default: read from header
59
60 null_value=string
61 String representing NULL value data cell
62 Default: read from header
63
65 r.in.ascii allows a user to create a (binary) GRASS raster map layer
66 from an ASCII raster input file with (optional) TITLE.
67
68 The GRASS ASCII input file has a header section which describes the
69 location and size of the data, followed by the data itself.
70
71 The header has 6 lines:
72 north: xxxxxx.xx
73 south: xxxxxx.xx
74 east: xxxxxx.xx
75 west: xxxxxx.xx
76 rows: r
77 cols: c
78 The north, south, east, and west field values entered are the coordi‐
79 nates of the edges of the geographic region. The rows and cols field
80 values entered describe the dimensions of the matrix of data to follow.
81 The data which follows is r rows of c integers.
82
83 Optionally the following parameters can be defined in the header sec‐
84 tion:
85 null: nn
86 type: float
87 multiplier: 2.
88
89 "null" defines a string or number to be converted to NULL value (no
90 data).
91 "type" defines the data type (int, float double) and is not required.
92 "multiplier" is an optional parameter to multiply each cell value.
93
95 The geographic coordinates north, south, east, and west describe the
96 outer edges of the geographic region. They run along the edges of the
97 cells at the edge of the geographic region and not through the center
98 of the cells at the edges. The NW value occurs at the beginning of the
99 first line of data, and the SW value occurs at the beginning of the
100 last line of data.
101
102 The data (which follows the header section) must contain r x c values,
103 but it is not necessary that all the data for a row be on one line. A
104 row may be split over many lines.
105
106 r.in.ascii may import integer, floating point, or double cell types
107 using the -i, -f, and -d flags, respectively.
108
109 The header information in ESRI Raster ASCII files differs from GRASS.
110 To convert an Arc/Info (ArcView) ASCII grid file into GRASS, see
111 r.in.gdal.
112
113 SURFER (Golden Software) ASCII files may be imported by passing the -s
114 flag.
115
117 The following is a sample input file to r.in.ascii:
118 north: 4299000.00
119 south: 4247000.00
120 east: 528000.00
121 west: 500000.00
122 rows: 10
123 cols: 15
124 null: -9999
125 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
126 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
127 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
128 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
129 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
130 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
131 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
132 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
133 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
134 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
135
137 r.import, r.out.ascii, r.in.gdal, r.out.gdal, r.in.bin, r3.in.ascii
138
140 Michael Shapiro, U.S. Army Construction Engineering Research Laboratory
141 Surfer support by Roger Miller
142
143 Last changed: $Date: 2016-01-16 20:47:30 +0100 (Sat, 16 Jan 2016) $
144
146 Available at: r.in.ascii source code (history)
147
148 Main index | Raster index | Topics index | Keywords index | Graphical
149 index | Full index
150
151 © 2003-2019 GRASS Development Team, GRASS GIS 7.4.4 Reference Manual
152
153
154
155GRASS 7.4.4 r.in.ascii(1)