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 Topologi-
       cal Vector Profile.  It creates 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  directory,	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 quality files and metadata below.




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

       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 out-
	      put 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 topologically: 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  algorithms are applied to construct the missing topology that
       SDTS requires.  A potential problem arises, however, with the  transfer
       of  object  attributes  in  certain circumstances. 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-exis-
       tent  polygon?	The "-a" option, which transfers 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 displayed if any data quality modules are missing.


       Data  quality reports can be created, and installed in the proper loca-
       tion 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  program  searches
       in the _d_i_g___m_i_s_c directory for a supplementary 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 program.

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 directory 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	corre-
       sponding 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 vec-
       tor 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)
