Sophie

Sophie

distrib > Fedora > 13 > i386 > by-pkgid > 5764c67416561ab82b35afcf9c650e17 > files > 740

GMT-doc-4.5.2-1.fc13.noarch.rpm

<!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.15.1 Categorical CPT files</TITLE>
<META NAME="description" CONTENT="4.15.1 Categorical CPT files">
<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="next" HREF="node69.html">
<LINK REL="previous" HREF="node67.html">
<LINK REL="up" HREF="node67.html">
<LINK REL="next" HREF="node69.html">
</HEAD>

<BODY  bgcolor="#ffffff">
<!--Navigation Panel-->
<A NAME="tex2html3480"
  HREF="node69.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html3474"
  HREF="node67.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html3468"
  HREF="node67.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html3476"
  HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
<A NAME="tex2html3478"
  HREF="node255.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
<BR>
<B> Next:</B> <A NAME="tex2html3481"
  HREF="node69.html">4.15.2 Regular CPT files</A>
<B> Up:</B> <A NAME="tex2html3475"
  HREF="node67.html">4.15 Color palette tables</A>
<B> Previous:</B> <A NAME="tex2html3469"
  HREF="node67.html">4.15 Color palette tables</A>
 &nbsp; <B>  <A NAME="tex2html3477"
  HREF="node1.html">Contents</A></B> 
 &nbsp; <B>  <A NAME="tex2html3479"
  HREF="node255.html">Index</A></B> 
<BR>
<BR>
<!--End of Navigation Panel-->

<H2><A NAME="SECTION0012151000000000000000">
4.15.1 Categorical CPT files</A>
</H2>

<P>
Note: This is an experimental component and is only available if you compile <A NAME="tex2html1151"
  HREF="http://gmt.soest.hawaii.edu"><B>GMT</B></A> with <B>-DGMT_CPT2</B>.
Categorical data are information on which normal numerical operations are not
defined. As an example, consider various land classifications (desert, forest, glacier, etc.)
and it is clear that even if we assigned a numerical value to these categories (e.g.,
desert = 1, forest = 2, etc) it would be meaningless to compute average values (what would
1.5 mean?).  For such data a special format of the CPT files are provided.  Here,
each category is assigned a unique key, a color or pattern, and an optional
label (usually the category name).  Keys must be monotonically increasing but do not
need to be consecutive.  The format is

<P>
<DIV ALIGN="CENTER">
<TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT">key<IMG
 WIDTH="11" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img27.png"
 ALT="$_1$"></TD>
<TD ALIGN="LEFT"><I>fill</I></TD>
<TD ALIGN="LEFT"><I>label</I></TD>
</TR>
<TR><TD ALIGN="LEFT">...</TD>
<TD ALIGN="LEFT">&nbsp;</TD>
<TD ALIGN="LEFT">&nbsp;</TD>
</TR>
<TR><TD ALIGN="LEFT">key<IMG
 WIDTH="11" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img65.png"
 ALT="$_n$"></TD>
<TD ALIGN="LEFT"><I>fill</I></TD>
<TD ALIGN="LEFT"><I>label</I></TD>
</TR>
</TABLE>
</DIV>

<P>
The <I>fill</I> information follows the format given in Section <A HREF="node66.html#sec:fill">4.14</A>.
While not always applicable to categorical data, the background color (for
<I>key</I>-values <IMG
 WIDTH="16" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img13.png"
 ALT="$&lt;$"> <I>key<IMG
 WIDTH="11" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img27.png"
 ALT="$_1$"></I>), foreground color
(for <I>key</I>-values <IMG
 WIDTH="16" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img11.png"
 ALT="$&gt;$"> <I>key<IMG
 WIDTH="11" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img66.png"
 ALT="$_{n}$"></I>), and not-a-number (NaN) color (for
<I>key</I>-values = NaN) are all defined in the <U>.gmtdefaults4</U>
file, but can be overridden by the statements

<P>
<DIV ALIGN="CENTER">
<TABLE CELLPADDING=3>
<TR><TD ALIGN="LEFT">B</TD>
<TD ALIGN="LEFT">R<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img67.png"
 ALT="$_{back}$"></TD>
<TD ALIGN="LEFT">G<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img67.png"
 ALT="$_{back}$"></TD>
<TD ALIGN="LEFT">B<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img67.png"
 ALT="$_{back}$"></TD>
</TR>
<TR><TD ALIGN="LEFT">F</TD>
<TD ALIGN="LEFT">R<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img68.png"
 ALT="$_{fore}$"></TD>
<TD ALIGN="LEFT">G<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img68.png"
 ALT="$_{fore}$"></TD>
<TD ALIGN="LEFT">B<IMG
 WIDTH="27" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img68.png"
 ALT="$_{fore}$"></TD>
</TR>
<TR><TD ALIGN="LEFT">N</TD>
<TD ALIGN="LEFT">R<IMG
 WIDTH="23" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img69.png"
 ALT="$_{nan}$"></TD>
<TD ALIGN="LEFT">G<IMG
 WIDTH="23" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img69.png"
 ALT="$_{nan}$"></TD>
<TD ALIGN="LEFT">B<IMG
 WIDTH="23" HEIGHT="29" ALIGN="MIDDLE" BORDER="0"
 SRC="img69.png"
 ALT="$_{nan}$"></TD>
</TR>
</TABLE>
</DIV>

<P>
<HR>
<!--Navigation Panel-->
<A NAME="tex2html3480"
  HREF="node69.html">
<IMG WIDTH="37" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="next" SRC="next.png"></A> 
<A NAME="tex2html3474"
  HREF="node67.html">
<IMG WIDTH="26" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="up" SRC="up.png"></A> 
<A NAME="tex2html3468"
  HREF="node67.html">
<IMG WIDTH="63" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="previous" SRC="prev.png"></A> 
<A NAME="tex2html3476"
  HREF="node1.html">
<IMG WIDTH="65" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="contents" SRC="contents.png"></A> 
<A NAME="tex2html3478"
  HREF="node255.html">
<IMG WIDTH="43" HEIGHT="24" ALIGN="BOTTOM" BORDER="0" ALT="index" SRC="index.png"></A> 
<BR>
<B> Next:</B> <A NAME="tex2html3481"
  HREF="node69.html">4.15.2 Regular CPT files</A>
<B> Up:</B> <A NAME="tex2html3475"
  HREF="node67.html">4.15 Color palette tables</A>
<B> Previous:</B> <A NAME="tex2html3469"
  HREF="node67.html">4.15 Color palette tables</A>
 &nbsp; <B>  <A NAME="tex2html3477"
  HREF="node1.html">Contents</A></B> 
 &nbsp; <B>  <A NAME="tex2html3479"
  HREF="node255.html">Index</A></B> 
<!--End of Navigation Panel-->
<ADDRESS>
Paul Wessel
2010-01-14
</ADDRESS>
</BODY>
</HTML>