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



NNAAMMEE
       rr..iinn..llll	 - Converts raster data referenced using latitude
       and longitude coordinates to a UTM-referenced map layer in
       GRASS raster format.
       _(_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..llll
       rr..iinn..llll hheellpp
       rr..iinn..llll	[--ss] iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e bbppcc==_v_a_l_u_e ccoorrnneerr==_c_o_r_-
       _n_e_r_,_l_a_t_,_l_o_n     ddiimmeennssiioonn==_r_o_w_s_,_c_o_l_s	rreess==_l_a_t_r_e_s_,_l_o_n_r_e_s
       sspphheerrooiidd==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       This  program  converts raster data referenced using lati-
       tude and longitude coordinates  to  a  UTM-referenced  map
       layer  in  GRASS raster format.	_r_._i_n_._l_l is primarily used
       as the final program in converting DTED	and  DEM  digital
       elevation  data to GRASS raster format, but is not limited
       to this use.  _r_._i_n_._l_l uses the user's  current  geographic
       region  settings.  Only data that falls within the current
       geographic region will appear  in  the  final  raster  map
       layer.

OOPPTTIIOONNSS
       _r_._i_n_._l_l	requires the user to enter the following informa-
       tion:

   FFllaaggss::
       --ss     Signed data (high bit means negative value).


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      Name of an existing input raster map layer.

       oouuttppuutt==_n_a_m_e
	      Name to be assigned to the output raster map layer.

       bbppcc==_v_a_l_u_e
	      Number of bytes per cell.

       ccoorrnneerr==_c_o_r_n_e_r_,_l_a_t_,_l_o_n
	      One corner latitude and longitude of the input.
	      Format: {nw|ne|sw|se},dd:mm:ss{N|S},ddd:mm:ss{E|W}


       The  latitude  and  longitude  are  specified as dddd..mmmm..ssssHH
       where dd is degrees, mm is minutes, ss is seconds,  and	H
       is the hemisphere (NN or SS for latitudes, EE or WW for longi-
       tudes).


       For  example,  to  specify  the	southwest  corner:   ccoorr--
       nneerr==_s_w_,_4_6_N_,_1_2_0_W


       Note:  the  latitude  and  longitude specified are for the
       center of the corner cell.

       ddiimmeennssiioonn==_r_o_w_s_,_c_o_l_s
	      Number of rows and columns in the input file.

       rreess==_l_a_t_r_e_s_,_l_o_n_r_e_s
	      Resolution of the input (in arc seconds).

       sspphheerrooiidd==_n_a_m_e
	      Name of spheroid to be used for coordinate  conver-
	      sion.
	      Options:	airy,  australian, bessel, clark66, ever-
	      est,  grs80,  hayford,  international,   krasovsky,
	      wgs66, wgs72, wgs84


EEXXAAMMPPLLEE
       The  command line: rr..iinn..llll iinnppuutt==_r_o_t_._o_u_t oouuttppuutt==_i_m_p_o_r_t_._o_u_t
       ddiimmeennssiioonn==_3_5_8_,_3_0_1 bbppcc==_2	rreess==_3_,_3  ccoorrnneerr==_s_w_,_3_7_:_1_3_N_,_1_0_3_:_4_5_W
       sspphheerrooiidd==_w_g_s_7_2

       reads  data  from the file _r_o_t_._o_u_t, converts the data, and
       stores them in the file _i_m_p_o_r_t_._o_u_t. The data  to  be  con-
       verted are made up of 358 rows and 301 columns, and have a
       resolution of 3x3 arc seconds.

NNOOTTEESS
       In the conversion of DTED and DEM elevation data to raster
       map  layer  format,  _r_._i_n_._l_l follows execution of the data
       rotation program _m_._r_o_t_9_0.   Because  the  user  can  glean
       information on the number of rows and columns, the resolu-
       tions of the latitude and longitude,  and  the  number  of
       bytes per column from the header file produced by the tape
       extraction programs _m_._d_t_e_d_._e_x_t_r_a_c_t and _m_._d_m_a_U_S_G_S_r_e_a_d,  the
       user should recall that _m_._r_o_t_9_0 has rotated the files pro-
       duced by the tape extraction  programs  90  degrees;  this
       means that the user should INTERCHANGE the numbers of rows
       and columns present  in	the  header  file  for	input  to
       _r_._i_n_._l_l.   The  number  of  rows shown in the tape extract
       header file now	become	the  number  of  columns  in  the
       _m_._r_o_t_9_0	output	file;  the number of columns shown in the
       tape extract header file are now the number of  rows  pre-
       sent in the _m_._r_o_t_9_0 output file.


       The  user  should  also	note  that  the  raster map layer
       imported into GRASS will be  based  on  the  current  geo-
       graphic	region	settings.   The  boundaries  of this geo-
       graphic region should therefore be checked before  import-
       ing  the raster map layer.  Data outside of the geographic
       region will not be  imported  and  missing  data  will  be
       assigned the category value "no data".

SSEEEE AALLSSOO
       _m_._d_m_a_U_S_G_S_r_e_a_d,  _m_._d_t_e_d_._e_x_a_m_i_n_e,	_m_._d_t_e_d_._e_x_t_r_a_c_t,  _m_._r_o_t_9_0,
       _r_._i_n_._a_s_c_i_i, _r_._i_n_._b_i_n

AAUUTTHHOORR
       Michael	Shapiro,  U.S.	Army   Construction   Engineering
       Research Laboratory

       _L_a_s_t _c_h_a_n_g_e_d_: _$_D_a_t_e_: _2_0_0_2_/_0_1_/_2_5 _0_5_:_4_5_:_3_4 _$



GRASS 5.0					       r.in.ll(1)
