r3.in.ascii - Converts a 3D ASCII raster text file into a (binary) 3D raster map.
Contents
Description
r3.in.ascii allows a user to create a (binary) GRASS 3D raster map layer from a 3D ASCII raster input
file.
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.
Examples
Please refer to the detailed examples in r3.out.ascii.
Keywords
raster3d, import, voxel, conversion, ASCII
Name
r3.in.ascii - Converts a 3D ASCII raster text file into a (binary) 3D raster map.
Notes
The data is automatically imported into the correct internal coordinate system, that is visualized in the
following picture, independently from the specified ordering in the ASCII input file:
ThevolumecoordinatesystemandtilelayoutoftheimportedvoxelmapFormat
The format of the 3D ASCII file:
version: "grass7"
order: "nsbt"or"nstb"or"snbt"or"sntb"
north: floatingpoint
south: floatingpoint
east: floatingpoint
west: floatingpoint
top: floatingpoint
bottom: floatingpoint
rows: integer
cols: integer
levels: integer
The version and order option have been introduced in GRASS 7 in June 2011. The version option is self
explaining. The order option specifies the row and depth order of the data in the input file. The
supported row/depth ordering is documented in the r3.out.ascii manual page. The order of the data in the
input file does not specify the data order in the generated output 3D raster map which is in any case
north->south,west->east,bottom->top order. So dependent on the order information the data is
automatically imported into the correct internal coordinate system.
The version and order options are not mandatory. In case no version and order option is specified, the
default GRASS 6 ASCII format is assumed.
This header is followed by the cell values in floatingpoint 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.
See Also
r.in.ascii,r3.out.ascii,v.to.rast3,g.region
Source Code
Available at: r3.in.ascii source code (history)
Accessed: Friday Apr 04 01:20:04 2025
Main index | 3D raster index | Topics index | Keywords index | Graphical index | Full index
© 2003-2025 GRASS Development Team, GRASS GIS 8.4.1 Reference Manual
GRASS 8.4.1 r3.in.ascii(1grass)
Synopsis
r3.in.asciir3.in.ascii--helpr3.in.asciiinput=nameoutput=name [null_value=string] [type=string] [precision=string]
[compression=string] [tiledimension=XxYxZ] [--overwrite] [--help] [--verbose] [--quiet] [--ui]
Flags:--overwrite
Allow output files to overwrite existing files
--help
Print usage summary
--verbose
Verbose module output
--quiet
Quiet module output
--ui
Force launching GUI dialog
Parameters:input=name[required]
Name of input file to be imported
’-’ for standard input
output=name[required]
Name for output 3D raster map
null_value=string
String representing NULL value data cell (use ’none’ if no such value)
Default: *type=string
Data type used in the output raster3d map
Options: default,double,float
Default: defaultprecision=string
Number of digits used as mantissa in the internal map storage, 0 -23 for float, 0 - 52 for double,
max or default
Default: defaultcompression=string
The compression method used in the output raster3d map
Options: default,zip,none
Default: defaulttiledimension=XxYxZ
The dimensions of the tiles used in the output raster3d map (XxYxZ or default: 16x16x8)
Default: default