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



NNAAMMEE
       rr..iinn..eellaass   - Import an ELAS 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..eellaass
       rr..iinn..eellaass hheellpp
       rr..iinn..eellaass [[--hh]] cchhaannnneell==_v_a_l_u_e zzoonnee==_v_a_l_u_e pprroojj==_v_a_l_u_e  nnbbppee==_v_a_l_u_e  xx--ssppoott--
       ssiizzee==_v_a_l_u_e yy--ssppoott--ssiizzee==_v_a_l_u_e iinnppuutt==_n_a_m_e oouuttppuutt==_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       r.in.elas" imports ELAS raster files to GRASS cell files.

OOPPTTIIOONNSS
   FFllaaggss::
	--hh    Create GRASS histogram file.


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

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

       cchhaannnneell==_v_a_l_u_e
	      ELAS channel number.

	      default: 1

       zzoonnee==_v_a_l_u_e
	      UTM zone number. (1-60)

	      default: 0

       pprroojj==_v_a_l_u_e
	      GRASS "proj" value. (0 for XY and 1 for UTM)

	      default: 1

       nnbbppee==_v_a_l_u_e
	      (number  of  bytes  per  element)  for  ELAS file.  "nbpe" is an
	      OPTIONAL value, only to be inputted to override the ELAS	header
	      value.

	      default: 0

       xx--ssppoott--ssiizzee==_v_a_l_u_e
	      ELAS  X  Spot  size number.  "x-spot-size" is an OPTIONAL value,
	      only to be inputted to override the ELAS header value.

	      default: 0

       yy--ssppoott--ssiizzee==_v_a_l_u_e
	      ELAS Y Spot size number.	"y-spot-size" is  an  OPTIONAL	value,
	      only to be inputted to override the ELAS header value.

	      default: 0

       This program  "r.in.elas"  copies  and  converts  an  ELAS raster  file
       to  a GRASS cell file.  The ELAS raster file must be  a	1  to  4  byte
       integer	per  element  file.  The GRASS file created from the ELAS file
       will be either an unrefer enced XY or a UTM projection.	The ELAS color
       values  will be	transferred to GRASS only if there are color values in
       the ELAS header.  If no color values are transferred  from  ELAS   then
       a   GRASS  color  file will automatically be cre ated.  This color file
       will be a RGB color ramp.  The area to  be  transferred	from  ELAS  to
       GRASS will be determined by the ELAS values "il" (initial  line),  "ll"
       (last   line),  "ie"   (initial	 element),   and  "le"(last  element).
       Multi- channel ELAS raster files may be transferred to GRASS  one chan-
       nel  at	a  time.  Input variables: nbpe, x-spot-size, and  y-spot-size
       are OPTIONAL variables  and  can  only  be inputted  non-interactively,
       since these values will usu ally already be stored in the ELAS  header.
       But   if   these  values  are not in the ELAS header, then the user may
       pro vide those values by entering the  non-interactive  command.   This
       program	 will	produce  a  GRASS  range  file and if the flag "-h" is
       passed to the program then a  histogram	file will  be created as well.
       Using the "-h" flag with larger files is not recommended since creating
       a  histogram  file will increase processing time.   You	can  create  a
       histogram  file	after  this program is finished executing  by  running
       "r.support".   This  program  will  produce   a	 new  "WIND"  (region)
       that will correspond to	the  new  "cellhd"  file that  has  been  cre-
       ated.  If  the  user  should  want  to  save  their   original	"WIND"
       (region)   then	 they	should	run "g.region" prior to executing this
       program.

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

AAUUTTHHOORR
       Bruce Powell, National Park Service

       _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.elas(1)
