README_G GMT2CHA 1.3 980905 ********************************************************************** CHART - Electronic Chart System (c) Heiko Purnhagen 1993-1998 e-mail: purnhage@tnt.uni-hannover.de WWW: http://www.fet.uni-hannover.de/~purnhage/ All usual disclaimers apply! You use CHART at your own risk! This program may be copied according to the GNU General Public Licence. See file COPYING for details. For download and updates check the CHART home page: http://www.fet.uni-hannover.de/~purnhage/gps/gps.html ********************************************************************** Table of Contents ----------------- 1. Overview 2. GMT - Generic Mapping Tools 3. The GMT2CHA conversion tool 3.1 GMT2CHA usage 3.2 Scripts 3.3 Example charts 4. Distribtuion & Files 5. Changes 1. Overview ------------- CHART is a litte Electronic Chart System for PCs. It supports both vector charts and bitmap charts and includes a vector chart and waypoint editor. GPS navigation data in NMEA format and from GPSPAC (Rockwell NavCore V format) can be received via the serial port and displayed in real time. CHART is a pure DOS program written in Turbo Pascal 6.0. It has been successfully tested on various DOS version (MS-DOS 3.2, 6.0, 7.0, 4DOS), the DOS boxes of Win3.1/3.11 and Win95, and the Linux DOSEMU. The GMT2CHA utility permits to convert data from the world vector shoreline data base available with the GMT mapping programs to the format used by CHART. Thus baisc costal vector charts for use with CHART are easily available. GMT2CHA generated vector charts covering the Scandinavia and the coast from Goteborg (Sweden) to Flekkefjord (Norway) are included as examples. 2. GMT - Generic Mapping Tools -------------------------------- GMT (Generic Mapping Tools) is a very good set of UNIX mapping programs available on the Internet at no charge: http://www.soest.hawaii.edu/soest/gmt.html GMT ftp sites: kiawe.soest.hawaii.edu ibis.grdl.noaa.gov ftp.geologi.uio.no The current version GMT 3.0 includes a 50 MByte data base with the vectorised shoreline of the world with a typical error of only a few 100 meters - corresponding to an 1:250000 map. Rivers, lakes and political borders are included with somewhat lower resolution. All data in the GMT data base refers to the WGS84 system. 3. The GMT2CHA conversion tool -------------------------------- GMT2CHA is a conversion tool that transforms Postscript maps generated by GMT into the vector chart format used by CHART. Thus you can make your own vector maps using the data base availabel with GMT. This is a great starting point for areas where you don't have any bitmap or vector charts available. Linux was used to develope gmt2cha.c since GMT lives also in the UNIX world. 3.1 GMT2CHA usage ------------------ Make the gmt2cha executable: make Call the chalistc script to generate all example charts included in the distribution: make charts Of coure this requires that the GMT 3.0 software and the GMT "full resolution" data base is installed on your machine. Basic online help: gmt2cha -h General usage: gmt2cha [-] [ []] use every -th data point default: 1 (i.e. use all data points) input postscript file by GMT“s pscoast default: stdin output CHART vector chart default: stdout Some progress data is reported on stdout. Generate a chart covering the area w/e/s/n (west/east/south/north borders in ddd:mm) from the GMT dataset r (crude .. full): pscoast -JX1000d -Rw/e/s/n -Dr -W | gmt2cha > gmtchart.cha Example: world map (crude dataset) / use every 10th data point pscoast -JX1000d -R-180/180/-90/90 -Dc -W | gmt2cha -10 > gmtworld.cha Example: demo map (full dataset) / use all data points pscoast -JX1000d -R10:20/10:35/59:25/59:35 -Df -W | gmt2cha > gmtdemo.cha 3.2 Scripts ------------ The script chalistc demonstrates how to generate a set of vector charts from the GMT data base. It also produces an overview/index chart which shows the outline of all charts that were generated. This overview is available as postsript file and as CHART vector chart and simplifies the selection of the desired chart. The script can be easily modified to generate charts for other regions of the world. To avoid memory problems with CHART, the outline/area of a new chart should be chosen such that it does not consist of more than about 2000 points. 3.3 Example charts ------------------- Each chart has contains about 1500 to 2000 points and requires about 100k memory when loaded by CHART. west east south north resolution filename region ----- ----- ----- ----- ------------ ------------ ------ 02:00/32:00/52:00/72:00 crude gc_skan.cha Scandinavia 04:00/14:00/53:00/63:00 low gl_dkn.cha Denmark and south Norway 07:00/12:00/57:00/60:00 intermediate gi_skag.cha Skagerak 11:20/12:30/57:00/58:00 high gh_gote.cha Goteborg 10:50/12:10/57:50/58:30 high gh_orst.cha Tjorn & Orust 10:40/11:30/58:20/59:20 high gh_bohu.cha Bohuslan 10:00/11:00/59:00/60:00 high gh_ofjd.cha Oslofjord 07:50/10:10/58:00/59:10 high gh_slnd.cha Sorlandet 06:30/08 10/57:50/58:20 high gh_agdr.cha Agder 10:20/10:50/59:40/60:00 full gf_5910a.cha Oslo 10:00/11:00/59:20/59:45 full gf_5910b.cha Horten & Moss 10:19/10:37/59:00/59:28 full gf_5910c.cha Tonsberg & Tjome 09:50/10:30/58:50/59:10 full gf_5910d.cha Larvik 09:20/10:10/58:55/59:10 full gf_5809a.cha Langesund 09:10/09:50/58:45/59:02 full gf_5809b.cha Kragero 08:50/09:30/58:30/58:50 full gf_5809c.cha Risor & Tvedestrand 08:40/09:10/58:20/58:40 full gf_5808a.cha Arendal 08:20/09:00/58:10/58:30 full gf_5808b.cha Grimstad 07:55/08:30/58:00/58:20 full gf_5808c.cha Kristiansand [ list of gf_xxxxx.cha not complete ... ] Overview (gf_*.cha, gh_*.cha) chartidx.cha 4. Distribtuion & Files ------------------------- The GMT2CHA distribution consists of the following 3 files: gmtcha3a.zip (283k) all files except gf_*.cha gmtcha3b.zip (205k) gf_580*.cha, gf_591*.cha gmtcha3c.zip (219k) gf_581*.cha, gf_571*.cha The GMT2CHA distribution contains: General readme_g this file copying GNU General Public Licence Linux/UNIX gmt2cha.c converter GMT Postscript -> CHART vector chart makefile makefile for gmt2cha chalistc script to generate the included charts addidxc further scripts for chalistc ... addidxxy addidxtx addidxch Demo charts gmtworld.cha world (very very crude) gmtwrld5.cha world (very crude) gmtdemo.cha demo chart (full) Example charts (Scandinavia & coast Goteborg to Flekkefjord) gmtidx.ps Postscript overview chart gmtidx.gif ... as GIF gmtidx.bmp ... as BMP chartidx.cha CHART overview chart gc_skan.cha Scandinavia gl_dkn.cha Denmark and south of Norway gi_skag.cha Skagerak gh_gote.cha Goteborg gh_orst.cha Tjorn & Orust gh_bohu.cha Bohuslan gh_ofjd.cha Oslofjord gh_slnd.cha Sorlandet gh_agdr.cha Agder gf_5712a.cha coast from Goteborg ... gf_5711a.cha gf_5711b.cha gf_5711c.cha gf_5711d.cha gf_5711e.cha gf_5711f.cha gf_5811a.cha gf_5811b.cha gf_5811c.cha gf_5811d.cha gf_5811e.cha gf_5811f.cha gf_5811g.cha gf_5811h.cha gf_5811i.cha gf_5811j.cha gf_5911a.cha gf_5910e.cha gf_5910f.cha gf_5910a.cha gf_5910b.cha gf_5910c.cha gf_5910d.cha gf_5809a.cha gf_5809b.cha gf_5809c.cha gf_5808a.cha gf_5808b.cha gf_5808c.cha gf_5807a.cha gf_5807b.cha gf_5806a.cha gf_5806b.cha ... to Flekkefjord 6. Changes ------------ 05-jul-97 inital version 28-jun-98 added chartidx.cha added more gf_*.cha's (from Goteborg to Flekkefjord) 12-aug-98 added visualisation of coast line's "shore" side line/poly type "f" (ccw around land) 05-sep-98 updated readme_g end of README_G ersion 28-jun-98 added chartidx.cha added more gf_*.cha's (from Goteborg to Flekkefjord) 12-aug-98 added visualisation of coast line's "shore" side line/poly type "f" (ccw around land) 05-sep-98 updated readme_g end of README_G