i.tape.tm.fast(1)	      Grass User's Manual	     i.tape.tm.fast(1)



NNAAMMEE
       ii..ttaappee..ttmm..ffaasstt	-  An  imagery	function that extracts Thematic Mapper
       (TM) imagery from tape media
       _(_G_R_A_S_S _I_m_a_g_e _P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       ii..ttaappee..ttmm..ffaasstt
       ii..ttaappee..ttmm..ffaasstt hheellpp
       ii..ttaappee..ttmm..ffaasstt hheellpp [--qq] iinnppuutt==_n_a_m_e ggrroouupp==_n_a_m_e  bbaannddss==_v_a_l_u_e[,_v_a_l_u_e,...]
       [rroowwss==_f_i_r_s_t_r_o_w_-_l_a_s_t_r_o_w] [ccoollss==_f_i_r_s_t_c_o_l_-_l_a_s_t_c_o_l] [TTIITTLLEE==_n_a_m_e]

DDEESSCCRRIIPPTTIIOONN
       _i_._t_a_p_e_._t_m_._f_a_s_t  is  a  program that extracts TM imagery from tape media
       with different blocking factors (its value indicates how many rows  are
       combined into one physical record on the tape).


       _i_._t_a_p_e_._t_m_._f_a_s_t  must  be run in a LOCATION_NAME with a (x,y) coordinate
       system (i.e., a coordinate  system  with  projection  0).  For  further
       information  regarding  the  LOCATION_NAME  type,  please  refer to the
       _i_m_a_g_e_r_y manual entry.


       _i_._t_a_p_e_._t_m_._f_a_s_t reads the blocking factor from the header file  as  well
       as  other parameters, such as gains and offsets for each band, map pro-
       jection, sun elevation and azimuth, etc., and writes into history  file
       (depending upon the contents of the header file).

OOPPTTIIOONNSS
       This  program  can be run either non-interactively or interactively. It
       will be run non-interactively if the user specifies the name  of  input
       device,	the  name  of  output  group  file, bands to be extracted, and
       optionally other parameters (see below) on the command line  using  the
       form:


       ii..ttaappee..ttmm..ffaasstt  hheellpp [--qq] iinnppuutt==_n_a_m_e ggrroouupp==_n_a_m_e bbaannddss==_v_a_l_u_e[,_v_a_l_u_e,...]
       [rroowwss==_f_i_r_s_t_r_o_w_-_l_a_s_t_r_o_w] [ccoollss==_f_i_r_s_t_c_o_l_-_l_a_s_t_c_o_l] [TTIITTLLEE==_n_a_m_e]

       where the _i_n_p_u_t should be the device name on which the tape  media  are
       mounted.  The  _g_r_o_u_p is an imagery group which will store the extracted
       TM imagery.  The _b_a_n_d_s value in a list separated by commas is the bands
       the user wants to extract from the imagery. The _r_o_w_s and _c_o_l_s represent
       the region which the user wishes to extract, where the default is whole
       imagery.   At last an optional _T_I_T_L_E is for information only.  Alterna-
       tively, the program will be run interactively if the  user  types  only
       _i_._t_a_p_e_._t_m_._f_a_s_t;	in  this  case	the  program  will prompt the user for
       parameter values using the standard GRASS _p_a_r_s_e_r interface.

   FFllaaggss::
       --qq     Run quietly.  Supresses output of program percent-complete  mes-
	      sages.   If  this  flag  is not used, these messages are printed
	      out.


   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      The name of the device on which the tape	media  containing  the
	      imagery files mounted.

       ggrroouupp==_n_a_m_e
	      The  name  of  the group, which will store the imagery extracted
	      from tape media.

       bbaannddss==_v_a_l_u_e[,_v_a_l_u_e,...]
	      The bands the user wishes to extracted from the tape media.
	      Options: 1-7

       rroowwss==_f_i_r_s_t_r_o_w_-_l_a_s_t_r_o_w
	      The values of first and last row of the extracting region.
	      Default: full imagery

       ccoollss==_f_i_r_s_t_c_o_l_-_l_a_s_t_c_o_l
	      The values of first and last column of the extracting region.
	      Default: full imagery

       TTIITTLLEE==_n_a_m_e
	      The TITLE of the extracting imagery.
	      Default: TM Imagery File Extracted from Tape


NNOOTTEESS
       Running in command line mode, _i_._t_a_p_e_._t_m_._f_a_s_t will overwrite  the  group
       file and support files without prompting if the files existed.

SSEEEE AALLSSOO
       _G_R_A_S_S _T_u_t_o_r_i_a_l_: _I_m_a_g_e _P_r_o_c_e_s_s_i_n_g


       _i_._g_r_o_u_p

       _i_._t_a_p_e_._m_s_s

       _i_._t_a_p_e_._m_s_s_._h

       _i_._t_a_p_e_._o_t_h_e_r

       _i_._t_a_p_e_._t_m

       _i_._t_a_p_e_._s_p_o_t

       _i_m_a_g_e_r_y

       _m_._e_x_a_m_i_n_e_._t_a_p_e

AAUUTTHHOORR
       Tao Wen, University of Illinois at Urbana-Champaign

       _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_3 _$



GRASS 5.0						     i.tape.tm.fast(1)
