r3.in.ascii

[type = default | double | float] [precision = default | max | 0 - 52] [compression = default | rle | lzw | rle+lzw | none] [tiledimension = XxYxZ] [nv = none | double] input = ascii-file output = g3d-map

Imports files in 3d ascii format into G3D.

The command line argument nv specifies which value to converted to NULL-value. If the specified value is none, no conversion is performed. The default is none.

The arguments type, precision, compression, and tiledimension are the standard g3d arguments which allow the user to overwrite the default properties of the new file. Note that the none value for compression only specifies that neither LZW nor RLE is used for compression. It does not turn off the compression all together. G3d does not support non-compressed files.

The format for the 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.