r.in.bin(1)	       Grass User's Manual	      r.in.bin(1)



NNAAMMEE
       rr..iinn..bbiinn   -  Import  a	binary	raster	file into a GRASS
       raster map layer.
       _(_G_R_A_S_S _R_a_s_t_e_r _D_a_t_a _I_m_p_o_r_t _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       rr..iinn..bbiinn
       rr..iinn..bbiinn hheellpp
       rr..iinn..bbiinn  [[--ss]]  [[--ff]]  [[--bb]]  [[--hh]]  iinnppuutt==_n_a_m_e   oouuttppuutt==_n_a_m_e
       bbyytteess==_v_a_l_u_e [ttiittllee=="_p_h_r_a_s_e"] [nnoorrtthh==_v_a_l_u_e ] [ssoouutthh==_v_a_l_u_e ]
       [eeaasstt==_v_a_l_u_e  ]  [wweesstt==_v_a_l_u_e   ]	 [rr==_v_a_l_u_e]   [cc==_v_a_l_u_e	]
       [aannuullll==_v_a_l_u_e]

DDEESSCCRRIIPPTTIIOONN
       _r_._i_n_._b_i_n  allows  a user to create a (binary) GRASS raster
       map layer from a variety of binary raster data formats.

OOPPTTIIOONNSS
   FFllaaggss::
	--ss    Signed one byte data (range -128 - 127).	Interpret
	      high bit (> 127) as a negative value.

	--ff    Import  the  data  to a Float type GRASS raster map
	      layer (default is Integer)

	--bb    Byte swap  the  binary  data  during  import.  This
	      includes the header if -h specified.

	--hh    Read  region  information  from  a  Generic Mapping
	      Tools (GMT) type binary header.  Is compatible with
	      GMT binary grid types 1 and 2.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name  of	an  existing  binary  raster  file  to be
	      imported.

       oouuttppuutt==_n_a_m_e
	      Name to be assigned to resultant GRASS  raster  map
	      layer.

       bbyytteess==_v_a_l_u_e
	      Number of bytes per cell (1, 2, 4)

       ttiittllee== Title to be assigned to resultant raster map layer.

       nnoorrtthh==_v_a_l_u_e
	      Northern limit of geographic region

       ssoouutthh==_v_a_l_u_e
	      Southern limit of geographic region

       eeaasstt==_v_a_l_u_e
	      Eastern limit of geographic region

       wweesstt==_v_a_l_u_e
	      Western limit of geographic region

       rr==_v_a_l_u_e
	      Number of rows

       cc==_v_a_l_u_e
	      Number of columns

       aannuullll==_v_a_l_u_e
	      Set Value to NULL

       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 dimen-
       sions  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_._i_n_._b_i_n  can  be  used	to  import numerous binary arrays
       including: etopo30, etopo-5, Globe DEM, BIL, AVHRR and GMT
       binary arrays (ID 1 & 2)



EEXXAAMMPPLLEE
       The  following  is  a  sample  call  of _r_._i_n_._b_i_n 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_._i_n_._b_i_n 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_._i_n_._b_i_n to import an
       AVHRR image:


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

NNOOTTEESS
       If optional parameters are not supplied, rr..iinn..bbiinn attempts
       to  calculate  them.  For  example if the rows and columns
       parameters are not entered, rr..iinn..bbiinn automatically  calcu-
       lates  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,  rr..iinn..bbiinn  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 geo-
       graphic region and _n_o_t 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 bbyytteess== 1. If bbyytteess== is greater
       than 1 the flag is ignored.

SSEEEE AALLSSOO
       _r_._o_u_t_._b_i_n_, _r_._i_n_._a_s_c_i_i_, _r_._o_u_t_._a_s_c_i_i_,  _r_._i_n_._a_r_c_,  _r_._o_u_t_._a_r_c_,
       _r_._i_n_._g_d_a_l

AAUUTTHHOORRSS
       Jacques Bouchard, France (bouchard@onera.fr)

       Bob Covill, Canada (bcovill@tekmap.ns.ca)

       Man page: Zsolt Felker (felker@c160.pki.matav.hu)

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_3_/_0_1 _0_0_:_0_8_:_3_1 _$



GRASS 5.0					      r.in.bin(1)
