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



NNAAMMEE
       rr..iinn..hhddff  -  Convert  data  in  HDF format into a (binary)
       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_)

GGRRAASSSS VVEERRSSIIOONN
       4.x

SSYYNNOOPPSSIISS
       rr..iinn..hhddff

       rr..iinn..hhddff hheellpp

       rr..iinn..hhddff  [--qqaall]  iinnppuutt==_n_a_m_e  [oouuttppuutt==_n_a_m_e]   [mmuulltt==_v_a_l_u_e]
       [ddsseettss==_v_a_l_u_e_[_,_v_a_l_u_e_,_._._._]]

DDEESSCCRRIIPPTTIIOONN
       _r_._i_n_._h_d_f  allows a user to create a GRASS raster map layer
       from a file in NCSA Hierarchical Data Format (HDF).

OOPPTTIIOONNSS
   FFllaaggss::
       --qq     Run quietly.

       --aa     Convert ALL data sets in the HDF file.

       --ll     Only list the contents of the HDF file (no  conver-
	      sion).


   PPaarraammeetteerrss::
       iinnppuutt  HDF file to be converted.

       oouuttppuutt Name of new raster file.	Default: hdf.rast

       mmuulltt   Floating	   point    multiplier.    (rastfile	=
	      (int)(file.hdf * multiplier))

       ddsseettss  A list of reference  numbers  for  datasets  to  be
	      extracted.

       The  raster file created will have its southwest origin at
       0 East and 0 North, with resolution of 1.  To view the new
       GRASS  raster  file,  use  _g_._r_e_g_i_o_n _r_a_s_t_=_n_e_w_f_i_l_e, then use
       _d_._r_a_s_t as normal.  You may wish to manually change the new
       raster's cellhd file.


       NCSA  HDF  is  a multi-object file format developed by The
       National Center for Supercomputing Applications	at  Cham-
       paign,  Illinois  for the transfer of graphical and float-
       ing-point data between machines.   NASA	Pathfinder  AVHRR
       data is stored in HDF format.  The HDF format defines both
       a raster type and a SDS (scientific data set)  type.   The
       later  is  basically a highly structured multi-dimensional
       array of values.  A single HDF file may contain more  than
       one  SDS  or  raster; using the _-_a option will extract all
       data sets from the HDF file,  creating  a  separate  GRASS
       raster file from each data set and naming the raster files
       outputname01, outputname02,  outputname03....  If  the  _-_a
       option  is  not	specified  and the HDF file contains more
       than one data set, only the first data  set  is	extracted
       unless  the  user specifies specific reference numbers for
       desired data sets in the file using the dsets option.   To
       see  a  list  of reference numbers for data sets in an HDF
       file, use the _-_l flag.  If the HDF file contains labels or
       descriptions  of  the data, these will be shown when using
       the _-_l flag. Labels and descriptions  from  the	HDF  file
       will also be written to the GRASS history file when creat-
       ing the raster map.  If a multiplier is	given  using  the
       mult option, every file created will be the product of the
       input data set and the multiplier.  If the HDF  file  con-
       tains an SDS, it must be only two dimensional in order for
       _r_._i_n_._h_d_f to accept it as input.	If the HDF file  contains
       an  8-bit raster image with an associated palette, a GRASS
       color file will be created.  This program will not  import
       24-bit HDF raster images.


       NCSA distributes the HDF library and several public domain
       visualization applications which use the HDF format.  Some
       commercial applications also support HDF.  For more infor-
       mation,	 use	the    NCSA    anonymous    ftp    server
       ftp.ncsa.uiuc.edu or contact:


       NCSA

       152 Computing Applications Building

       605 E. Springfield Ave.

       Champaign, IL 61820

       (217) 244-0072

BBUUGGSS
       If  a data set contains long labels and descriptions, some
       of it may be truncated when writing to the  GRASS  history
       file.  The  GRASS  history  structure  currently allows 50
       lines of 80 characters each.   But  when  editing  history
       using  r.support,  only	20  lines of 65 characters may be
       used.

SSEEEE AALLSSOO
       _g_._r_e_g_i_o_n

AAUUTTHHOORR
       Bill Brown, 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.hdf(1)
