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


   PPaarraammeetteerrss::
       iinnppuutt  HDF file to be converted.

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

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

       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 man-
       ually change the new raster's cellhd file.


       NCSA HDF is a multi-object file format developed by The National Center
       for Supercomputing Applications at Champaign, Illinois for the transfer
       of graphical and floating-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  basi-
       cally  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  output-
       name01,	outputname02,  outputname03.... If the _-_a option is not speci-
       fied and the HDF file contains more than one data set, only  the  first
       data set is extracted unless the user specifies specific reference num-
       bers 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
       creating  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 contains 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 visualiza-
       tion applications which use the HDF format.  Some  commercial  applica-
       tions  also  support HDF.  For more information, 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)
