NAME¶

r3.in.ascii - Converts a 3D ASCII raster text file into a (binary) 3D raster map layer.

KEYWORDS¶

raster3d, voxel, import

SYNOPSIS¶

r3.in.ascii r3.in.ascii help r3.in.ascii input=name output=name [nv=string] [ type=string] [precision=string] [ compression=string] [tiledimension= XxYxZ] [--overwrite] [--verbose] [-- quiet]

Flags:¶

--overwrite

 

Allow output files to overwrite existing files

--verbose

 

Verbose module output

--quiet

 

Quiet module output

Parameters:¶

input=name

 

ASCII raster map to be imported

output=name

 

Name for output raster3d map

nv=string

 

String representing NULL value data cell (use 'none' if no such value)

 

Default: *

type=string

 

Data type used in the output file

 

Options: default,double,float

 

Default: default

precision=string

 

Precision used in the output file (default, max, or 0 to 52)

 

Default: default

compression=string

 

The compression method used in the output file

 

Options: default,rle,none

 

Default: default

tiledimension=XxYxZ

 

The dimensions of the tiles used in the output file

 

Default: default

DESCRIPTION¶

r3.in.ascii allows a user to create a (binary) GRASS 3D raster map layer from a 3D ASCII raster input file with (optional) TITLE. Note that for compression the none 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. The tiledimension parameter defines the dimension of the tiles used in the output file. The format is: XxYxZ The nv parameter specifies which value to convert to NULL-value. If the specified value is none, no conversion is performed. Default is none.

NOTES¶

The format of the 3D ASCII file: north: floating point south: floating point east: floating point west: floating point top: floating point bottom: floating point rows: integer cols: integer levels: integer This header is followed by the cell values in floating point format organized in rows with constant col and level coordinate. The rows are organized by constant level coordinate. Individual cell values are separated by space or CR. 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.

EXAMPLES¶

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 r.in.ascii's format, which places the SW corner at the beginning of the last row of data. 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) Sample ASCII voxel map with one layer and several rows and columns (Spearfish area): 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

AUTHORS¶

Roman Waupotitsch, Michael Shapiro, Helena Mitasova, Bill Brown, Lubos Mitas, Jaro Hofierka

SEE ALSO¶

r.in.ascii, r3.out.ascii, v.to.rast3 Last changed: $Date: 2012-11-15 13:53:59 +0100 (Thu, 15 Nov 2012) $ Full index © 2003-2014 GRASS Development Team