EVOLUTION-MANAGER
Edit File: sdts_al_main.html
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> <html xmlns="http://www.w3.org/1999/xhtml"> <head> <meta http-equiv="Content-Type" content="text/xhtml;charset=UTF-8"/> <meta http-equiv="X-UA-Compatible" content="IE=9"/> <meta name="generator" content="Doxygen 1.8.5"/> <title>SDTS_AL: $title</title> <link href="tabs.css" rel="stylesheet" type="text/css"/> <script type="text/javascript" src="jquery.js"></script> <script type="text/javascript" src="dynsections.js"></script> <link href="doxygen.css" rel="stylesheet" type="text/css" /> </head> <body> <div id="top"><!-- do not remove this div, it is closed by doxygen! --> <div id="titlearea"> <table cellspacing="0" cellpadding="0"> <tbody> <tr style="height: 56px;"> <td style="padding-left: 0.5em;"> <div id="projectname">SDTS_AL </div> </td> </tr> </tbody> </table> </div> <!-- end header part --> <!-- Generated by Doxygen 1.8.5 --> <div id="navrow1" class="tabs"> <ul class="tablist"> <li><a href="index.html"><span>Main Page</span></a></li> <li class="current"><a href="pages.html"><span>Related Pages</span></a></li> <li><a href="annotated.html"><span>Classes</span></a></li> <li><a href="files.html"><span>Files</span></a></li> </ul> </div> </div><!-- top --> <div class="contents"> <div class="textblock"><center> <title>SDTS Abstraction Library</title> </center><h2>Introduction</h2> <p>SDTS_AL, the SDTS Abstraction Library, is intended to be an relatively easy to use library for reading vector from SDTS TVP (Topological Vector Profile) files, primary DLG data from the USGS. It also include support for reading raster data such as USGS DEMs in SDTS format. It consists of open source, easy to compile and integrate C++ code.</p> <h2>SDTS Background</h2> <p>The USGS SDTS Page at <a href="http://mcmcweb.er.usgs.gov/sdts/">http://mcmcweb.er.usgs.gov/sdts</a> is the definative source of information on the SDTS format. The SDTS format is based on the <a href="http://starship.skyport.net/crew/tibs/iso8211/faq.html">ISO 8211</a> encoding scheme for the underlying files, and the SDTS Abstraction Library uses <a href="http://gdal.velocet.ca/projects/iso8211/index.html">ISO8211Lib</a> library to decode them. All references to DDF* classes are from ISO8211Lib.</p> <p>An SDTS Transfer is a grouping of ISO8211 encoded files (ending in the .DDF extension), normally with part of the basename in common. For instance a USGS DLG SDTS transfer might consists of many files matching the SC01????.DDF pattern. The key file in an SDTS transfer is the catalog file, such as SC01CATD.DDF.</p> <h2>Development Information</h2> <p>The <a href="class_sdtstransfer-include.html">sdts_al.h</a> include file contains the definitions for all public SDTS classes, enumerations and other services.</p> <p>The <a class="el" href="classSDTSTransfer.html">SDTSTransfer</a> class is used to access a transfer as a whole. The <a class="el" href="classSDTSTransfer.html#a6aa55051a8c6baa8c24764f0d5e7c279">SDTSTransfer::Open()</a> method is passed the name of the catalog file, such as SC01CATD.DDF, to open.</p> <p>The <a class="el" href="classSDTSTransfer.html">SDTSTransfer</a> analyses the catalog, and some other aspects of the transfer, and builds a list of feature layers. This list can be accessed using the SDTSTransfer::GetLayerCount(), <a class="el" href="classSDTSTransfer.html#ab2821befd783ddbf8f3d78dae71408f9">SDTSTransfer::GetLayerType()</a>, and <a class="el" href="classSDTSTransfer.html#a028d3ec2c7b3bcc719137e632b907ca3">SDTSTransfer::GetLayerIndexedReader()</a> methods. A typical TVP (Topological Vector Profile) transfer might include three point layers (of type SLTPoint), a line layer (of type SLTLine), a polygon layer (of type SLTPoly) as well as some additional attribute layers (of type SLTAttr). the <a class="el" href="classSDTSTransfer.html#a028d3ec2c7b3bcc719137e632b907ca3">SDTSTransfer::GetLayerIndexedReader()</a> method can be used to instantiate a reader object for reading a particular layer. (NOTE: raster layers are handled differently).</p> <p>Each type of <a class="el" href="classSDTSIndexedReader.html">SDTSIndexedReader</a> (<a class="el" href="classSDTSPointReader.html">SDTSPointReader</a>, <a class="el" href="classSDTSLineReader.html">SDTSLineReader</a>, <a class="el" href="classSDTSPolygonReader.html">SDTSPolygonReader</a>, and <a class="el" href="classSDTSAttrReader.html">SDTSAttrReader</a>) returns specific subclasses of SDTSIndexedFeature from the <a class="el" href="classSDTSIndexedReader.html#a9f5461d109c158088c7e783de52a39f3">SDTSIndexedReader::GetNextFeature()</a> method. These classes are <a class="el" href="classSDTSRawPoint.html">SDTSRawPoint</a>, <a class="el" href="classSDTSRawLine.html">SDTSRawLine</a>, <a class="el" href="classSDTSRawPolygon.html">SDTSRawPolygon</a> and <a class="el" href="classSDTSAttrRecord.html">SDTSAttrRecord</a>. These classes can be investigated for details on the data available for each.</p> <p>See the <a href="sdts_al_tut.html">SDTS_AL Tutorial</a> for more information on how to use this library.</p> <h2>Building the Source on Unix</h2> <ol> <li> <p class="startli">First, fetch the source. The most recent source should be accessable at an url such as <a href="ftp://gdal.velocet.ca/pub/outgoing/sdts_1_3.tar.gz">ftp://gdal.velocet.ca/pub/outgoing/sdts_1_3.tar.gz</a>.</p> <p></p> <p class="endli"></p> </li> <li> <p class="startli">Unpack the source.</p> <pre> % gzip -d sdts_1_3.tar.gz % tar xzvf sdts_1_3.tar.gz </pre><p class="endli"></p> </li> <li> <p class="startli">Type ``configure'' to establish configuration options. </p> <p></p> <p class="endli"></p> </li> <li> <p class="startli">Type make to build sdts_al.a, and the sample mainline sdts2shp.</p> <p></p> <p class="endli"></p> </li> </ol> <p>See the <a href="sdts_al_tut.html">SDTS_AL Tutorial</a> for more information on how to use this library.</p> <h2>Building the Source on Windows</h2> <ol> <li> <p class="startli">First, fetch the source. The most recent source should be accessable at an url such as <a href="ftp://gdal.velocet.ca/pub/outgoing/sdts_1_3.zip">ftp://gdal.velocet.ca/pub/outgoing/sdts_1_3.zip</a>.</p> <p></p> <p class="endli"></p> </li> <li> <p class="startli">Unpack the source.</p> <p></p> <pre> C:> unzip sdts_1_3.zip </pre><p class="endli"></p> </li> <li> <p class="startli">Build using makefile.vc with VC++. You will need the VC++ runtime environment variables (LIB/INCLUDE) set properly. This will build the library (sdts_al.lib), and the executables sdts2shp.exe, 8211view.exe and 8211dump.exe.</p> <p></p> <pre> C:> nmake /f makefile.vc </pre><p class="endli"></p> </li> </ol> <p>See the <a href="sdts_al_tut.html">SDTS_AL Tutorial</a> for more information on how to use this library.</p> <h2>The sdts2shp Sample Program</h2> <p>The sdts2shp program distributed with this toolkit is primary intended to serve as an example of how to use the SDTS access library. However, it can be useful to translate SDTS datasets into ESRI Shapefile format.</p> <pre> Usage: sdts2shp CATD_filename [-o shapefile_name] [-m module_name] [-v]</pre><pre>Modules include `LE01', `PC01', `NP01' and `ARDF' </pre><p>A typical session in which we inspect the contents of a transfer, and then extract polygon and line layers might look like this:</p> <pre> warmerda[134]% sdts2shp data/SC01CATD.DDF -v Layers: ASCF: `Attribute Primary ' AHDR: `Attribute Primary ' NP01: `Point-Node ' NA01: `Point-Node ' NO01: `Point-Node ' LE01: `Line ' PC01: `Polygon '</pre><pre>warmerda[135]% sdts2shp data/SC01CATD.DDF -m PC01 -o pc01.shp warmerda[136]% sdts2shp data/SC01CATD.DDF -m LE01 -o le01.shp </pre><p>A <a href="sdts2shp.zip">prebuilt executable</a> is available for Windows.</p> <h2>Licensing</h2> <p>This library is offered as <a href="http://www.opensource.org">Open Source</a>. In particular, it is offered under the X Consortium license which doesn't attempt to impose any copyleft, or credit requirements on users of the code.</p> <p>The precise license text is:</p> <p><em> Copyright (c) 1999, Frank Warmerdam </em></p> <p><em> Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: </em></p> <p><em> The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. </em></p> <p><em> THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. </em></p> <p><em> </em></p> <h2>Author and Acknowledgements</h2> <p>The primary author of SDTS_AL is <a href="http://pobox.com/~warmerdam">Frank Warmerdam</a>, and I can be reached at <a href="#" onclick="location.href='mai'+'lto:'+'war'+'me'+'rda'+'m@'+'pob'+'ox'+'.co'+'m'; return false;">warmerdam@pobox.com</a>. I am eager to receive bug reports, and also open to praise or suggestions.</p> <p>I would like to thank:</p> <ul> <li> <p class="startli"><a href="http://www.safe.com/">Safe Software</a> who funded development of this library, and agreed for it to be Open Source.</p> <p></p> <p class="endli"></p> </li> <li> <p class="startli">Mark Colletti, a primary author of <a href="http://mcmcweb.er.usgs.gov/sdts/sdtsxx/index.html">SDTS++</a> from which I derived most of what I know about SDTS and ISO8211 and who was very supportive, answering a variety of questions.</p> <p></p> <p class="endli"></p> </li> </ul> <p>I would also like to dedicate this library to the memory of Sol Katz. Sol released a variety of SDTS translators, at substantial personal effort, to the GIS community along with the many other generous contributions he made to the community. His example has been an inspiration to me, and I hope similar efforts on my part will contribute to his memory.</p> </div></div><!-- contents --> <!-- start footer part --> <hr class="footer"/><address class="footer"><small> Generated by  <a href="http://www.doxygen.org/index.html"> <img class="footer" src="doxygen.png" alt="doxygen"/> </a> 1.8.5 </small></address> </body> </html>