Skip to content

Commit

Permalink
GTM driver: add documentation
Browse files Browse the repository at this point in the history 
git-svn-id: https://svn.osgeo.org/gdal/trunk/gdal@17608 f0d54148-0727-0410-94bb-9a71ac55c965
  • Loading branch information
rouault committed Sep 2, 2009
1 parent 7232e84 commit 3f21188
Show file tree
Hide file tree
Showing 2 changed files with 74 additions and 0 deletions.
67 changes: 67 additions & 0 deletions ogr/ogrsf_frmts/gtm/drv_gtm.html
View file
Original file line number Diff line number Diff line change
@@ -0,0 +1,67 @@
<html>
<head>
<title>GTM - GPS TrackMaker</title>
</head>

<body bgcolor="#ffffff">

<h1>GTM - GPS TrackMaker</h1>

<p>
<a href="http://www.gpstm.com/">GPSTrackMaker</a> is a program that is
compatible with more than 160 GPS models. It allows you to create your
own maps. It supports vector maps and images.
</p>

<p>
The OGR driver has support for reading and writing GTM 211 files
(.gtm); however, in this implementation we are not supporting images
and routes. Waypoints and tracks are supported.
</p>

<p>Although GTM has support for many data, like NAD 1967, SAD 1969,
and others, the output file of the OGR driver will be using WGS 1984.
And the GTM driver will only read properly GTM files georeferenced as WGS 1984 (if not
the case a warning will be issued).
</p>

<p>The OGR driver supports just POINT, LINESTRING, and MULTILINESTRING.</p>

<h2>Example</h2>

<li>The ogrinfo utility can be used to dump the content of a GTM datafile :

<pre>
ogrinfo -ro -al input.gtm
</pre>
</li>
<p>
<br />
</p>
<li>Use of -sql option to remap field names to the ones allowed by the GTM schema:
<pre>
ogr2ogr -f "GPSTrackMaker" output.gtm input.shp -sql "SELECT field1 AS name, field2 AS color, field3 AS type FROM input"
</pre>
</li>
<p>
<br />
</p>

<li>Example for translation from PostGIS to GTM:
<pre>
ogr2ogr -f "GPSTrackMaker" output.gtm PG:"host=hostaddress user=username dbname=db password=mypassword" -sql "select filed1 as name, field2 as color, field3 as type, wkb_geometry from input" -nlt MULTILINESTRING
</pre>
<br>
Note : You need to specify the layer type as POINT, LINESTRING, or MULTILINESTRING.
</li>


<h2>See Also</h2>

<ul>
<li> <a href="http://www.gpstm.com/">Home page for GPS TrackMaker Program</a><p>
<li> <a href="http://www.gpstm.com/download/GTM211_format.pdf">GTM 211 format documentation</a><p>
</ul>

</body>
</html>
7 changes: 7 additions & 0 deletions ogr/ogrsf_frmts/ogr_formats.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -129,6 +129,13 @@ <h1>OGR Vector Formats</h1>
</td><td> No, needs libgrass
</td></tr>

<tr><td> <a href="drv_gtm.html">GPSTrackMaker (.gtm, .gtz)</a>
</td><td> GPSTrackMaker
</td><td> Yes
</td><td> Yes
</td><td> Yes
</td></tr>

<tr><td> <a href="drv_idb.html">Informix DataBlade</a>
</td><td> IDB
</td><td> Yes
Expand Down

0 comments on commit 3f21188

Please sign in to comment.