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  coordi-
       nates  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	incor-
       rectly 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 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, 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 geographic 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)
