<!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>4.20 GMT environment parameters</TITLE> <META NAME="description" CONTENT="4.20 GMT environment parameters"> <META NAME="keywords" CONTENT="GMT_Docs"> <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_Docs.css"> <LINK REL="previous" HREF="node74.html"> <LINK REL="up" HREF="node31.html"> <LINK REL="next" HREF="node76.html"> </HEAD> <BODY bgcolor="#ffffff"> <!--Navigation Panel--> <A NAME="tex2html3608" HREF="node76.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html3602" HREF="node31.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html3598" HREF="node74.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html3604" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html3606" HREF="node256.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html3609" HREF="node76.html">5. GMT Coordinate Transformations</A> <B> Up:</B> <A NAME="tex2html3603" HREF="node31.html">4. General features</A> <B> Previous:</B> <A NAME="tex2html3599" HREF="node74.html">4.19 The NaN data</A> <B> <A NAME="tex2html3605" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html3607" HREF="node256.html">Index</A></B> <BR> <BR> <!--End of Navigation Panel--> <H1><A NAME="SECTION0012200000000000000000"></A> <A NAME="18615"></A> <BR> 4.20 <A NAME="tex2html1233" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> environment parameters </H1> <P> <A NAME="tex2html1234" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> relies on several environment parameters, in particular to find data files and program settings. <DL> <DT><STRONG>$GMT_SHAREDIR</STRONG></DT> <DD>points to the <A NAME="tex2html1235" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> share directory where all run-time support files such as coastlines, custom symbols, <I>PostScript</I> macros, color tables, and much more reside. If this parameter is not set it defaults to the share sub-directory selected during the <A NAME="tex2html1236" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> install process (e.g., your answer to question C.9 on the web install form). If no selection was made the ultimate default is the share directory under the <A NAME="tex2html1237" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> installation directory. </DD> <DT><STRONG>$GMT_DATADIR</STRONG></DT> <DD>points to one or more directory where large and/or widely used data files can be placed. All <A NAME="tex2html1238" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> programs look in this directories when a file is specified on the command line and it is not present in the current directory. This allows maintainers to consolidate large data files and to simplify scripting that use these files since the absolute path need not be specified. Separate multiple directories with colons; under Windows you use semi-colons. </DD> <DT><STRONG>$GMT_USERDIR</STRONG></DT> <DD>points to a directory where the user may place custom configuration files (e.g., an alternate <U>coastline.conf</U> file, preferred default settings in <U>.gmtdefaults4</U>, custom symbols and color palettes, and shorthands for gridfile extensions via <U>.gmt_io</U>). Users may also place their own data files in this directory as <A NAME="tex2html1239" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> programs will search for files given on the command line in both <B>$GMT_DATADIR</B> and <B>$GMT_USERDIR</B>. </DD> <DT><STRONG>$GMT_TMPDIR</STRONG></DT> <DD>is where <A NAME="tex2html1240" HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> will write its state parameters via the three files <U>.gmtcommands4</U>, <U>.gmtdefaults4</U> and <U>.gmt_bb_info</U>. If not set then these files are written to the current directory. See Appendix <A HREF="node253.html#app:P">P</A> for more on the use of <B>$GMT_TMPDIR</B>. </DD> </DL> <P> <HR> <!--Navigation Panel--> <A NAME="tex2html3608" HREF="node76.html"> <IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> <A NAME="tex2html3602" HREF="node31.html"> <IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> <A NAME="tex2html3598" HREF="node74.html"> <IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> <A NAME="tex2html3604" HREF="node1.html"> <IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> <A NAME="tex2html3606" HREF="node256.html"> <IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> <BR> <B> Next:</B> <A NAME="tex2html3609" HREF="node76.html">5. GMT Coordinate Transformations</A> <B> Up:</B> <A NAME="tex2html3603" HREF="node31.html">4. General features</A> <B> Previous:</B> <A NAME="tex2html3599" HREF="node74.html">4.19 The NaN data</A> <B> <A NAME="tex2html3605" HREF="node1.html">Contents</A></B> <B> <A NAME="tex2html3607" HREF="node256.html">Index</A></B> <!--End of Navigation Panel--> <ADDRESS> Paul Wessel 2010-07-14 </ADDRESS> </BODY> </HTML>