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
|
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<!-- Copyright (C) 1996, 1997, 1998, 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013, 2014, 2015, 2016 The GSL Team.
Permission is granted to copy, distribute and/or modify this document
under the terms of the GNU Free Documentation License, Version 1.3 or
any later version published by the Free Software Foundation; with the
Invariant Sections being "GNU General Public License" and "Free Software
Needs Free Documentation", the Front-Cover text being "A GNU Manual",
and with the Back-Cover Text being (a) (see below). A copy of the
license is included in the section entitled "GNU Free Documentation
License".
(a) The Back-Cover Text is: "You have the freedom to copy and modify this
GNU Manual." -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library – Reference Manual: Histograms</title>
<meta name="description" content="GNU Scientific Library – Reference Manual: Histograms">
<meta name="keywords" content="GNU Scientific Library – Reference Manual: Histograms">
<meta name="resource-type" content="document">
<meta name="distribution" content="global">
<meta name="Generator" content="makeinfo">
<meta http-equiv="Content-Type" content="text/html; charset=utf-8">
<link href="index.html#Top" rel="start" title="Top">
<link href="Function-Index.html#Function-Index" rel="index" title="Function Index">
<link href="index.html#Top" rel="up" title="Top">
<link href="The-histogram-struct.html#The-histogram-struct" rel="next" title="The histogram struct">
<link href="Running-Statistics-References-and-Further-Reading.html#Running-Statistics-References-and-Further-Reading" rel="previous" title="Running Statistics References and Further Reading">
<style type="text/css">
<!--
a.summary-letter {text-decoration: none}
blockquote.smallquotation {font-size: smaller}
div.display {margin-left: 3.2em}
div.example {margin-left: 3.2em}
div.indentedblock {margin-left: 3.2em}
div.lisp {margin-left: 3.2em}
div.smalldisplay {margin-left: 3.2em}
div.smallexample {margin-left: 3.2em}
div.smallindentedblock {margin-left: 3.2em; font-size: smaller}
div.smalllisp {margin-left: 3.2em}
kbd {font-style:oblique}
pre.display {font-family: inherit}
pre.format {font-family: inherit}
pre.menu-comment {font-family: serif}
pre.menu-preformatted {font-family: serif}
pre.smalldisplay {font-family: inherit; font-size: smaller}
pre.smallexample {font-size: smaller}
pre.smallformat {font-family: inherit; font-size: smaller}
pre.smalllisp {font-size: smaller}
span.nocodebreak {white-space:nowrap}
span.nolinebreak {white-space:nowrap}
span.roman {font-family:serif; font-weight:normal}
span.sansserif {font-family:sans-serif; font-weight:normal}
ul.no-bullet {list-style: none}
-->
</style>
</head>
<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000">
<a name="Histograms"></a>
<div class="header">
<p>
Next: <a href="N_002dtuples.html#N_002dtuples" accesskey="n" rel="next">N-tuples</a>, Previous: <a href="Running-Statistics.html#Running-Statistics" accesskey="p" rel="previous">Running Statistics</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Histograms-1"></a>
<h2 class="chapter">23 Histograms</h2>
<a name="index-histograms"></a>
<a name="index-binning-data"></a>
<p>This chapter describes functions for creating histograms. Histograms
provide a convenient way of summarizing the distribution of a set of
data. A histogram consists of a set of <em>bins</em> which count the number
of events falling into a given range of a continuous variable <em>x</em>.
In GSL the bins of a histogram contain floating-point numbers, so they
can be used to record both integer and non-integer distributions. The
bins can use arbitrary sets of ranges (uniformly spaced bins are the
default). Both one and two-dimensional histograms are supported.
</p>
<p>Once a histogram has been created it can also be converted into a
probability distribution function. The library provides efficient
routines for selecting random samples from probability distributions.
This can be useful for generating simulations based on real data.
</p>
<p>The functions are declared in the header files <samp>gsl_histogram.h</samp>
and <samp>gsl_histogram2d.h</samp>.
</p>
<table class="menu" border="0" cellspacing="0">
<tr><td align="left" valign="top">• <a href="The-histogram-struct.html#The-histogram-struct" accesskey="1">The histogram struct</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Histogram-allocation.html#Histogram-allocation" accesskey="2">Histogram allocation</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Copying-Histograms.html#Copying-Histograms" accesskey="3">Copying Histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Updating-and-accessing-histogram-elements.html#Updating-and-accessing-histogram-elements" accesskey="4">Updating and accessing histogram elements</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Searching-histogram-ranges.html#Searching-histogram-ranges" accesskey="5">Searching histogram ranges</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Histogram-Statistics.html#Histogram-Statistics" accesskey="6">Histogram Statistics</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Histogram-Operations.html#Histogram-Operations" accesskey="7">Histogram Operations</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Reading-and-writing-histograms.html#Reading-and-writing-histograms" accesskey="8">Reading and writing histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Resampling-from-histograms.html#Resampling-from-histograms" accesskey="9">Resampling from histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-histogram-probability-distribution-struct.html#The-histogram-probability-distribution-struct">The histogram probability distribution struct</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Example-programs-for-histograms.html#Example-programs-for-histograms">Example programs for histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Two-dimensional-histograms.html#Two-dimensional-histograms">Two dimensional histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="The-2D-histogram-struct.html#The-2D-histogram-struct">The 2D histogram struct</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="2D-Histogram-allocation.html#g_t2D-Histogram-allocation">2D Histogram allocation</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Copying-2D-Histograms.html#Copying-2D-Histograms">Copying 2D Histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Updating-and-accessing-2D-histogram-elements.html#Updating-and-accessing-2D-histogram-elements">Updating and accessing 2D histogram elements</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Searching-2D-histogram-ranges.html#Searching-2D-histogram-ranges">Searching 2D histogram ranges</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="2D-Histogram-Statistics.html#g_t2D-Histogram-Statistics">2D Histogram Statistics</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="2D-Histogram-Operations.html#g_t2D-Histogram-Operations">2D Histogram Operations</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Reading-and-writing-2D-histograms.html#Reading-and-writing-2D-histograms">Reading and writing 2D histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Resampling-from-2D-histograms.html#Resampling-from-2D-histograms">Resampling from 2D histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
<tr><td align="left" valign="top">• <a href="Example-programs-for-2D-histograms.html#Example-programs-for-2D-histograms">Example programs for 2D histograms</a>:</td><td> </td><td align="left" valign="top">
</td></tr>
</table>
<hr>
<div class="header">
<p>
Next: <a href="N_002dtuples.html#N_002dtuples" accesskey="n" rel="next">N-tuples</a>, Previous: <a href="Running-Statistics.html#Running-Statistics" accesskey="p" rel="previous">Running Statistics</a>, Up: <a href="index.html#Top" accesskey="u" rel="up">Top</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
