v.out.sdts(1)	       Grass User's Manual	    v.out.sdts(1)



NNAAMMEE
       vv..oouutt..ssddttss   -  Creates	an SDTS dataset conforming to the
       Topological Vector Profile from a GRASS vector map  layer.
       _(_G_R_A_S_S _V_e_c_t_o_r _D_a_t_a _E_x_p_o_r_t_/_P_r_o_c_e_s_s_i_n_g _P_r_o_g_r_a_m_)

SSYYNNOOPPSSIISS
       vv..oouutt..ssddttss
       vv..oouutt..ssddttss hheellpp
       vv..oouutt..ssddttss [--aamm] iinnppuutt=_n_a_m_e [ppaatthh=_n_a_m_e] oouuttppuutt=_n_a_m_e

DDEESSCCRRIIPPTTIIOONN
       _v_._o_u_t_._s_d_t_s  creates  an	SDTS dataset that conforms to the
       requirements of both the  federal  Spatial  Data  Transfer
       Standard and the SDTS Topological Vector Profile.  It cre-
       ates the dataset from the files associated with	a  vector
       map  layer which is specified by the user.  The files that
       make up the SDTS dataset are output to the current  direc-
       tory,  unless  otherwise  specified  by the user (with the
       path parameter).  The output dataset is in  the	mandatory
       ISO 8211 (FIPS 123) format; the ISO 8211/SDTS output files
       can be inspected with _m_._s_d_t_s_._r_e_a_d.

CCOOMMMMAANNDD LLIINNEE OOPPTTIIOONNSS
   FFllaaggss::
       --aa     transfer Lines of "AREA type" only; omit	Lines  of
	      "LINE type" from output SDTS dataset.

       --mm     access  user-defined  metadata  file.  This file is
	      typically,  but  not  necessarily,   created   with
	      _v_._s_d_t_s_._m_e_t_a.  See the discussion of SDTS data qual-
	      ity files and metadata below.




   PPaarraammeetteerrss::
       iinnppuutt==_n_a_m_e
	      name of  vector  map  layer  from  which	the  SDTS
	      dataset wil be created.

       ppaatthh==_n_a_m_e
	      full  path to location for placement of output SDTS
	      dataset.	Path must exist and be	writable  by  the
	      user.   If  path	is not specified, dataset will be
	      output to the current directory.

       oouuttppuutt==_n_a_m_e
	      four-character string to be used as prefix for each
	      of  the  output SDTS files.  Can be any combination
	      of letters and digits,  although	letters  must  be
	      upper-case.




LLIINNEE TTYYPPEESS IINN GGRRAASSSS AANNDD SSDDTTSS
       GRASS  makes a distinction between types of lines, between
       those that are edges of areas or polygons and  those  that
       are  not.   GRASS  handles these types different topologi-
       cally: AREA type lines carry pointers to  left  and  right
       polygons, but LINE type lines carry no such pointers.


       The  SDTS  Topological  Vector  Profile, however, does not
       distinguish line types, and does require  that  ALL  lines
       carry  left  and right polygon references.  This has meant
       that during the	export	process  topology-building  algo-
       rithms  are applied to construct the missing topology that
       SDTS requires.  A potential problem arises, however,  with
       the  transfer  of  object  attributes  in  certain circum-
       stances. E.g. if a polygon in GRASS is bisected by a  line
       of  type LINE, the resulting SDTS dataset will contain two
       polygons where only one	existed  in  GRASS:  should  both
       these  polygons be assigned the attribute of the original,
       now non-existent polygon?  The "-a" option,  which  trans-
       fers only AREA type lines, works around this problem.

SSDDTTSS RREEQQUUIIRREEMMEENNTTSS:: DDAATTAA QQUUAALLIITTYY RREEPPOORRTTSS
       SDTS  datasets  are  required  to contain 5 different data
       quality report modules, for Lineage, Positional	Accuracy,
       Attribute Accuracy, Logical Consistency, and Completeness.
       When _v_._o_u_t_._s_d_t_s is run, it searches in the user's mapset's
       _d_i_g___m_i_s_c  directory  for  appropriate  files, one for each
       module, containing narrative text  in  ASCII  format.   If
       found,  they  are  converted  to  SDTS/ISO 8211 format and
       added to the export dataset;  warning  messages	are  dis-
       played if any data quality modules are missing.


       Data  quality reports can be created, and installed in the
       proper location under _d_i_g___m_i_s_c, with _v_._s_d_t_s_._m_e_t_a.

OOTTHHEERR MMEETTAADDAATTAA
       When _v_._o_u_t_._s_d_t_s is run, if the "-m" flag is set, the  pro-
       gram  searches  in the _d_i_g___m_i_s_c directory for a supplemen-
       tary metadata file for the map  layer  being  transferred.
       If  found,  its	contents  are  incorporated  in  the SDTS
       dataset. This file  can	be  created  and  installed  with
       _v_._s_d_t_s_._m_e_t_a;  for  details  see the _m_a_n page for this pro-
       gram.

SSDDTTSS RREEQQUUIIRREEMMEENNTTSS:: TTHHEE ''RREEAADDMMEE'' FFIILLEE
       In addition to the files created by v.out.sdts, every SDTS
       transfer  must  contain	a  README file.  This file is not
       generated by _v_._o_u_t_._s_d_t_s, and must be created by	hand.  It
       should contain:

	.PP	"volume  name  [if  appropriate], date, a list of
	      SDTS transfers (if more than  one),  and	then  for
	      each  SDTS  transfer:  a list of subdirectories and
	      non-SDTS files, if approriate, the file name of the
	      Catalog/Directory  module,  where  it can be found,
	      and an explanation that this  file  and  all  other
	      SDTS  files  are	in  ISO 8211 format, and that the
	      Catalog/Directgory module carries a complete direc-
	      tory  to	all  other SDTS ISO 8211 files comprising
	      the  SDTS  transfer,  notes  about   any	 non-SDTS
	      adjunct/auxiliary files, a brief explanation of the
	      spatial domain, the purpose, authority (FIPS  173),
	      source  (e.g.  agency name) and contacts within the
	      source organization...."	 (_S_D_T_S_,  _I_V_:  _T_o_p_o_l_o_g_i_c_a_l
	      _V_e_c_t_o_r _P_r_o_f_i_l_e_, _6_._1_0).

GGRRAASSSS AATTTTRRIIBBUUTTEESS IINN TTHHEE SSDDTTSS DDAATTAASSEETT
       The  SDTS  dataset  produced  by  _v_._o_u_t_._s_d_t_s  contains two
       attribute module files.	One, containing attribute  module
       "AP00",	stores	global	attributes,  i.e., metadata items
       applicable to the entire transfer (most are  derived  from
       the  _d_i_g  file header).	The second holds attribute module
       "AP01", and contains records  with  two	fields:  ATTR_NUM
       contains  _d_i_g___a_t_t  integer values; and ATTR_LABEL contains
       the corresponding labels or descriptions from the _d_i_g___c_a_t_s
       file.

RREESSTTRRIICCTTIIOONNSS
       Currently, the user can only create an SDTS dataset from a
       single vector map layer in his or her mapset at a time.

SSEEEE AALLSSOO
       _m_._s_d_t_s_._r_e_a_d_,    _v_._i_n_._s_d_t_s_,    _v_._o_u_t_._s_d_t_s_,    _v_._s_d_t_s_._d_p_._c_p_,
       _v_._s_d_t_s_._m_e_t_a_._c_p_, _v_._s_d_t_s_._m_e_t_a

AAUUTTHHOORRSS
       David Stigberg, U.S.Army Construction Engineering Research
       Laboratory
       Tin Qian, University of Illinois

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



GRASS 5.0					    v.out.sdts(1)
