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
|
<!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 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 no
Invariant Sections and no cover texts. A copy of the license is
included in the section entitled "GNU Free Documentation License". -->
<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ -->
<head>
<title>GNU Scientific Library – Reference Manual: Updating and accessing 2D histogram elements</title>
<meta name="description" content="GNU Scientific Library – Reference Manual: Updating and accessing 2D histogram elements">
<meta name="keywords" content="GNU Scientific Library – Reference Manual: Updating and accessing 2D histogram elements">
<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="Histograms.html#Histograms" rel="up" title="Histograms">
<link href="Searching-2D-histogram-ranges.html#Searching-2D-histogram-ranges" rel="next" title="Searching 2D histogram ranges">
<link href="Copying-2D-Histograms.html#Copying-2D-Histograms" rel="previous" title="Copying 2D Histograms">
<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="Updating-and-accessing-2D-histogram-elements"></a>
<div class="header">
<p>
Next: <a href="Searching-2D-histogram-ranges.html#Searching-2D-histogram-ranges" accesskey="n" rel="next">Searching 2D histogram ranges</a>, Previous: <a href="Copying-2D-Histograms.html#Copying-2D-Histograms" accesskey="p" rel="previous">Copying 2D Histograms</a>, Up: <a href="Histograms.html#Histograms" accesskey="u" rel="up">Histograms</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
<hr>
<a name="Updating-and-accessing-2D-histogram-elements-1"></a>
<h3 class="section">22.16 Updating and accessing 2D histogram elements</h3>
<p>You can access the bins of a two-dimensional histogram either by
specifying a pair of <em>(x,y)</em> coordinates or by using the bin
indices <em>(i,j)</em> directly. The functions for accessing the histogram
through <em>(x,y)</em> coordinates use binary searches in the x and y
directions to identify the bin which covers the appropriate range.
</p>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005fincrement"></a>Function: <em>int</em> <strong>gsl_histogram2d_increment</strong> <em>(gsl_histogram2d * <var>h</var>, double <var>x</var>, double <var>y</var>)</em></dt>
<dd><p>This function updates the histogram <var>h</var> by adding one (1.0) to the
bin whose x and y ranges contain the coordinates (<var>x</var>,<var>y</var>).
</p>
<p>If the point <em>(x,y)</em> lies inside the valid ranges of the
histogram then the function returns zero to indicate success. If
<em>(x,y)</em> lies outside the limits of the histogram then the
function returns <code>GSL_EDOM</code>, and none of the bins are modified. The
error handler is not called, since it is often necessary to compute
histograms for a small range of a larger dataset, ignoring any
coordinates outside the range of interest.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005faccumulate"></a>Function: <em>int</em> <strong>gsl_histogram2d_accumulate</strong> <em>(gsl_histogram2d * <var>h</var>, double <var>x</var>, double <var>y</var>, double <var>weight</var>)</em></dt>
<dd><p>This function is similar to <code>gsl_histogram2d_increment</code> but increases
the value of the appropriate bin in the histogram <var>h</var> by the
floating-point number <var>weight</var>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005fget"></a>Function: <em>double</em> <strong>gsl_histogram2d_get</strong> <em>(const gsl_histogram2d * <var>h</var>, size_t <var>i</var>, size_t <var>j</var>)</em></dt>
<dd><p>This function returns the contents of the (<var>i</var>,<var>j</var>)-th bin of the
histogram <var>h</var>. If (<var>i</var>,<var>j</var>) lies outside the valid range of
indices for the histogram then the error handler is called with an error
code of <code>GSL_EDOM</code> and the function returns 0.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005fget_005fxrange"></a>Function: <em>int</em> <strong>gsl_histogram2d_get_xrange</strong> <em>(const gsl_histogram2d * <var>h</var>, size_t <var>i</var>, double * <var>xlower</var>, double * <var>xupper</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fget_005fyrange"></a>Function: <em>int</em> <strong>gsl_histogram2d_get_yrange</strong> <em>(const gsl_histogram2d * <var>h</var>, size_t <var>j</var>, double * <var>ylower</var>, double * <var>yupper</var>)</em></dt>
<dd><p>These functions find the upper and lower range limits of the <var>i</var>-th
and <var>j</var>-th bins in the x and y directions of the histogram <var>h</var>.
The range limits are stored in <var>xlower</var> and <var>xupper</var> or
<var>ylower</var> and <var>yupper</var>. The lower limits are inclusive
(i.e. events with these coordinates are included in the bin) and the
upper limits are exclusive (i.e. events with the value of the upper
limit are not included and fall in the neighboring higher bin, if it
exists). The functions return 0 to indicate success. If <var>i</var> or
<var>j</var> lies outside the valid range of indices for the histogram then
the error handler is called with an error code of <code>GSL_EDOM</code>.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005fxmax"></a>Function: <em>double</em> <strong>gsl_histogram2d_xmax</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fxmin"></a>Function: <em>double</em> <strong>gsl_histogram2d_xmin</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fnx"></a>Function: <em>size_t</em> <strong>gsl_histogram2d_nx</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fymax"></a>Function: <em>double</em> <strong>gsl_histogram2d_ymax</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fymin"></a>Function: <em>double</em> <strong>gsl_histogram2d_ymin</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dt><a name="index-gsl_005fhistogram2d_005fny"></a>Function: <em>size_t</em> <strong>gsl_histogram2d_ny</strong> <em>(const gsl_histogram2d * <var>h</var>)</em></dt>
<dd><p>These functions return the maximum upper and minimum lower range limits
and the number of bins for the x and y directions of the histogram
<var>h</var>. They provide a way of determining these values without
accessing the <code>gsl_histogram2d</code> struct directly.
</p></dd></dl>
<dl>
<dt><a name="index-gsl_005fhistogram2d_005freset"></a>Function: <em>void</em> <strong>gsl_histogram2d_reset</strong> <em>(gsl_histogram2d * <var>h</var>)</em></dt>
<dd><p>This function resets all the bins of the histogram <var>h</var> to zero.
</p></dd></dl>
<hr>
<div class="header">
<p>
Next: <a href="Searching-2D-histogram-ranges.html#Searching-2D-histogram-ranges" accesskey="n" rel="next">Searching 2D histogram ranges</a>, Previous: <a href="Copying-2D-Histograms.html#Copying-2D-Histograms" accesskey="p" rel="previous">Copying 2D Histograms</a>, Up: <a href="Histograms.html#Histograms" accesskey="u" rel="up">Histograms</a> [<a href="Function-Index.html#Function-Index" title="Index" rel="index">Index</a>]</p>
</div>
</body>
</html>
|
