/usr/share/doc/pyxplot/html/sect0099.html is in pyxplot-doc 0.8.4-3.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | <!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml" xml:lang="en" lang="en">
<head>
<meta name="generator" content="plasTeX" />
<meta content="text/html; charset=utf-8" http-equiv="content-type" />
<title>PyXPlot Users' Guide: histogram</title>
<link href="sect0100.html" title="history" rel="next" />
<link href="sect0098.html" title="help" rel="prev" />
<link href="ch-reference.html" title="Command Reference" rel="up" />
<link rel="stylesheet" href="styles/styles.css" />
</head>
<body>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="sect0098.html" title="help"><img alt="Previous: help" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="ch-reference.html" title="Command Reference"><img alt="Up: Command Reference" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0100.html" title="history"><img alt="Next: history" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">PyXPlot Users' Guide</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><a href="sect0255.html" title="Index"><img border="0" alt="" src="icons/index.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<div class="breadcrumbs">
<span>
<span>
<a href="index.html">PyXPlot Users' Guide</a> <b>:</b>
</span>
</span><span>
<span>
<a href="sect0075.html">Reference Manual</a> <b>:</b>
</span>
</span><span>
<span>
<a href="ch-reference.html">Command Reference</a> <b>:</b>
</span>
</span><span>
<span>
<b class="current">histogram</b>
</span>
</span>
<hr />
</div>
<div><h1 id="a0000000100">1.24 histogram</h1>
<p><a name="a0000001038" id="a0000001038"></a> </p><pre>
histogram [<range>] <function name>"()" '<datafile>'
[every <expression> {:<expression>} ]
[index <value>]
[select <expression>]
[using <expression> {:<expression>} ]
( [binwidth <value>] [binorigin <value>] |
[bins (x1, x2, ...)] )
</pre><p>The <tt class="tt">histogram</tt> command<a name="a0000001039" id="a0000001039"></a> takes a single column of data from a file and produces a function that represents the frequency distribution of the supplied data values. The output function consists of a series of discrete intervals which we term <i class="it">bins</i>. Within each interval the output function has a constant value, determined such that the area under each interval – i.e. the integral of the function over each interval – is equal to the number of datapoints found within that interval. The following simple example </p><pre>
histogram f() 'input.dat'
</pre><p>produces a frequency distribution of the data values found in the first column of the file <tt class="tt">input.dat</tt>, which it stores in the function <img src="images/img-0078.png" alt="$f(x)$" style="vertical-align:-4px;
width:32px;
height:18px" class="math gen" />. The value of this function at any given point is equal to the number of items in the bin at that point, divided by the width of the bins used. If the input datapoints are not dimensionless then the output frequency distribution adopts appropriate units, thus a histogram of data with units of length has units of one over length. </p><p>The number and arrangement of bins used by the <tt class="tt">histogram</tt> command<a name="a0000001040" id="a0000001040"></a> can be controlled by means of various modifiers. The <tt class="tt">binwidth</tt><a name="a0000001041" id="a0000001041"></a> modifier sets the width of the bins used. The <tt class="tt">binorigin</tt><a name="a0000001042" id="a0000001042"></a> modifier controls where their boundaries lie; the <tt class="tt">histogram</tt> command<a name="a0000001043" id="a0000001043"></a> selects a system of bins which, if extended to infinity in both directions, would put a bin boundary at the value specified in the <tt class="tt">binorigin</tt> modifier. Thus, if <tt class="tt">binorigin 0.1</tt> were specified, together with a bin width of 20, bin boundaries might lie at <img src="images/img-0261.png" alt="$20.1$" style="vertical-align:0px;
width:30px;
height:12px" class="math gen" />, <img src="images/img-0262.png" alt="$40.1$" style="vertical-align:0px;
width:31px;
height:12px" class="math gen" />, <img src="images/img-0263.png" alt="$60.1$" style="vertical-align:0px;
width:31px;
height:12px" class="math gen" />, and so on. Alternatively global defaults for the bin width and the bin origin can be specified using the <tt class="tt">set binwidth</tt> and <tt class="tt">set binorigin</tt> commands respectively. The example </p><pre>
histogram h() 'input.dat' binorigin 0.5 binwidth 2
</pre><p>would bin data into bins between <img src="images/img-0264.png" alt="$0.5$" style="vertical-align:0px;
width:22px;
height:13px" class="math gen" /> and <img src="images/img-0265.png" alt="$2.5$" style="vertical-align:0px;
width:21px;
height:13px" class="math gen" />, between <img src="images/img-0265.png" alt="$2.5$" style="vertical-align:0px;
width:21px;
height:13px" class="math gen" /> and <img src="images/img-0266.png" alt="$4.5$" style="vertical-align:0px;
width:22px;
height:13px" class="math gen" />, and so forth. </p><p>Alternatively the set of bins to be used can be controlled more precisely using the <tt class="tt">bins</tt><a name="a0000001044" id="a0000001044"></a> modifier, which allows an arbitrary set of bins to be specified. The example </p><pre>
histogram g() 'input.dat' bins (1, 2, 4)
</pre><p>would bin the data into two bins, <img src="images/img-0267.png" alt="$x=1\to 2$" style="vertical-align:-1px;
width:81px;
height:13px" class="math gen" /> and <img src="images/img-0268.png" alt="$x=2\to 4$" style="vertical-align:-1px;
width:81px;
height:13px" class="math gen" />. </p><p>A range can be supplied immediately following the <tt class="tt">histogram</tt> command, using the same syntax as in the <tt class="tt">plot</tt> and <tt class="tt">fit</tt> commands; if such a range is supplied, only points that fall within that range will be binned. In the same way as in the <tt class="tt">plot</tt> command, the <tt class="tt">index</tt><a name="a0000001045" id="a0000001045"></a>, <tt class="tt">every</tt><a name="a0000001046" id="a0000001046"></a>, <tt class="tt">using</tt><a name="a0000001047" id="a0000001047"></a> and <tt class="tt">select</tt><a name="a0000001048" id="a0000001048"></a> modifiers can be used to specify which subsets of a datafile should be used. </p><p>Two points about the <tt class="tt">histogram</tt> command are worthy of note. First, although histograms are similar to bar charts, they are not the same. A bar chart conventionally has the height of each bar equal to the number of points that it represents, whereas a histogram is a continuous function in which the area underneath each interval is equal to the number of points within it. Thus, to produce a bar chart using the <tt class="tt">histogram</tt> command, the end result should be multiplied by the bin width used. </p><p>Second, if the function produced by the <tt class="tt">histogram</tt> command is plotted using the <tt class="tt">plot</tt> command, samples are automatically taken not at evenly spaced intervals along the ordinate axis, but at the centres of each bin. If the <tt class="tt">boxes</tt><a name="a0000001049" id="a0000001049"></a><a name="a0000001050" id="a0000001050"></a> plot style is used, the box boundaries are be conveniently drawn to coincide with the bins into which the data were sorted. </p></div>
<div class="navigation">
<table cellspacing="2" cellpadding="0" width="100%">
<tr>
<td><a href="sect0098.html" title="help"><img alt="Previous: help" border="0" src="icons/previous.gif" width="32" height="32" /></a></td>
<td><a href="ch-reference.html" title="Command Reference"><img alt="Up: Command Reference" border="0" src="icons/up.gif" width="32" height="32" /></a></td>
<td><a href="sect0100.html" title="history"><img alt="Next: history" border="0" src="icons/next.gif" width="32" height="32" /></a></td>
<td class="navtitle" align="center">PyXPlot Users' Guide</td>
<td><a href="index.html" title="Table of Contents"><img border="0" alt="" src="icons/contents.gif" width="32" height="32" /></a></td>
<td><a href="sect0255.html" title="Index"><img border="0" alt="" src="icons/index.gif" width="32" height="32" /></a></td>
<td><img border="0" alt="" src="icons/blank.gif" width="32" height="32" /></td>
</tr>
</table>
</div>
<script language="javascript" src="icons/imgadjust.js" type="text/javascript"></script>
</body>
</html>
|