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 latitude and longi-
       tude 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 set-
       tings.  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 information:

   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 longitudes).


       For example, to specify the southwest corner: ccoorrnneerr==_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 conversion.
	      Options: airy, australian, bessel, clark66, everest, grs80, hay-
	      ford, 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	ddiimmeenn--
       ssiioonn==_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 converted 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  col-
       umns,  the resolutions 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 produced 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
       present 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 geographic region settings.  The bound-
       aries of this geographic region	should	therefore  be  checked	before
       importing  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)
