1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<!--Converted with LaTeX2HTML 99.2beta8 (1.46)
original version by: Nikos Drakos, CBLU, University of Leeds
* revised and updated by: Marcus Hennecke, Ross Moore, Herb Swan
* with significant contributions from:
Jens Lippmann, Marek Rouchal, Martin Wilck and others -->
<HTML>
<HEAD>
<TITLE>2. Introduction</TITLE>
<META NAME="description" CONTENT="2. Introduction">
<META NAME="keywords" CONTENT="GMT_Docs">
<META NAME="resource-type" CONTENT="document">
<META NAME="distribution" CONTENT="global">
<META HTTP-EQUIV="Content-Type" CONTENT="text/html; charset=iso-8859-1">
<META NAME="Generator" CONTENT="LaTeX2HTML v99.2beta8">
<META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css">
<LINK REL="STYLESHEET" HREF="GMT_Docs.css">
<LINK REL="next" HREF="node12.html">
<LINK REL="previous" HREF="node9.html">
<LINK REL="up" HREF="GMT_Docs.html">
<LINK REL="next" HREF="node11.html">
</HEAD>
<BODY bgcolor="#ffffff">
<!--Navigation Panel-->
<A NAME="tex2html1075"
HREF="node11.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.gif"></A>
<A NAME="tex2html1069"
HREF="GMT_Docs.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.gif"></A>
<A NAME="tex2html1063"
HREF="node9.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.gif"></A>
<A NAME="tex2html1071"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.gif"></A>
<A NAME="tex2html1073"
HREF="node149.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1076"
HREF="node11.html">References</A>
<B> Up:</B> <A NAME="tex2html1070"
HREF="GMT_Docs.html">The Generic Mapping Tools</A>
<B> Previous:</B> <A NAME="tex2html1064"
HREF="node9.html">1. Preface</A>
  <B> <A NAME="tex2html1072"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html1074"
HREF="node149.html">Index</A></B>
<BR>
<BR>
<!--End of Navigation Panel-->
<H1><A NAME="SECTION001000000000000000000">
2. Introduction</A>
</H1>
<P>
Most scientists are familiar with the sequence:
<I>raw data <IMG
WIDTH="20" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img8.gif"
ALT="$\rightarrow$"> processing <IMG
WIDTH="20" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img8.gif"
ALT="$\rightarrow$"> final illustration</I>.
In order to finalize papers for submission to scientific journals,
prepare proposals, and create overheads and slides for various
presentations, many scientists spend large amounts of time and
money to create camera-ready figures. This process can be tedious
and is often done manually, since available commercial or in-house
software usually can do only part of the job. To expedite this
process we introduce the Generic Mapping Tools (<A NAME="tex2html61"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> for short),
which is a free<A NAME="tex2html49"
HREF="footnode.html#foot608"><SUP>2.1</SUP></A>, software package that can be used
to manipulate columns of tabular data, time-series, and gridded
data sets, and display these data in a variety of forms ranging
from simple <I>x</I>-<I>y</I> plots to maps and color, perspective,
and shaded-relief illustrations. <A NAME="tex2html62"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> uses the <I>PostScript</I> page description language [<I>Adobe Systems Inc.</I>, 1990]<A NAME="612"></A>. With <I>PostScript</I>, multiple plot
files can easily be superimposed to create arbitrarily complex
images in gray tones or 24-bit true color. Line drawings, bitmapped
images, and text can be easily combined in one illustration.
<I>PostScript</I> plot files are device-independent: The same file
can be printed at 300 dots per inch (dpi) on an ordinary laserwriter
or at 2470 dpi on a phototypesetter when ultimate quality is needed.
<A NAME="tex2html63"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> software is written as a set of <I>UNIX</I> tools<A NAME="tex2html50"
HREF="footnode.html#foot613"><SUP>2.2</SUP></A>and is totally self-contained and fully documented. The system is offered free
of charge and is distributed over the computer
network (Internet) [<I>Wessel and Smith, 1991; 1995a,b; 1998</I>].
<P>
The original version 1.0 of <A NAME="tex2html64"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> was released in the summer of 1988
when the authors were graduate students at Lamont-Doherty Earth
Observatory<A NAME="615"></A><A NAME="616"></A> of Columbia University.
During our tenure as graduate
students, L-DEO changed its computing environment to a distributed
network of <I>UNIX</I> workstations, and we wrote <A NAME="tex2html65"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> to run in this
environment. It became a success at L-DEO, and soon spread to
numerous other institutions in the US, Canada, Europe, and Japan.
The current version benefits from the many suggestions
contributed by users of the earlier versions, and now includes more
than 50 tools, 25 map projections, and many other new, more
flexible features. <A NAME="tex2html66"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> provides scientists with a variety of
tools for data manipulation and display, including routines to sample,
filter, compute spectral estimates, and determine trends in time
series, grid or triangulate arbitrarily spaced data, perform
mathematical operations (including filtering) on 2-D data sets
both in the space and frequency domain, sample surfaces along
arbitrary tracks or onto a new grid, calculate volumes, and find
trend surfaces. The plotting programs will let the user make linear,
log<IMG
WIDTH="17" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
SRC="img9.gif"
ALT="$_{10}$">, and <I>x<IMG
WIDTH="11" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img10.gif"
ALT="$^a$"></I>-<I>y<IMG
WIDTH="11" HEIGHT="18" ALIGN="BOTTOM" BORDER="0"
SRC="img11.gif"
ALT="$^b$"></I> diagrams, polar and
rectangular histograms, maps with filled continents and coastlines
choosing from 25 common map projections, contour plots, mesh plots,
monochrome or color images, and artificially illuminated
shaded-relief and 3-D perspective illustrations.
<P>
<A NAME="620"></A>
<A NAME="621"></A>
<A NAME="622"></A>
<A NAME="623"></A>
<A NAME="624"></A>
<A NAME="625"></A>
<A NAME="tex2html67"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> is written in the highly portable ANSI C <A NAME="626"></A> programming language
[<I>Kernighan and Ritchie</I>, 1988], is fully POSIX compliant<A NAME="628"></A>
[<I>Lewine</I>, 1991], has no Year 2000 problems<A NAME="630"></A>, and may be used
with any hardware running some flavor of <I>UNIX</I>, possibly with minor
modifications. In writing <A NAME="tex2html68"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A>, we have followed the modular
design philosophy of <I>UNIX</I>: The <I>raw data <IMG
WIDTH="20" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img8.gif"
ALT="$\rightarrow$"> processing <IMG
WIDTH="20" HEIGHT="15" ALIGN="BOTTOM" BORDER="0"
SRC="img8.gif"
ALT="$\rightarrow$">
final illustration</I> flow is broken down to a series of elementary
steps; each step is accomplished by a separate <A NAME="tex2html69"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> or <I>UNIX</I> tool.
This modular approach brings several benefits: (1) only a few
programs are needed, (2) each program is small and easy to update
and maintain, (3) each step is independent of the previous step
and the data type and can therefore be used in a variety of
applications, and (4) the programs can be chained together in
shell scripts or with pipes, thereby creating a process tailored
to do a user-specific task. The decoupling of the data retrieval
step from the subsequent massage and plotting is particularly
important, since each institution will typically have its own
data base formats. To use <A NAME="tex2html70"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> with custom data bases, one has
only to write a data extraction tool which will put out data in a
form readable by <A NAME="tex2html71"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> (discussed below). After writing the extractor,
all other <A NAME="tex2html72"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> modules will work as they are.
<P>
<A NAME="tex2html73"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> makes full use of the <I>PostScript</I> page description language, and can produce color illustrations
if a color <I>PostScript</I> device is available. One does not
necessarily have to have access to a top-of-the-line color printer
to take advantage of the color capabilities offered by <A NAME="tex2html74"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A>: Several
companies offer imaging services where the customer provides a
<I>PostScript</I> plot file and gets color slides or hardcopies in return.
Furthermore, general-purpose <I>PostScript</I> raster image processors
(RIPs) are now becoming available, letting the user create raster images
from <I>PostScript</I> and plot these bitmaps on raster devices like computer
screens, dot-matrix printers, large format raster plotters, and film
writers<A NAME="tex2html51"
HREF="footnode.html#foot684"><SUP>2.3</SUP></A>.
Because the publication costs of color illustrations are high,
<A NAME="tex2html75"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> offers 90 common bit and hachure patterns, including many geologic
map symbol types, as well as complete graytone shading operations.
Additional bit and hachure patterns may also be designed by the user.
With these tools, it is possible to generate publication-ready
monochrome originals on a common laserwriter.
<P>
<A NAME="tex2html76"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> is thoroughly documented and comes with a technical reference and
cookbook which explains the purpose of the package and its many features,
and provides numerous examples to help new users quickly become familiar
with the operation and philosophy of the system. The cookbook contains
the shell scripts that were used for each example; <I>PostScript</I> files of each illustration are also provided. All programs have
individual manual pages which can be installed as part of the on-line
documentation under the <I>UNIX</I> <I>man</I><A NAME="755"></A> utility or as web pages. In addition, the
programs offer friendly help messages which make them essentially
self-teaching -- if a user enters invalid or ambiguous command arguments,
the program will print a warning to the screen with a synopsis of the
valid arguments. All the documentation is avaliable for web browsing
and may be installed at the users site.
<P>
The processing and display routines within <A NAME="tex2html77"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> are completely general
and will handle any (<I>x,y</I>) or (<I>x,y,z</I>) data as input.
For many purposes the (<I>x,y</I>) coordinates will be (longitude,
latitude) but in most cases they could equally well be any other
variables (e.g., wavelength, power spectral density). Since the <A NAME="tex2html78"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> plot tools will map these (<I>x,y</I>) coordinates to positions on a
plot or map using a variety of transformations (linear, log-log, and
several map projections), they can be used with any data that are
given by two or three coordinates. In order to simplify and standardize
input and output, <A NAME="tex2html79"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> uses two file formats only. Arbitrary sequences
of (<I>x,y</I>) or (<I>x,y,z</I>) data are read from multi-column ASCII
tables, i.e., each file consists of several records, in which each
coordinate is confined to a separate column<A NAME="tex2html52"
HREF="footnode.html#foot640"><SUP>2.4</SUP></A>. This format is
straightforward and allows the user to perform almost any simple
(or complicated) reformatting or processing task using standard
<I>UNIX</I> utilities such as <I>cut</I><A NAME="770"></A>, <I>paste</I><A NAME="775"></A>, <I>grep</I><A NAME="780"></A>,
<I>sed</I><A NAME="785"></A> and <I>awk</I><A NAME="790"></A>.
Two-dimensional data that have been sampled on an equidistant grid are
read and written by <A NAME="tex2html80"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> in a binary ``grdfile'' using the functions
provided with the netCDF<A NAME="646"></A> library (a free, public-domain software
library available separately from UCAR, the University Corporation
of Atmospheric Research [<I>Treinish and Gough</I>, 1987]). This XDR<A NAME="648"></A>
(External Data Representation) based format is architecture independent,
which allows the user to transfer the binary data files from one
computer system to another<A NAME="tex2html53"
HREF="footnode.html#foot649"><SUP>2.5</SUP></A>.
<A NAME="tex2html81"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> contains programs that will read ASCII
(<I>x,y,z</I>) files and produce gridded files. One such program,
<A NAME="tex2html82"
HREF="../surface.html"><I><B>surface</B></I></A><A NAME="802"></A>, includes new modifications to the gridding algorithm
developed by <I>Smith and Wessel</I> [1990] using continuous splines
in tension.
<P>
Most of the programs will produce some form of output, which falls
into four categories. Several of the programs may produce more than
one of these types of output:
<P>
<OL>
<LI>1-D ASCII Tables -- For example, a (x,y) series may be filtered and
the filtered values output. ASCII output is written to the standard output stream.
<P>
</LI>
<LI>2-D binary (netCDF or user-defined) ``grdfiles'' -- Programs that grid
ASCII (x,y,z) data or operate on existing grdfiles produce this type of output.
<P>
</LI>
<LI><I>PostScript</I> -- The plotting programs all use the <I>PostScript</I> page description language to define plots. These commands are stored as ASCII
text and can be edited should you want to customize the plot beyond the options
available in the programs themselves.
<P>
</LI>
<LI>Reports -- Several <A NAME="tex2html54"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> programs read input files and report statistics
and other information. Nearly all programs have an optional ``verbose''
operation, which reports on the progress of computation. All programs feature
usage messages, which prompt the user if incorrect commands have been given.
Such text is written to the standard error stream and can therefore be
separated from ASCII table output.
<P>
</LI>
</OL>
<P>
<A NAME="tex2html83"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> is available over the Internet at no charge. To obtain a copy, read
the relevant information on the <A NAME="tex2html84"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> home page www.soest.hawaii.edu/gmt,
or email
<A NAME="tex2html85"
HREF="mailto:listserver@soest.hawaii.edu">listserver@soest.hawaii.edu</A>
a note containing the single message
<BR><A NAME="661"></A>
<A NAME="662"></A>
<A NAME="663"></A>
<A NAME="664"></A>
<A NAME="665"></A>
<A NAME="666"></A>
<A NAME="667"></A>
<P>
<B>information gmtgroup</B>
<BR>
<P>
The listserver will mail you back a shell-script that you may run to obtain
all necessary programs, libraries, and support data. After you obtain the
<A NAME="tex2html86"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> archive, you will find that it contains information on how to install
<A NAME="tex2html87"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> on your hardware platform and how to obtain additional files that you
may need or want. The archive also contains a license agreement and
registration file. We also maintain two electronic mailing lists you may
subscribe to in order to stay informed about bug fixes and upgrades (See
Chapter 7).
<P>
For those without net-access that need to obtain <A NAME="tex2html88"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A>: Geoware
<A NAME="tex2html89"
HREF="(http://www.geoware-online.com)">(http://www.geoware-online.com)</A>
makes and distributes CD-Rs with the <A NAME="tex2html90"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> package, compatible supplements, and 1.7 Gb of
useful data sets. Geoware charge USD 35 for this service which includes
everything (CD-R, handling, postage). Send requests for media to:
<BR>
<P>
Geoware
<P>
Attn.: Paul Wessel
<P>
91-1007 Aawa Drive
<P>
Ewa Beach, HI 96706-3901, USA.
<BR>
<P>
Include return address and check for USD 35 payable to Geoware and drawn
on a US bank (non-US customers: your local bank can assist you in obtaining
a check in US dollars). For more information send e-mail to
<A NAME="tex2html91"
HREF="mailto:geoware@geoware-online.com">geoware@geoware-online.com</A>.
<P>
<A NAME="tex2html92"
HREF="http://www.soest.hawaii.edu/gmt"><B>GMT</B></A> has served a multitude of scientists very well, and their responses
have prompted us to develop these programs even further. It is our
hope that the new version will satisfy these users and attract new
users as well. We present this system to the community in order to
promote sharing of research software among investigators in the US
and abroad.
<P>
<BR><HR>
<!--Table of Child-Links-->
<A NAME="CHILD_LINKS"><STRONG>Subsections</STRONG></A>
<UL>
<LI><A NAME="tex2html1077"
HREF="node11.html">References</A>
</UL>
<!--End of Table of Child-Links-->
<HR>
<!--Navigation Panel-->
<A NAME="tex2html1075"
HREF="node11.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.gif"></A>
<A NAME="tex2html1069"
HREF="GMT_Docs.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.gif"></A>
<A NAME="tex2html1063"
HREF="node9.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.gif"></A>
<A NAME="tex2html1071"
HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.gif"></A>
<A NAME="tex2html1073"
HREF="node149.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.gif"></A>
<BR>
<B> Next:</B> <A NAME="tex2html1076"
HREF="node11.html">References</A>
<B> Up:</B> <A NAME="tex2html1070"
HREF="GMT_Docs.html">The Generic Mapping Tools</A>
<B> Previous:</B> <A NAME="tex2html1064"
HREF="node9.html">1. Preface</A>
  <B> <A NAME="tex2html1072"
HREF="node1.html">Contents</A></B>
  <B> <A NAME="tex2html1074"
HREF="node149.html">Index</A></B>
<!--End of Navigation Panel-->
<ADDRESS>
Paul Wessel
2001-04-18
</ADDRESS>
</BODY>
</HTML>
|
