m.dted.extract(1)	      Grass User's Manual	     m.dted.extract(1)



NNAAMMEE
       mm..ddtteedd..eexxttrraacctt	- Extracts digital terrain elevation data (DTED - lev-
       els 1 and 2) produced and supplied by the Defense Mapping Agency  (DMA)
       on 1/2-inch magnetic tapes.
       _(_G_R_A_S_S _D_a_t_a _I_m_p_o_r_t_/_P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       mm..ddtteedd..eexxttrraacctt iiff==_n_a_m_e ooff==_n_a_m_e hhff==_n_a_m_e nn=="_s_t_r_i_n_g" ss=="_s_t_r_i_n_g" ee=="_s_t_r_i_n_g"
       ww=="_s_t_r_i_n_g"

DDEESSCCRRIIPPTTIIOONN
       _m_._d_t_e_d_._e_x_t_r_a_c_t extracts DTED (Levels 1 and 2) digital terrain elevation
       data  produced  by  the Defense Mapping Agency (DMA) from 1/2-inch mag-
       netic tapes obtained from DMA.

OOPPTTIIOONNSS
       Data is read from the input file (iiff).  If the user  does  not  specify
       any input file name on the command line, the program assumes that input
       is coming from /dev/rmt0.  The extracted data is placed in  the	output
       file  (ooff).   This  program should be used in conjunction with the pro-
       grams _m_._r_o_t_9_0 and _r_._i_n_._l_l to convert DTED data to GRASS raster  format.

   PPaarraammeetteerrss::
       iinnppuutt=_n_a_m_e
	      The  pathname  of the tape device where the raw DTED data exists
	      (default is /dev/rmt0)

       oouuttppuutt=_n_a_m_e
	      The full pathname of the output file into  which	the  extracted
	      tape data is to be copied

       hheeaaddeerr=_n_a_m_e
	      The  full  pathname of a file to contain descriptive information
	      about the extracted data;  should be placed in the  same	direc-
	      tory as the output file

       nnoorrtthh= North  latitude  value defining the boundaries of the extraction
	      geographic region (format: _d_d_._m_m_._s_s_[_n_|_s_])

       ssoouutthh= South latitude value defining the extraction  geographic	region
	      (format: _d_d_._m_m_._s_s_[_n_|_s_])

       eeaasstt=  East  longitude  value defining the extraction geographic region
	      (format: _d_d_._m_m_._s_s_[_e_|_w_])

       wweesstt=  West longitude value defining the extraction  geographic	region
	      (format: _d_d_._m_m_._s_s_[_e_|_w_])

       The  nnoorrtthh,  ssoouutthh, eeaasstt and wweesstt parameters define a geographic region
       that should completely encompass the data set.	_d_d_._m_m_._s_s  are  degree,
       minute,	and  second  values.  Only data that falls within this defined
       geographic region will be extracted from the tape.

EEXXAAMMPPLLEE
       The   command   line:	mm..ddtteedd..eexxttrraacctt	  iinn==_/_d_e_v_/_r_m_t_0	  oouutt==_d_t_e_d_._o_u_t
       hheeaadd==_d_t_e_d_._h_e_a_d nn==_3_7_._3_0_._0_0_n ss==_3_7_._1_5_._0_0_n ee==_1_0_3_._3_0_._0_0_w  ww==_1_0_3_._4_5_._0_0_w

       will  extract  DTED  data  from	/dev/rmt0,  store  it  in a file named
       dted.out, and store some supporting information in the file  dted.head.
       Only  data that falls within the geographic region defined by the coor-
       dinates nnoorrtthh, ssoouutthh, eeaasstt and wweesstt will be extracted.

NNOOTTEE
       The user should examine the contents of the  header  file  produced  by
       this  program;  it  contains  information  needed as inputs to the data
       rotation and raster file import programs _m_._r_o_t_9_0 and _r_._i_n_._l_l,  respect-
       fully.

BBUUGGSS
       The  format  of the header file for DTED Level 1 and 2 data was changed
       in 1987.  _m_._d_t_e_d_._e_x_t_r_a_c_t and _m_._d_t_e_d_._e_x_a_m_i_n_e only operate on  DTED  data
       containing pre-1987 headers.  DTED data containing the pre-1987 headers
       may be purchased from the DMA upon request.

DDIIAAGGNNOOSSTTIICCSS
       Invalid requests are so designated.

SSEEEE AALLSSOO
       _P_u_r_s_u_a_n_c_e _o_f _E_l_e_v_a_t_i_o_n _D_a_t_a, by Stuart Bradshaw, USACERL
       _D_T_E_D _a_n_d _D_E_M _E_l_e_v_a_t_i_o_n _D_a_t_a _E_x_t_r_a_c_t_i_o_n, by Stuart Bradshaw,  Mary  Mar-
       tin, and Chester Kos, USACERL


       _g_._r_e_g_i_o_n

       _m_._d_m_a_U_S_G_S_r_e_a_d

       _m_._d_t_e_d_._e_x_a_m_i_n_e

       _m_._e_x_a_m_i_n_e_._t_a_p_e

       _m_._r_e_g_i_o_n_._l_l

       _m_._r_o_t_9_0

       _r_._d_e_s_c_r_i_b_e

       _r_._i_n_._l_l

       _r_._r_e_s_c_a_l_e

       _r_._s_l_o_p_e_._a_s_p_e_c_t

AAUUTTHHOORR
       Michael Shapiro, 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_2_/_2_8 _1_2_:_4_7_:_2_5 _$



GRASS 5.0						     m.dted.extract(1)
