/usr/share/doc/grass-doc/html/r3.in.ascii.html is in grass-doc 6.4.3-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 | <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN">
<html>
<head>
<title>GRASS GIS manual: r3.in.ascii</title>
<meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1">
<link rel="stylesheet" href="grassdocs.css" type="text/css">
</head>
<body bgcolor="white">
<img src="grass_logo.png" alt="GRASS logo"><hr align=center size=6 noshade>
<h2>NAME</h2>
<em><b>r3.in.ascii</b></em> - Converts a 3D ASCII raster text file into a (binary) 3D raster map layer.
<h2>KEYWORDS</h2>
raster3d, voxel, import
<h2>SYNOPSIS</h2>
<b>r3.in.ascii</b><br>
<b>r3.in.ascii help</b><br>
<b>r3.in.ascii</b> <b>input</b>=<em>name</em> <b>output</b>=<em>name</em> [<b>nv</b>=<em>string</em>] [<b>type</b>=<em>string</em>] [<b>precision</b>=<em>string</em>] [<b>compression</b>=<em>string</em>] [<b>tiledimension</b>=<em>XxYxZ</em>] [--<b>overwrite</b>] [--<b>verbose</b>] [--<b>quiet</b>]
<h3>Flags:</h3>
<DL>
<DT><b>--overwrite</b></DT>
<DD>Allow output files to overwrite existing files</DD>
<DT><b>--verbose</b></DT>
<DD>Verbose module output</DD>
<DT><b>--quiet</b></DT>
<DD>Quiet module output</DD>
</DL>
<h3>Parameters:</h3>
<DL>
<DT><b>input</b>=<em>name</em></DT>
<DD>ASCII raster map to be imported</DD>
<DT><b>output</b>=<em>name</em></DT>
<DD>Name for output raster3d map</DD>
<DT><b>nv</b>=<em>string</em></DT>
<DD>String representing NULL value data cell (use 'none' if no such value)</DD>
<DD>Default: <em>*</em></DD>
<DT><b>type</b>=<em>string</em></DT>
<DD>Data type used in the output file</DD>
<DD>Options: <em>default,double,float</em></DD>
<DD>Default: <em>default</em></DD>
<DT><b>precision</b>=<em>string</em></DT>
<DD>Precision used in the output file (default, max, or 0 to 52)</DD>
<DD>Default: <em>default</em></DD>
<DT><b>compression</b>=<em>string</em></DT>
<DD>The compression method used in the output file</DD>
<DD>Options: <em>default,rle,none</em></DD>
<DD>Default: <em>default</em></DD>
<DT><b>tiledimension</b>=<em>XxYxZ</em></DT>
<DD>The dimensions of the tiles used in the output file</DD>
<DD>Default: <em>default</em></DD>
</DL>
<h2>DESCRIPTION</h2>
<em>r3.in.ascii</em> allows a user to create a (binary) GRASS 3D raster map
layer from a 3D ASCII raster input file with (optional) TITLE.
<p>
Note that for compression the <em>none</em> option only specifies
that neither LZW nor RLE is used for compression. It
does not turn off the compression all together. 3D raster maps do
not support non-compressed files.
<p>
The <em>tiledimension</em> parameter defines the dimension of the tiles
used in the output file. The format is: XxYxZ
<p>
The <em>nv</em> parameter specifies which value to convert to NULL-value.
If the specified value is <em>none</em>, no conversion is performed.
Default is <em>none</em>.
<h2>NOTES</h2>
The format of the 3D ASCII file:
<div class="code"><pre>
north: <em>floating point</em>
south: <em>floating point</em>
east: <em>floating point</em>
west: <em>floating point</em>
top: <em>floating point</em>
bottom: <em>floating point</em>
rows: <em>integer</em>
cols: <em>integer</em>
levels: <em>integer</em>
</pre></div>
This header is followed by the cell values in <em>floating point</em> format
organized in rows with constant <em>col</em> and <em>level</em> coordinate.
The rows are organized by constant <em>level</em> coordinate. Individual cell
values are separated by <em>space</em> or <em>CR</em>.
<p>
NOTE: Currently, after the file has been imported, the stored values are
compared with the original data. This feature is used to find bugs in the
library at an early stage and will be turned off as soon as confidence has
built up.
<h2>EXAMPLES</h2>
4x3x2 sample. Note, that lower-left (SW) corner of the bottom level comes first.
This array format, where EW is preserved but NS is flipped, is sometimes
known as "ij" coordinates.
This is opposite to <em>r.in.ascii</em>'s format, which places the SW corner
at the beginning of the last row of data.
<div class="code"><pre>
north: 3.0
south: 0.0
east: 4.0
west: 0.0
top: 2.0
bottom: 0.0
rows: 3
cols: 4
levels: 2
w(x1,y1,z1) w(x2,y1,z1) w(x3,y1,z1) w(x4,y1,z1)
w(x1,y2,z1) w(x2,y2,z1) w(x3,y2,z1) w(x4,y2,z1)
w(x1,y3,z1) w(x2,y3,z1) w(x3,y3,z1) w(x4,y3,z1)
w(x1,y1,z2) w(x2,y1,z2) w(x3,y1,z2) w(x4,y1,z2)
w(x1,y2,z2) w(x2,y2,z2) w(x3,y2,z2) w(x4,y2,z2)
w(x1,y3,z2) w(x2,y3,z2) w(x3,y3,z2) w(x4,y3,z2)
</pre></div>
<p>
Sample ASCII voxel map with one layer and several rows and columns (Spearfish area):
<div class="code"><pre>
north: 4925010.000000
south: 4924890.000000
east: 596760.000000
west: 596610.000000
top: 1.000000
bottom: 0.000000
rows: 4
cols: 5
levels: 1
1204.74 1204.48 1204.19 1203.81 1203.39
1203.89 1203.67 1203.34 1202.98 1202.43
1203.05 1202.80 1202.51 1202.11 1201.48
1202.10 1201.92 1201.62 1201.27 1200.68
</pre></div>
<h2>AUTHORS</h2>
Roman Waupotitsch, Michael Shapiro,
Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka
<h2>SEE ALSO</h2>
<em>
<a href="r.in.ascii.html">r.in.ascii</a>,
<a href="r3.out.ascii.html">r3.out.ascii</a>,
<a href="v.to.rast3.html">v.to.rast3</a>
</em>
<p>
<i>Last changed: $Date: 2012-11-15 04:53:59 -0800 (Thu, 15 Nov 2012) $</i>
<HR>
<P><a href="index.html">Main index</a> - <a href="raster3D.html">raster3D index</a> - <a href="full_index.html">Full index</a></P>
<P>© 2003-2013 <a href="http://grass.osgeo.org">GRASS Development Team</a></p>
</body>
</html>
|