NAME

r.in.bin - Import a binary raster file into a GRASS raster map layer.

SYNOPSIS

r.in.bin
r.in.bin help
r.in.bin [-sfbh] input=string output=string [title=string] [bytes=integer] [north=float] [south=float] [east=float] [west=float] [rows=float] [cols=float] [anull=float]

Flags:

-s
Signed data (high bit means negative value)
-f
Import as Floating Point Data (default: Integer)
-b
Byte Swap the Data During Import
-h
Get region info from GMT style header

Parameters:

input=string
Bin raster file to be imported
output=string
Name for resultant raster map
title=string
Title for resultant raster map
bytes=integer
Number of bytes per cell (1, 2, 4)
Default: 1
north=float
Northern limit of geographic region
south=float
Southern limit of geographic region
east=float
Eastern limit of geographic region
west=float
Western limit of geographic region
rows=float
Number of rows
cols=float
Number of columns
anull=float
Set Value to NULL

DESCRIPTION

r.in.bin allows a user to create a (binary) GRASS raster map layer from a variety of binary raster data formats.

The -s flag is used for importing signed one byte data (range -128 - 127). High bit (> 127) values are interpreted as negative values.

The -h flag is used to read region information from a Generic Mapping Tools (GMT) type binary header. It is compatible with GMT binary grid types 1 and 2.

The north, south, east, and west field values entered are the coordinates of the edges of the geographic region. The rows and cols field values entered describe the dimensions of the matrix of data to follow. If input is a GMT binary array (-h flag), the six dimension fields are obtained from the GMT header. If the bytes field is entered incorrectly an error will be generated suggesting a closer bytes value.

r.in.bin can be used to import numerous binary arrays including: etopo30, etopo-5, Globe DEM, BIL, AVHRR and GMT binary arrays (ID 1 & 2)

EXAMPLE

The following is a sample call of r.in.bin to import GTOPO30 DEM data:

r.in.bin -s input=E020N90.DEM output=gtopo30 bytes=2 north=90 south=40 east=60 west=20 r=6000 c=4800

(you can add "anull=-9999" if you want sea level to have a NULL value)

The following is a sample call of r.in.bin to import a GMT type 1 (float) binary array:

r.in.bin -hf input=sample.grd output=sample.grass

(-b could be used to swap bytes if required)

The following is a sample call of r.in.bin to import an AVHRR image:

r.in.bin in=p07_b6.dat out=avhrr c=128 r=128

NOTES

If optional parameters are not supplied, r.in.bin attempts to calculate them. For example if the rows and columns parameters are not entered, r.in.bin automatically calculates them by subtracting south from north and west from east. This will only produce correct results if the raster resolution equals 1. Also, if the north, south, east, and west parameters are not entered, r.in.bin assigns them from the rows and columns parameters. In the above AVHRR example, the raster would be assigned a north=128, south=0, east=128, west=0.

The geographic coordinates north, south, east, and west describe the outer edges of the geographic region. They run along the edges of the cells at the edge of the geographic region and not through the center of the cells at the edges.

Notes on (non)signed data:

If you use the -s flag the highest bit is the sign bit. If this is 1 the data is negative, and the data interval is half of the unsigned (not exactly).

This flag is only used if bytes= 1. If bytes= is greater than 1 the flag is ignored.

SEE ALSO

r.out.bin, r.in.ascii, r.out.ascii, r.in.arc, r.out.arc, r.in.gdal

AUTHORS

Jacques Bouchard, France (bouchard@onera.fr)
Bob Covill, Canada (bcovill@tekmap.ns.ca)
Man page: Zsolt Felker (felker@c160.pki.matav.hu)

Last changed: $Date: 2003/05/06 13:31:17 $


Help Index