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
       channel	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	created.  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)
