File: grd2cpt.html

package info (click to toggle)
gmt-doc 3.4-1
  • links: PTS
  • area: main
  • in suites: woody
  • size: 4,756 kB
  • ctags: 1,800
  • sloc: makefile: 30
file content (132 lines) | stat: -rw-r--r-- 3,484 bytes parent folder | download | duplicates (2)
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
<HTML>
<HEAD>
<TITLE>grd2cpt</TITLE>
</HEAD>
<BODY>
<H1>grd2cpt</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
       grd2cpt - Read a grdfile and make a color palette file


</PRE>
<H2>SYNOPSIS</H2><PRE>
       <B>grd2cpt</B>   <I>grdfile</I>   [  <B>-C</B><I>cptmaster</I>  ]  [  <B>-I</B>  ]  [  <B>-L</B><I>min</I>
       <I>limit/maxlimit</I> ] [ <B>-S</B><I>zstart/zstop/zinc</I> ] [ <B>-V</B> ] [ <B>-Z</B> ]


</PRE>
<H2>DESCRIPTION</H2><PRE>
       <B>grd2cpt</B> reads a grdfile and writes a color  palette  (cpt)
       file  to  standard  output.  The  cpt  file is based on an
       existing master cptfile of your choice,  and  the  mapping
       from data value to colors is through the data's cumulative
       distribution function (CDF), so that the colors are'  his
       togram  equalized.  Thus if the resulting cpt file is used
       with the grdfile and grdimage with  a  linear  projection,
       the  colors  will  be uniformly distributed in area on the
       plot. Let z be the data values  in  the  grdfile.   Define
       CDF(Z)  =  (#  of  z &lt; Z) / (# of z in grdfile). (NaNs are
       ignored).  These z-values are then normalized to the  mas
       ter  cptfile  and colors are sampled at the desired inter
       vals.

       <I>grdfile</I>
              The 2-D binary grdfile used  to  derive  the  color
              palette table.


</PRE>
<H2>OPTIONS</H2><PRE>
       <B>-C</B>     Selects the master color table to use in the inter
              polation. Choose among the  built-in  tables  (type
              <B>grd2cpt</B>  to  see  the  list) or give the name of an
              existing  cptfile  [Default  gives  a  rainbow  cpt
              file].

       <B>-I</B>     Reverses the sense of color progression in the mas
              ter cptfile.

       <B>-L</B>     Limit range of cptfile  to  <I>minlimit/maxlimit</I>,  and
              don't  count  data'  outside  range when estimating
              CDF(Z). [Default uses min and max of data.]

       <B>-S</B>     Set steps in cpt file. Calculate entries in cptfile
              from  <I>zstart</I>  to <I>zstop</I> in steps of (<I>zinc</I>). [Default
              chooses arbitrary values by a crazy scheme.] .TP <B>-V</B>
              Verbose operation. This will write CDF(Z) estimates
              to stderr. [Default is silent.]


</PRE>
<H2>EXAMPLES</H2><PRE>
       Sometimes you don't want to make  a  cpt  file  (yet)  but
       would  find  it helpful' to know that 90% of your data lie
       between  z1  and  z2,  something  you  cannot  learn  from
       <B><A HREF="grdinfo.html">grdinfo</A></B>.  So  you  can  do  this to see some points on the
       CDF(Z) curve (use <B>-V</B> option to see more):

       20,  and  ignore  data below zero in computing CDF(Z), and
       use the built-in master cptfile relief, try

       grd2cpt  mydata.grd  <B>-C</B><I>relief</I>   <B>-L</B>0/10000   <B>-S</B>0/200/20   &gt;
       mydata.cpt


</PRE>
<H2>SEE ALSO</H2><PRE>
       <I><A HREF="gmtdefaults.html">gmtdefaults</A></I>(l),    <I>gmt</I>(l),    <I><A HREF="grdhisteq.html">grdhisteq</A></I>(l),    <I><A HREF="grdinfo.html">grdinfo</A></I>(l),
       <I><A HREF="makecpt.html">makecpt</A></I>(l)











































</PRE>
<HR>
<ADDRESS>
Man(1) output converted with
<a href="http://www.oac.uci.edu/indiv/ehood/man2html.html">man2html</a>
</ADDRESS>
</BODY>
</HTML>
<body bgcolor="#ffffff">