~ubuntu-branches/ubuntu/wily/grass/wily

« back to all changes in this revision

Viewing changes to raster/r.in.ascii/description.html

Tags: 7.0.0~rc1+ds1-1~exp1
* New upstream release candidate.
* Repack upstream tarball, remove precompiled Python objects.
* Add upstream metadata.
* Update gbp.conf and Vcs-Git URL to use the experimental branch.
* Update watch file for GRASS 7.0.
* Drop build dependencies for Tcl/Tk, add build dependencies:
  python-numpy, libnetcdf-dev, netcdf-bin, libblas-dev, liblapack-dev
* Update Vcs-Browser URL to use cgit instead of gitweb.
* Update paths to use grass70.
* Add configure options: --with-netcdf, --with-blas, --with-lapack,
  remove --with-tcltk-includes.
* Update patches for GRASS 7.
* Update copyright file, changes:
  - Update copyright years
  - Group files by license
  - Remove unused license sections
* Add patches for various typos.
* Fix desktop file with patch instead of d/rules.
* Use minimal dh rules.
* Bump Standards-Version to 3.9.6, no changes.
* Use dpkg-maintscript-helper to replace directories with symlinks.
  (closes: #776349)
* Update my email to use @debian.org address.

Show diffs side-by-side

added added

removed removed

Lines of Context:
1
 
<h2>DESCRIPTION</h2>
2
 
 
3
 
<em>r.in.ascii</em> allows a user to create a (binary) GRASS raster map
4
 
layer from an ASCII raster input file with (optional) TITLE.
5
 
 
6
 
<p>
7
 
 
8
 
The GRASS ASCII <b>input</b> file has a header section which describes
9
 
the location and size of the data, followed by the data itself.
10
 
 
11
 
<p>
12
 
 
13
 
The header has 6 lines: 
14
 
 
15
 
<div class="code"><pre>
16
 
north:   xxxxxx.xx
17
 
south:   xxxxxx.xx
18
 
east:    xxxxxx.xx
19
 
west:    xxxxxx.xx
20
 
rows:    r 
21
 
cols:    c 
22
 
</pre></div>
23
 
 
24
 
The north, south, east, and west field values entered 
25
 
are the coordinates of the edges of the geographic region. 
26
 
The rows and cols field values entered describe the dimensions 
27
 
of the matrix of data to follow. 
28
 
The data which follows is <em>r</em> rows of <em>c</em> integers. 
29
 
 
30
 
<p>
31
 
 
32
 
Optionally the following parameters can be defined in the header section:
33
 
 
34
 
<div class="code"><pre>
35
 
null: nn
36
 
type: float
37
 
multiplier: 2.
38
 
</pre></div>
39
 
 
40
 
<p>
41
 
 
42
 
"null" defines a string or number to be converted to NULL value (no
43
 
data).<br>
44
 
"type" defines the data type (int, float double) and is not required.<br>
45
 
"multiplier" is an optional parameter to multiply each cell value.
46
 
 
47
 
<h2>NOTES</h2>
48
 
 
49
 
The geographic coordinates north, south, east, and west
50
 
describe the outer edges of the geographic region.  They
51
 
run along the edges of the cells at the edge of the
52
 
geographic region and <em>not</em> through the center of the cells
53
 
at the edges.
54
 
The NW value occurs at the beginning of the first line of data, and the
55
 
SW value occurs at the beginning of the last line of data.
56
 
 
57
 
<p>
58
 
 
59
 
The data (which follows the header section) must contain
60
 
<tt>r</tt> <em>x</em> <tt>c</tt> values, but it is not necessary 
61
 
that all the data for a row be on one line. A row may be 
62
 
split over many lines. 
63
 
 
64
 
<p>
65
 
 
66
 
<em>r.in.ascii</em> may import <i>integer</i>, <i>floating point</i>, or <i>double</i> cell 
67
 
types using the <b>-i</b>, <b>-f</b>, and <b>-d</b> flags, respectively. 
68
 
 
69
 
<p>
70
 
 
71
 
The header information in ESRI Raster ASCII files differs from GRASS.  
72
 
To convert an Arc/Info (ArcView) ASCII grid file into GRASS, see 
73
 
<em><a href="r.in.arc.html">r.in.arc</a></em>.
74
 
 
75
 
<p>
76
 
 
77
 
SURFER (Golden Software) ASCII files may be imported by passing the <b>-s</b> flag.
78
 
 
79
 
<h2>EXAMPLE</h2>
80
 
 
81
 
The following is a sample <b>input</b> file to <em>r.in.ascii</em>: 
82
 
 
83
 
<div class="code"><pre>
84
 
north:                   4299000.00
85
 
south:                   4247000.00
86
 
east:                     528000.00
87
 
west:                     500000.00
88
 
rows:                         10   
89
 
cols:                         15   
90
 
null:                      -9999   
91
 
 
92
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
93
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
94
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
95
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
96
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
97
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
98
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
99
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
100
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
101
 
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15
102
 
</pre></div>
103
 
 
104
 
<h2>SEE ALSO</h2>
105
 
 
106
 
<em>
107
 
<a href="r.out.ascii.html">r.out.ascii</a>,
108
 
<a href="r.in.arc.html">r.in.arc</a>, 
109
 
<a href="r.in.gdal.html">r.in.gdal</a>, 
110
 
<a href="r.out.arc.html">r.out.arc</a>,
111
 
<a href="r.in.bin.html">r.in.bin</a>,
112
 
<a href="r3.in.ascii.html">r3.in.ascii</a></em>,
113
 
<a href="http://grass.osgeo.org/gdp/html_grass5/ascii_formats.html">GRASS ASCII formats</a>
114
 
</em>
115
 
 
116
 
<h2>AUTHOR</h2>
117
 
 
118
 
Michael Shapiro, U.S. Army Construction Engineering Research Laboratory<br>
119
 
Surfer support by Roger Miller
120
 
 
121
 
<p>
122
 
<i>Last changed: $Date: 2009-02-04 02:43:30 +0100 (Wed, 04 Feb 2009) $</i>