1r.in.ascii(1) Grass User's Manual r.in.ascii(1)
2
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 Flags:
19 -s
20 SURFER (Golden Software) ASCII file will be imported
21 --overwrite
23 Allow output files to overwrite existing files
24 --help
26 Print usage summary
27 --verbose
29 Verbose module output
30 --quiet
32 Quiet module output
33 --ui
35 Force launching GUI dialog
36 Parameters:
38 input=name [required]
39 Name of input file to be imported
40 ’-’ for standard input
41 output=name [required]
43 Name for output raster map
44 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 title=phrase
54 Title for resultant raster map
55 multiplier=float
57 Multiplier for ASCII data
58 Default: read from header
59 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 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 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 Optionally the following parameters can be defined in the header sec‐
84 tion:
85 null: nn
86 type: float
87 multiplier: 2.
88 "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 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 The imported cell type can be forced using the type option, default is
107 auto-detection.
108 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 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
144 Available at: r.in.ascii source code (history)
145 Main index | Raster index | Topics index | Keywords index | Graphical
147 index | Full index
148 © 2003-2019 GRASS Development Team, GRASS GIS 7.8.2 Reference Manual
150GRASS 7.8.2 r.in.ascii(1)