<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN"> <!--Converted with LaTeX2HTML 2002-2-1 (1.71) 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>1.1 Tutorial setup</TITLE> <META NAME="description" CONTENT="1.1 Tutorial setup"> <META NAME="keywords" CONTENT="GMT_Tutorial"> <META NAME="resource-type" CONTENT="document"> <META NAME="distribution" CONTENT="global"> <META NAME="Generator" CONTENT="LaTeX2HTML v2002-2-1"> <META HTTP-EQUIV="Content-Style-Type" CONTENT="text/css"> <LINK REL="STYLESHEET" HREF="GMT_Tutorial.css"> <LINK REL="next" HREF="node10.html"> <LINK REL="previous" HREF="node8.html"> <LINK REL="up" HREF="node8.html"> <LINK REL="next" HREF="node10.html"> </HEAD> <BODY bgcolor="#ffffff"> <!--Navigation Panel--> <A NAME="tex2html524" HREF="node10.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html518" HREF="node8.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html512" HREF="node8.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html520" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html522" HREF="node63.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html525" HREF="node10.html">1.2 The GMT environment:</A> <B> Up:</B> <A NAME="tex2html519" HREF="node8.html">1. SESSION ONE</A> <B> Previous:</B> <A NAME="tex2html513" HREF="node8.html">1. SESSION ONE</A> <B> <A NAME="tex2html521" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html523" HREF="node63.html">Index</A></B> <BR> <BR> <!--End of Navigation Panel--> <H1><A NAME="SECTION00310000000000000000"> 1.1 Tutorial setup</A> </H1> <OL> <LI>We assume that <A NAME="tex2html68" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> has been properly and fully installed and that the <A NAME="tex2html69" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> executables are in your executable path described in the <A NAME="tex2html70" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> <U>README</U> file. <P> </LI> <LI>All <A NAME="tex2html71" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> man pages, documentation, and example scripts are available from the <A NAME="tex2html72" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> documentation web page. It is assumed these pages have been installed locally at your site; if not they are always available from the main <A NAME="tex2html73" HREF="http://gmt.soest.hawaii.edu">GMT home page</A>. <P> </LI> <LI>We recommend you create a sub-directory called <U>tutorial</U>, cd into that directory, and copy all the tutorial files directly there with ``<TT>cp -r $GMTHOME/share/doc/gmt/tutorial/* .</TT> ''. <P> </LI> <LI>As we discuss <A NAME="tex2html74" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> principles it may be a good idea to consult the <A NAME="tex2html75" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> Technical Reference and Cookbook for more detailed explanations. <P> </LI> <LI>The tutorial uses the supplemental <A NAME="tex2html76" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> program <A NAME="tex2html77" HREF="../man/grdraster.html"><I><B>grdraster</B></I></A><A NAME="1789"></A> to extract subsets of global gridded data sets. For your convenience we also supply the subsets in the event you do not wish to install <A NAME="tex2html78" HREF="../man/grdraster.html"><I><B>grdraster</B></I></A><A NAME="1794"></A> and the public data sets it can read. Thus, run the <A NAME="tex2html79" HREF="../man/grdraster.html"><I><B>grdraster</B></I></A><A NAME="1799"></A> commands if you have made the installation or ignore them if you have not. <P> </LI> <LI>For all but the simplest <A NAME="tex2html80" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> jobs it is recommended that you place all the <A NAME="tex2html81" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> (and <I>UNIX</I>) commands in a shell script file and make it executable. To ensure that <I>UNIX</I> recognizes your script as a shell script it is a good habit always to start the script with the line #!/bin/sh or #!/bin/csh, depending on the shell you prefer to use. All the examples in this tutorial assumes you are running the Bourne shell, <I>sh</I><A NAME="1811"></A>; if you are using something different then you are on your own. <P> </LI> <LI>Making a script executable is accomplished using the <TT>chmod</TT> command, e.g., the script <U>figure_1.sh</U> is made executable with ``<TT>chmod +x figure_1.sh</TT>''. <P> </LI> <LI>To view a <I>PostScript</I> file (e.g., <U>map.ps</U>) on a UNIX workstation we use <I>ghostview</I><A NAME="1817"></A> <U>map.ps</U>. On some systems there will be similar commands, like <U>imagetool</U> and <U>pageview</U> on Sun workstations. In this text we will refer to <I>ghostview</I><A NAME="1823"></A>; please substitute the relevant <I>PostScript</I> previewer on your system. <P> </LI> <LI>Please cd into the directory <U>tutorial</U>. We are now ready to start. <P> </LI> </OL> <P> <HR> <!--Navigation Panel--> <A NAME="tex2html524" HREF="node10.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html518" HREF="node8.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html512" HREF="node8.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html520" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html522" HREF="node63.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html525" HREF="node10.html">1.2 The GMT environment:</A> <B> Up:</B> <A NAME="tex2html519" HREF="node8.html">1. SESSION ONE</A> <B> Previous:</B> <A NAME="tex2html513" HREF="node8.html">1. SESSION ONE</A> <B> <A NAME="tex2html521" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html523" HREF="node63.html">Index</A></B> <!--End of Navigation Panel--> <ADDRESS> Paul Wessel 2011-02-27 </ADDRESS> </BODY> </HTML>