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
|
<HTML>
<HEAD>
<TITLE>pshistogram</TITLE>
</HEAD>
<BODY>
<H1>pshistogram</H1>
<HR>
<PRE>
<!-- Manpage converted by man2html 3.0.1 -->
pshistogram - Bin data and plot histograms
</PRE>
<H2>SYNOPSIS</H2><PRE>
<B>pshistogram</B> <I>file</I> <B>-Jx</B><I>xscale[/yscale]</I> <B>-W</B><I>bin</I><B>_</B><I>width</I> <B>[</B> <B>-2</B> <B>]</B> <B>[</B>
<B>-A</B> <B>]</B> <B>[</B> <B>-B</B><I>tickinfo</I> <B>]</B> <B>[</B> <B>-C</B> <B>]</B> <B>[</B> <B>-E</B><I>azimuth/elevation</I> <B>]</B> <B>[</B>
<B>-G</B><I>fill</I> <B>]</B> <B>[</B> <B>-H[</B><I>nrec</I><B>]</B> <B>]</B> <B>[</B> <B>-I[o]</B> <B>]</B> <B>[</B> <B>-K</B> <B>]</B> <B>[</B> <B>-L</B><I>pen</I> <B>]</B> <B>[</B> <B>-O</B> <B>]</B> <B>[</B>
<B>-P</B> <B>]</B> <B>[</B> <B>-Q</B> <B>]</B> <B>[</B> <B>-R</B><I>west/east/south/north</I><B>[r]</B> <B>]</B> <B>[</B> <B>-S</B> <B>]</B> <B>[</B>
<B>-U[</B><I>/dx/dy/</I><B>][</B><I>label</I><B>]</B> <B>]</B> <B>[</B> <B>-V</B> <B>]</B> <B>[</B> <B>-X</B><I>x-shift</I> <B>]</B> <B>[</B> <B>-Y</B><I>y-shift</I> <B>]</B> <B>[</B>
<B>-Z</B><I>type</I> <B>]</B> <B>[</B> <B>-c</B><I>copies</I> <B>]</B> <B>[</B> <B>-bi[s][</B><I>n</I><B>]</B> <B>]</B>
</PRE>
<H2>DESCRIPTION</H2><PRE>
<B>pshistogram</B> reads the first column from <I>file</I> [or standard
input] and calculates histogram parameters based on the
bin-width provided. Using these parameters, scaling, and
optional range parameters it will generate <I>PostScript</I> code
that plots a histogram. A cumulative histogram may also
be specified.
<I>file</I> ASCII [or binary, see <B>-b</B>] datafile. If no file is
given, pshistogram will read standard input.
<B>-Jx</B> <I>xscale[/yscale]</I> (Linear scale(s) in distance
unit/data unit).
<B>-W</B> Sets the bin width used for histogram calculations.
</PRE>
<H2>OPTIONS</H2><PRE>
No space between the option flag and the associated argu
ments.
<B>-B</B> Sets map boundary tickmark intervals. See <B><A HREF="psbasemap.html">psbasemap</A></B>
for details.
<B>-2</B> Read second rather than first column.
<B>-A</B> Plot the histogram horizontally from x = 0 [Default
is vertically from y = 0].
<B>-C</B> Center bin on each value. [Default is left edge].
<B>-E</B> Sets the viewpoint's azimuth and elevation (for
perspective view) [180/90]'
<B>-G</B> Select filling of bars. [Default is no fill].
Specify the shade (0-255) or color (r/g/b), or
<B>-Gp</B><I>dpi/pattern</I>, where <I>pattern</I> gives the number of
the built-in pattern (1-90) OR the name of a Sun
1-, 8-, or 24-bit raster file. <I>dpi</I> sets the reso
lution of the image. For 1-bit rasters: use <B>-GP</B> for
inverse video, or append <B>:F</B><I>r/g/b</I>[<B>B</B>[<I>r/g/b</I>]] to spec
ify fore- and background colors (use <I>r/g/b</I> = - for
transparency). See <B><A HREF="GMT.html">GMT</A></B> Cookbook & Technical Refer
<B>-H</B> Input file(s) has Header record(s). Number of
header records can be changed by editing your .gmt
defaults file. If used, <B><A HREF="GMT.html">GMT</A></B> default is 1 header
record.
<B>-I</B> Inquire about min/max x and y after binning. No
plotting is done. Append <B>o</B> to output an ASCII table
of the resulting x,y data.
<B>-K</B> More <I>PostScript</I> code will be appended later
[Default terminates the plot system].
<B>-L</B> Draw bar outline using the specified pen thickness.
[Default is no outline].
<B>-O</B> Selects Overlay plot mode [Default initializes a
new plot system].
<B>-P</B> Selects Portrait plotting mode [<B><A HREF="GMT.html">GMT</A></B> Default is
Landscape, see gmtdefaults to change this].
<B>-Q</B> Draw a cumulative histogram.
<B>-R</B> <I>west,</I> <I>east,</I> <I>south,</I> and <I>north</I> specify the Region of
interest. To specify boundaries in degrees and min
utes [and seconds], use the dd:mm[:ss] format.
Append <B>r</B> if lower left and upper right map coordi
nates are given instead of wesn. If not given,
<B>pshistogram</B> will automatically find reasonable val
ues for the region.
<B>-S</B> Draws a stairs-step diagram instead of histogram.
<B>-U</B> Draw Unix System time stamp on plot. User may spec
ify where the lower left corner of the stamp should
fall on the page relative to lower left corner of
plot. Optionally, append a label, or <B>c</B> (which will
plot the command string.). The GMT parameters
UNIX_TIME and UNIX_TIME_POS can affect the appear
ance; see the <B><A HREF="gmtdefaults.html">gmtdefaults</A></B> man page for details.
<B>-V</B> Selects verbose mode, which will send progress
reports to stderr [Default runs "silently"].
<B>-X</B> <B>-Y</B> Shift origin of plot by (<I>x-shift,y-shift</I>). Prepend
<B>a</B> for absolute coordinates; the default (<B>r</B>) will
reset plot origin.
<B>-Z</B> Choose between 6 types of histograms: 0 = counts
[Default], 1 = frequency_percent, 2 = log (1.0 +
count), 3 = log (1.0 + frequency_percent), 4 =
<B>-c</B> Specifies the number of plot copies. [Default is 1]
<B>-bi</B> Selects binary input. Append <B>s</B> for single precision
[Default is double]. Append <I>n</I> for the number of
columns in the binary file(s). [Default is 2 input
columns].
</PRE>
<H2>EXAMPLES</H2><PRE>
To draw a histogram of the data v3206.t containing
seafloor depths, using a 250 meter bin width, center bars,
and draw bar outline, try:
pshistogram v3206.t <B>-JX</B>h <B>-W</B>250 <B>-C</B> <B>-L</B>0.5<B>p</B> <B>-V</B> > plot.ps
If you know the distribution of your data, you may explic
itly specify range and scales. E.g., to plot a histogram
of the y-values (2nd column) in the file errors.xy using a
1 meter bin width, plot from -10 to +10 meters @ 0.75
cm/m, annotate every 2 m and 100 counts, and use black
bars, try:
cut -f2 errors.xy | pshistogram <B>-W</B>1 <B>-R</B>-10/10/0/0
<B>-Jx</B>0.75<B>c</B>/0.01<B>c</B> <B>-B</B>2:Error:/100:Counts: <B>-G</B>0 <B>-V</B> > plot.ps
Since no y-range was specified, pshistogram will calculate
ymax in even increments of 100.
</PRE>
<H2>SEE ALSO</H2><PRE>
<I>gmt</I>(l), <I><A HREF="psbasemap.html">psbasemap</A></I>(l), <I><A HREF="psrose.html">psrose</A></I>(l), <I><A HREF="psxy.html">psxy</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">
|
