
An SDTS profile, in general terms, is defined as a limited subset of the Spatial Data Transfer Standard, designed for use with a specific type of data. Specific choices are made for encoding possibilities not addressed, left optional, or left with numerous choices within Parts 1, 2, and 3 of SDTS.
An SDTS profile shall provide for the transfer of files, records, fields and subfields with the following objectives:
Part 4, the Topological Vector Profile (TVP), contains specifications for an SDTS profile for use with geographic vector data with planar graph topology.
By "geographic" we mean data that describe "real-world" features, rather than a symbolized map graphic. The data may be derived from a cartographic product (map), but the purpose of the data is not to convey the map graphic, but rather information about the geographic features displayed on the map.
The data are represented by vector objects which comprise, or are integrated with, one or more 2-D manifolds (see Part 1 definition 2.3.4.5.2). Excluded are raster data, geometry-only vector data, planar graphs which do not have GT-polygons, and non-planar graph-based network data. These types of data may be accommodated either by other profiles, or future extensions to this profile.
Part 4 is organized using the same major headings found in Part 1. Specific discussions regarding encoding possibilities in Part 1 are grouped under each major heading and will include specific references to Parts 1, 2, or 3 where necessary for clarification.
Annexes D, E, and F of Part 4 contain permitted options to this profile. These options implement additional features of the SDTS which may be useful in some transfers. Encoders and decoders are not required to implement these options to be conforming to this profile. However, the presence of these options shall be tolerated by decoders.
(see also Part 1, Section 1.2, Conformance)
There are three types of products which can be tested for conformance to this profile:
In order to conform to this Topological Vector Profile, an SDTS transfer shall:
In order to conform to this Topological Vector Profile, an SDTS encoder shall:
In order to conform to this Topological Vector Profile, an SDTS decoder shall:
(see also Part 1, Section 2, Spatial Data Concepts)
(see also Part 1, Section 2.3, Definition of Spatial Objects)
Table 1 indicates which spatial objects are required, optional, or not permitted for this profile.
Data are to be represented by one or more 2-D manifolds (see Part 1 definition 2.3.4.5.2). A single 2-D manifold shall be used to transfer:
Object representation code | Required | Optional | Not permitted |
|---|---|---|---|
NP - Point1 | |||
NE - Entity point2 | |||
LS - String3 | |||
RU - Ring composed of chains4 | |||
| 1 Points with the "NP" object representation code are allowed only for use in data quality reports. 2Each of these objects must participate as a component of a 2-D manifold. 34 |
More than one layer and (or) more than one horizontal partition may be included within a single SDTS transfer. See Section 4.7 of Part 4, "Relationships Between Modules and 2-D Manifolds" for information on module requirements when transferring multiple 2-D manifolds.
(see also Part 1, Section 3, Spatial Data Quality)
Separate processing histories pertaining to, for example, separate data layers, shall be documented.
If data are collected from a graphic map, then a statement explaining that the data may contain cartographic offsets shall be included in the positional accuracy portion of the data quality report.
The technique used to verify topology shall be documented.
Report and explain data encoding practices, especially in object records, which might seem contrary to, or to deviate from, normal, standard or preferred practices. For example, if one or more composite object records lack lists of component objects, the meaning of this shall be explained in the completeness portion of the data quality report.
(see also Part 1, Section 4.1.3, The Transfer Model)
SDTS Topological Vector Profile module names (the unique name of each individual module) shall be standardized, and consist of four characters. All letters in module names shall be upper case. For modules carrying spatial objects, the module name shall begin with the same two characters as the object representation code for the objects (use "PC" for modules with "PC", "PX", and "PW" objects and use "FF" for composite objects). The other valid two character Object Representation codes are shown in Section 2.1 of Part 4, Spatial Data Concepts, Spatial Objects. The last two characters of the module name are free to distinguish different modules/files. Attribute Primary and Secondary modules shall be named "Axxx" and "Bxxx" respectively (where x is any number 0-9 or any upper case letter A-Z).
Non-object modules shall be named the same as the primary module field mnemonic (ISO 8211 Tag) (see Part 1, Sections 5.2 and 5.3, Global Information and Data Quality Modules, and Part 3 Table 1):
More than one module of the following types may exist:
The last character shall change to reflect more than one module of the same type.
(see also Part 1, Section 4.1.3.5, Spatial Registration)
There shall be only one external coordinate frame of reference within a transfer. The external spatial reference system shall be one of the systems which make up conformance level 1: latitude-longitude (geographic), Universal Transverse Mercator/Universal Polar Stereographic (UTM/UPS), or State Plane Coordinate Systems (SPCS.) If different horizontal partitions are included within the transfer, each may have its own internal coordinate system (referenced to the external spatial reference system by translation and scaling parameters in an Internal Spatial Reference module record).
(see also Part 1, Section 4.1.3.5, Spatial Registration, and Section 5.2.4, Spatial Reference)
Topological Vector Profile transfers shall be restricted to the use of conformance level 1 for horizontal external coordinates. To explicitly state this restriction,
Note that Part 1 restricts the unit of measurement in the external reference system to meters for all Z coordinates and X and Y coordinates when using the State Plane Coordinate System. However, coordinates can be stored in the internal reference system in feet as long as the appropriate scaling factors are used in the Internal Spatial Reference module.
(see also Part 1, Section 4.2.1, Specification Layout; Part 3, Section 9.3 Binary Data)
The internal representation of X, Y and Z coordinates shall be as 32-bit signed implicit fixed point binary numbers ("BI32" SDTS data type). Signed integers are represented in "two's complement" format as defined in ANSI X3.122 - 1986 Part 3, Section 5.1. This standard requires "big-endian" bit ordering in which the most significant bit is stored first (Related references: ANSI X3.122, FIPSPUB 128, and ISO 8632-3; all of which are parts of the Computer Graphics Metafile standard.)
Internal fixed point coordinates can be converted to external coordinates by converting to floating point and applying the scaling and translation values from an Internal Spatial Reference module--see Part 1, 5.2.4.1.)
The X subfield of spatial addresses shall only be used to transfer longitude and easting values. The Y subfield shall only be used to transfer latitude or northing.
(see also Part 1, Section 4.1.3.3.9, Nulls and Defaults)
When a transfer uses fixed length subfields (e.g. to carry attribute data linked to the various objects), then special consideration must be given to handling Null values. The SDTS default option for implementing nulls is not feasible in this case. When appropriate, the following text shall be encoded in the Comment subfield of a Logical Consistency module record, and implemented:
When a subfield, either user-defined in Attribute Primary and Attribute Secondary module records, or in other SDTS module records, is implemented as fixed-length, the following null scheme is used: (a) when information to be encoded in the subfield is known to be not applicable (undefined, not relevant), then the subfield is valued by a string of spaces; and (b) when the information to be encoded is relevant but unknown (or missing), then the subfield is valued by a string of question marks "?".
The Logical Consistency module with the above text shall be associated to applicable modules through the Catalog/Cross Reference module.
(see also Part 1, Annex B Section B.6 Suggested Code Sets)
All agencies shall use established FIPS codes where applicable, such as FIPS PUB 6-4 (31 August 1990) Counties and Equivalent Entities Codes or FIPS PUB 10-3 (9 February 1984) Countries, Dependencies, Areas of Special Sovereignty and their Principal Administrative Division.
Attributes that can be multi-valued shall be in their own tables, along with any other attributes that are functionally dependent. An attribute's cardinality and functional dependence is solely determined by the data encoder's data model. As an example of multi-valued consider an entity "road" with the attribute "name" that has the two values "10th Street" and "Highway BB". Attributes are functionally dependent when the value of one attribute determines the value of another attribute. For example, say attribute "route_number" is dependent on "name", which means the value of "name" determines the value for "route_number". (See Annex B for an example of encoding multi-valued attributes.)
The SDTS implementation of the entity-attribute-attribute value feature model provides a means of directly assigning attribute values to specific feature objects. The type of entity which the object represents is specified indirectly through Data Dictionary/Schema module records. The assumption is that each entity type represented is characterized by attributes. In some cases, however, all that may be encoded about a feature is its entity type with no other attributes.
For use with features with entity labels but no attributes (and optionally in cases where different features share the same attributes), two generic attribute labels are defined by this profile: "ENTITY_LABEL" and "ENTITY_AUTHORITY" (an entity label may only be unique when coupled with the authority for its definition). The authority for the definition of these two attribute labels is this profile, designated in Data Dictionary/Schema records (Attribute Authority subfield) as "SDTS/TVP". (No Data Dictionary/Definition or Data Dictionary/Domain records are necessary for these two attribute labels.) The domain of attribute values for these attributes shall be any entity label and its authority as defined in either SDTS Part 2 or Data Dictionary/Definition records included with the transfer (either internally or externally). When all entity labels in a single transfer are defined by the same authority, the ENTITY_AUTHORITY attribute may be omitted in the attribute records.
Annex C contains an example of attributing feature objects with entity labels.
(see also Part 1, Section 5, Transfer Module Specification)
This section addresses the module level restrictions as they apply to a transfer. Certain requirements of Part 1 are repeated here for clarity. Following the module level restrictions/requirements, any restrictions on field/subfield values are noted for each module. The order of coverage follows that of Part 1, Section 5.
Table 2 contains the inclusion/exclusion, and cardinality rules for each module. The standardized modules names are included, along with the minimum number and the maximum number of occurrences of the module type. A lowercase "n" indicates that the upper limit is user defined. Any lowercase letters or dots in the module name has the meaning explained in Section 4, Standard Module Names.
(see also Part 1, Section 5.2, Global Information Modules)
Module type | Name | Min. No. | Max. No. |
|---|---|---|---|
Global Information Modules (see also Part 1, Section 5.2, Global Information Modules) | |||
01 | n2 | ||
13 | |||
Data Quality Modules (see also Part 1, Section 5.3, Data Quality Modules) | |||
Attribute Modules (see also Part 1, Section 5.4, Attribute Modules) | |||
Vector Modules (see also Part 1, Section 5.6, Vector Modules) | |||
Arc4 | |||
Ring5 | |||
Graphic Representation Modules6 | |||
(see also Part 1, Section 5.3, Data Quality Modules)
(see also Part 1, Section 5.4, Attribute Modules)
There is no restriction on the relationships between objects and Attribute Primary module records: the relationship may be one-to-one, one-to-many, many-to-one, or many-to-many. If the relationship is not one-to-one or one-to-many, the encoder is required to alert decoders to this fact in the Catalog/Cross Reference module record for the modules involved. This shall be done by placing the characters "JJ" into the first two characters of the Comment subfield.
(see also Part 1, Section 5.5, Composite Module)
(see also Part 1, Section 5.6, Vector Modules)
The information in the Data Structure subfield of the Identification module will indicate the presence or absence of the various optional items such as area points and pointers from polygons to chains. The presence of these items in a transfer will typically reflect their presence in the source format and structure. For example, Standard DLG data do not have polygon-to-chain pointers, so a transfer from DLG-S data would not have pointers from polygons to chains (unless these pointers were built and added by the SDTS encoder, which is doubtful).
(see Part 1 definition 2.3.3.3.1)
A universe polygon (object representation code "PW") is mandatory. Its Record ID subfield shall be encoded with "1". Attributes of the universe polygon, if any, shall have null values (see below for specifications for implementing null values).
The Ring ID field is not permitted for universe polygons with an object representation code of "PW".
(see Part 1 definition 2.3.3.3.2)
Other GT-polygons may be included with attribution similar to the universe polygon; these void polygons shall be coded with a "PX" object representation code.
The Ring ID field is not permitted for void polygons with an object representation code of "PX".
Object records may reference zero, one or more attribute primary records except for area points ("NA" object representation code) which shall always reference zero attribute primary records. Attribute primary references for area points should instead be contained in the surrounding GT-polygon spatial object record.
A single module shall contain only records of a single object type (indicated by appropriate object representation code), with the technical exception that modules carrying "PC" (GT-polygon) records may also contain a "PW" (universe polygon) and "PX" (void polygon) records.
Points with the "NP" object representation code are allowed only for use in data quality reports. An example use is to transfer control points used for transformations which might be part of the Lineage Data Quality report.
The Attribute Primary Foreign ID (PAID) field is mandatory for the "NL" object representation code. This field references the record and the label of the attribute to be annotated. This field shall reference an attribute record in either an Attribute Primary module or an Attribute Secondary module.
These modules shall not be included in a transfer conforming to this profile.
These modules shall not be included in a transfer conforming to this profile unless the options described in Annex F are implemented. Encoders and decoders are not required to support these module types to be conforming to this profile.
(see also Part 1, Section 5.2.1, Table 10 Identification)
(see also Part 1, Section 5.2.1.2.2, External Spatial Reference Subfield)
The External Spatial Reference subfield of the Conformance field of the Identification module shall have the value of "1" indicating that, YES, one of three recommended systems is used.
Each transfer encoded per these specifications shall have
as the value of the Profile Identification subfield of the Identification module primary field.
If options described in Annexes D, E, or F are implemented in a transfer, each implemented annex shall be indicated by adding a "/" and the upper case letter of the annex to the Profile Identification subfield. Any combination of annexes may be implemented in a transfer. For example, if a transfer implements Annexes D and E, Profile Identification would contain "SDTS TOPOLOGICAL VECTOR PROFILE/D/E".
as the value of the Profile Version subfield of the Identification module primary field.
as the value of the Profile Document Reference subfield of the Identification module primary field.
(see also Part 1, Section 5.2.1.2.3, Features Level Subfield)
Any level of SDTS Features Conformance is allowed (the value in the Features Level subfield of the Conformance field of the Identification module record shall be either "1", "2", "3" or "4"). Note that if SDTS is not the authority for any entity and attribute terms, then the Features Level subfield must be valued as "4".
The Attribute ID field is used to reference global information that applies to the entire transfer (e.g. Census TIGER/LINE min and max ID numbers).
The X subfield of spatial addresses shall be used only for longitude and easting values. The Y subfield shall be used only for latitude and northing. Therefore, the Spatial Address X Component Label subfield is restricted to "LONGITUDE" when the external spatial reference system is geographic and "EASTING" when the external spatial reference system is UTM/UPS or SPCS. The Spatial Address Y Component Label subfield is restricted to "LATITUDE" when the external spatial reference system is geographic and "NORTHING" when the external spatial reference system is UTM/UPS or SPCS.
The Scale Factor X, Scale Factor Y, X Origin, and Y Origin subfields in the Internal Spatial Reference field are required. If spatial addresses include Z values, the Scale Factor Z and Z Origin subfields are required. These subfields specify the scaling and translation required to transform spatial addresses from the internal spatial reference to the external spatial reference (see Part 1, 5.2.4.1). The use of the Registration module to specify this transformation is not allowed.
The Reference System Name subfield in the External Spatial Reference Module primary field shall have the value "GEO", "SPCS", "UTM", or "UPS" depending upon the external spatial reference system being used.
The following requirements apply to the Catalog/Spatial Domain field in the Catalog/Spatial Domain module:
So that the contents of a transfer are independent of the transfer media, the following restrictions are placed on the primary field of the Catalog/Directory module:
The Entity Authority and Attribute Authority subfields shall contain "SDTS-USA" when Part 2 of FIPS 173 is the authority for the definition. When a standard register of entities and attributes of a country other than the United States is the authority, these subfields shall contain "SDTS-" followed by the three-character ISO 3166 country code. Entity Authority and Attribute Authority may have a maximum length of 8 graphics characters.
The Attribute Authority subfield may have a maximum length of 8 graphics characters.
The Attribute Authority subfield may have a maximum length of 8 graphics characters.
When a transfer includes multiple Internal Spatial Reference (IREF) Modules, each spatial object module must be cross-referenced to one IREF module.
(see also ANSI/ISO 8211-1985 a.k.a. FIPS PUB 123 Specifications for a Data Descriptive File for Information Interchange, and Part 3, ISO 8211 Encoding)
(see also Part 3, Sections 1.1 and 1.2, Purpose and Objectives):
SDTS/ISO 8211 is optimized for retrieval and storage (versus interactive decoding); non-SDTS directories/indices may be added to allow such interactive decoding (e.g. on a CD-ROM media).
(see also Part 1, Section 4.1.3, Tables 3a & 3b,
and Part 3, Section 7, Assignment of Fields to Records and Files)
(see also Part 3, Section 10, Media Requirements)
When only a single SDTS transfer is on a media volume, then the volume name shall begin with the same four characters as the first four characters of file names for that transfer (see section 6.5.) When multiple transfers are contained on a volume, then the first four characters of the volume name shall be "SDTS".
For multi-volume transfers, the first four characters shall be the transfer base characters as described above, and the remainder of the name shall indicate the volume sequence.
In general, the files comprising a single transfer shall be kept separate from any other transfer files.
SDTS Topological Vector Profile file names, to be consistent from the various agencies shall consist of eight characters of base name. A single transfer data set shall use the same first four characters in the file name of each SDTS ISO 8211 file in the entire transfer. The next four characters in the file name shall be the unique name of the module transferred in that file (see naming convention for modules in Section 4.1 of Part 4). When allowed, the extension should be ".DDF" to indicate the type of file transferred; but the last character of this extension or an optional ninth character on the base name may be used in the case of modules that span files. Thus the extension could become ".DDG", ".DDH", ".DDI", ... for multi-volume modules. Such file extenders are optional. Any file that is not ISO 8211 compliant (e.g. adjunct files) shall not have the ".DDx" extension. All letters in file names shall be upper case.
(see also Part 3, Section 6.4, Repeating Fields and Records)
This profile encourages taking advantage of ISO 8211 mechanisms to reduce file size. All modules shall use fixed size fields whenever practical to allow for the dropping of leader and directory information from the data records in ISO 8211. In the case where there are a few records that exceed the fixed size fields' size, records shall be ordered within a file to maximize the use of dropped leaders and directories. This means that exceptional data records (DRs) shall be placed first in the DDF. All records that can share a common leader and directory shall be grouped at the end of the file. (This is necessary because once the leader and directory are dropped, they cannot be respecified later in the file.)
Maximizing the use of dropped leaders and directories needs to be taken into consideration when designing attribute modules. If there are attributes that can have a wide range in the size of their value (e.g. place names), then considering separating these attributes into their own module.
A binary data type shall be used in the subfields of a spatial address field. The binary subfields shall be a fixed width of 32 bits.
(2B(32)) where: 2 = 2 or 3 depending on x,y or x,y,z B = indicates binary type subfield 32 = specifies the width of the binary subfield
(n(2B(32))) where: n = the number of spatial address tuples 2 = 2 or 3 depending on x,y or x,y,z B = indicates binary type subfield 32 = specifies the width of the binary subfield
((2B(32))) where: 2 = 2 or 3 depending on x,y or x,y,z B = indicates binary type subfield 32 = specifies the width of the binary subfield
(see also Part 3, Section 9.2, Dates)
Dates in the form YYYYMMDD are to be encoded as ISO 8211 data type = A.
(see also Part 3, Section 11, Conformance)
The README file shall contain volume name, 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 appropriate, 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/Directory 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. If there are any issues about the transfer, use of optional profile annexes, special purposes (i.e. private agreement transfer), non-standard uses of modules, etc., this shall be described.
|
U.S. Department of the Interior
|| U.S. Geological Survey 1400 Independence Road, Rolla, MO 65401 For general information call: (573)308-3500 URL: http://mcmcweb.er.usgs.gov/sdts/SDTS_standard_nov97/p4body.html Last modified: Monday, 14-Jan-2013 19:27:38 EST Maintainer: mcmcweb@usgs.gov Privacy Statement || Disclaimers || FOIA || Accessibility |