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
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<!--NewPage-->
<HTML>
<HEAD>
<!-- Generated by javadoc (build 1.4.2_05) on Thu Sep 09 20:36:07 PDT 2004 -->
<TITLE>
hep.aida (Colt 1.2.0 - API Specification)
</TITLE>
<META NAME="keywords" CONTENT="hep.aida package">
<LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
<SCRIPT type="text/javascript">
function windowTitle()
{
parent.document.title="hep.aida (Colt 1.2.0 - API Specification)";
}
</SCRIPT>
</HEAD>
<BODY BGCOLOR="white" onload="windowTitle();">
<!-- ========= START OF TOP NAVBAR ======= -->
<A NAME="navbar_top"><!-- --></A>
<A HREF="#skip-navbar_top" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_top_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Colt 1.2.0</b></EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../corejava/package-summary.html"><B>PREV PACKAGE</B></A>
<A HREF="../../hep/aida/bin/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../index.html" target="_top"><B>FRAMES</B></A>
<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_top"></A>
<!-- ========= END OF TOP NAVBAR ========= -->
<HR>
<H2>
Package hep.aida
</H2>
Interfaces for compact, extensible, modular and performant histogramming functionality.
<P>
<B>See:</B>
<BR>
<A HREF="#package_description"><B>Description</B></A>
<P>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
<B>Interface Summary</B></FONT></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../hep/aida/IAxis.html" title="interface in hep.aida">IAxis</A></B></TD>
<TD>An IAxis represents a binned histogram axis.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../hep/aida/IHistogram.html" title="interface in hep.aida">IHistogram</A></B></TD>
<TD>A common base interface for IHistogram1D, IHistogram2D and IHistogram3D.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../hep/aida/IHistogram1D.html" title="interface in hep.aida">IHistogram1D</A></B></TD>
<TD>A Java interface corresponding to the AIDA 1D Histogram.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../hep/aida/IHistogram2D.html" title="interface in hep.aida">IHistogram2D</A></B></TD>
<TD>A Java interface corresponding to the AIDA 2D Histogram.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD WIDTH="15%"><B><A HREF="../../hep/aida/IHistogram3D.html" title="interface in hep.aida">IHistogram3D</A></B></TD>
<TD>A Java interface corresponding to the AIDA 3D Histogram.</TD>
</TR>
</TABLE>
<P>
<A NAME="package_description"><!-- --></A><H2>
Package hep.aida Description
</H2>
<P>
<P>Interfaces for compact, extensible, modular and performant histogramming functionality.
</P>
<h1><a name="Overview"></a>Getting Started</h1>
<h2>1. Overview</h2>
Aida itself offers the histogramming features of HTL and HBOOK, the <em>de-facto</em>
standard for histogramming for many years. It also offers a number of useful extensions,
with an object-oriented approach. These features include the following:
<p></p>
<ul>
<li>creating and filling of 1D, 2D (and profile histograms, in the future)</li>
<li>computation of statistics such as the mean, rms, etc. of a histogram</li>
<li>support for operations between histograms (in the future)</li>
<li>browsing of and access to characteristics of individual histograms</li>
</ul>
<p> File-based I/O can be achieved through the standard Java built-in serialization
mechanism. All classes implement the <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html" title="class or interface in java.io"><CODE>Serializable</CODE></A> interface.
However, the toolkit is entirely decoupled from advanced I/O and visualisation
techniques. It provides data structures and algorithms only.
<p> This toolkit borrows many concepts from HBOOK and the CERN <a href="http://wwwinfo.cern.ch/asd/lhc++/HTL">
HTL</a> package (C++) largely written by Savrak Sar.
<p> The definition of an abstract histogram interface allows functionality that
is provided by external packages, such as plotting or fitting, to be decoupled
from the actual implementation of the histogram. This feature paves the way
for co-existence of different histogram packages that conform to the abstract
interface. </p>
<p>A reference implementation of the interfaces is provided by package <A HREF="../../hep/aida/ref/package-summary.html"><CODE>hep.aida.ref</CODE></A>. </p>
<h2>2. AIDA at a glance</h2>
<h3>Fixed-width histogram</h3>
<p>The following code snippet demonstrates example usage: </p>
<h4>
<table>
<td class="PRE">
<pre>
IHistogram1D h1 = new Histogram1D("my histo 1",10, -2, +2); // 10 bins, min=-2, max=2<br> IHistogram2D h2 = new Histogram2D("my histo 2",10, -2, +2, 5, -2, +2);
IHistogram2D h3 = new Histogram3D("my histo 3",10, -2, +2, 5, -2, +2, 3, -2, +2);
// equivalent
// IHistogram1D h1 = new Histogram1D("my histo 1",new FixedAxis(10, -2, +2)); <br> // IHistogram2D h2 = new Histogram2D("my histo 2",new FixedAxis(10, -2, +2),new FixedAxis(5, -2, +2));<br><br> // your favourite distribution goes here
cern.jet.random.AbstractDistribution gauss = new cern.jet.random.Normal(0,1,new cern.jet.random.engine.MersenneTwister());
<br> for (int i=0; i < 10000; i++) { <br> h1.<A HREF="../../hep/aida/IHistogram1D.html#fill(double)"><CODE>fill</CODE></A>(gauss.nextDouble());
h2.<A HREF="../../hep/aida/IHistogram2D.html#fill(double, double)"><CODE>fill</CODE></A>(gauss.nextDouble(),gauss.nextDouble());
h3.<A HREF="../../hep/aida/IHistogram3D.html#fill(double, double, double)"><CODE>fill</CODE></A>(gauss.nextDouble(),gauss.nextDouble(),gauss.nextDouble());
}
System.out.println(h1);
System.out.println(h2);
System.out.println(h3);
rms=h1.rms();
sum=h1.sumBinHeights();
...</pre>
</td>
</table>
</h4>
<h3>Variable-width histogram</h3>
<p>The following code snippet demonstrates example usage: </p>
<h4>
<table>
<td class="PRE">
<pre>
double[] xedges = { -5, -1, 0, 1, 5 };
double[] yedges = { -5, -1, 0.2, 0, 0.2, 1, 5 };
double[] zedges = { -5, 0, 7 };
IHistogram1D h1 = new Histogram1D("my histo 1",xedges); //<br> IHistogram2D h2 = new Histogram2D("my histo 2",xedges,yedges);
IHistogram2D h3 = new Histogram3D("my histo 3",xedges,yedges,zedges);
// equivalent
// IHistogram1D h1 = new Histogram1D("my histo 1",new VariableAxis(xedges)); <br> // IHistogram2D h2 = new Histogram2D("my histo 2",new VariableAxis(xedges),new VariableAxis(yedges));<br><br> // your favourite distribution goes here
cern.jet.random.AbstractDistribution gauss = new cern.jet.random.Normal(0,1,new cern.jet.random.engine.MersenneTwister());
<br> for (int i=0; i < 10000; i++) { <br> h1.<A HREF="../../hep/aida/IHistogram1D.html#fill(double)"><CODE>fill</CODE></A>(gauss.nextDouble());
h2.<A HREF="../../hep/aida/IHistogram2D.html#fill(double, double)"><CODE>fill</CODE></A>(gauss.nextDouble(),gauss.nextDouble());
h3.<A HREF="../../hep/aida/IHistogram3D.html#fill(double, double, double)"><CODE>fill</CODE></A>(gauss.nextDouble(),gauss.nextDouble(),gauss.nextDouble());
}
System.out.println(h1);
System.out.println(h2);
System.out.println(h3);
rms=h1.rms();
sum=h1.sumBinHeights();
...</pre>
</td>
</table>
</h4>
<p>Here are some example histograms, as rendered by <a href="http://www-sldnt.slac.stanford.edu/jasweb/">Java
Analysis Studio</a>. </p>
<table width="75%" border="0">
<tr>
<td valign="bottom"><img
src="ref/doc-files/aida1.gif" width="322" height="230"></td>
<td valign="bottom"><img
src="ref/doc-files/aida2.gif" width="316" height="270"></td>
</tr>
</table>
<p>And here is an example output of <A HREF="../../hep/aida/ref/Converter.html#toString(hep.aida.IHistogram2D)"><CODE>toString(IHistogram2D)</CODE></A>.
</p>
<blockquote style="MARGIN-RIGHT: 0px">
<table>
<td class="PRE">
<pre>
my histo 2:
Entries=5000, ExtraEntries=0
MeanX=4.9838, RmsX=NaN
MeanY=2.5304, RmsY=NaN
xAxis: Bins=11, Min=0, Max=11<br> yAxis: Bins=6, Min=0, Max=6
Heights:
| X
| 0 1 2 3 4 5 6 7 8 9 10 | Sum
----------------------------------------------------------
Y 5 | 30 53 51 52 57 39 65 61 55 49 22 | 534
4 | 43 106 112 96 92 94 107 98 98 110 47 | 1003
3 | 39 134 87 93 102 103 110 90 114 98 51 | 1021
2 | 44 81 113 96 101 86 109 83 111 93 42 | 959
1 | 54 94 103 99 115 92 98 97 103 90 44 | 989
0 | 24 54 52 44 42 56 46 47 56 53 20 | 494
----------------------------------------------------------
Sum | 234 522 518 480 509 470 535 476 537 493 226 |
</pre>
</td>
</table>
</blockquote>
<p>And <a href="doc-files/hist3d.txt">here</a> is a sample 3d histogram output.</p>
<h2>3. Histograms</h2>
<h3>3.1 Axes</h3>
<p>An <i>axis</i> (<A HREF="../../hep/aida/IAxis.html" title="interface in hep.aida"><CODE>IAxis</CODE></A>) describes how one dimension of the problem
space is divided into intervals. Consider the case of a 10 bin histogram in
the range <tt>[0,100]</tt>. An axis object containing the number of bins
and the interval limits will describe completely how we divide such an interval:
a set of 10 sub-intervals of equal width. This is termed a <A HREF="../../hep/aida/ref/FixedAxis.html" title="class in hep.aida.ref"><CODE>FixedAxis</CODE></A>
and can be constructed as follows </p>
<table>
<td class="PRE">
<pre>
IAxis axis = new FixedAxis(10, 0.0, 100.0);
</pre>
</td>
</table>
It may be required to work with an histogram over the same range as the example
above, but with bins of variable widths. In this case, an axis containing the
bin edges will describe completely how the interval <tt>[0,100]</tt> is divided.
Such an axis is termed a <A HREF="../../hep/aida/ref/VariableAxis.html" title="class in hep.aida.ref"><CODE>VariableAxis</CODE></A> and can be constructed
as follows
<table>
<td class="PRE">
<pre>
double[] edges = { 0.0, 10.0, 40.0, 49.0, 50.0, 51.0, 60.0, 100.0 };
IAxis axis = new VariableAxis(edges);
</pre>
</td>
</table>
An <tt>n</tt>-dimensional histogram thus contains <tt>n</tt> axes, one for each
dimension. The only concern of an axis is to associate any ordered 1D space with
a discrete numbered space. Thus it associates an interval to an integer. Hence,
an axis knows about the width of the intervals and their lower point/bound or
upper point/bound. An axis can be asked for such information as follows:
<table>
<td class="PRE">
<pre>
IAxis axis = new FixedAxis(2, 0.0, 20.0); // 2 bins, min=0, max=20<br>...
axis.<A HREF="../../hep/aida/IAxis.html#bins()"><CODE>bins()</CODE></A>; // Number of in-range bins (excluding underflow and overflow bins)
axis.<A HREF="../../hep/aida/IAxis.html#binLowerEdge(int)"><CODE>binLowerEdge(i)</CODE></A>; // and the lower edge of bin i
axis.<A HREF="../../hep/aida/IAxis.html#binWidth(int)"><CODE>binWidth(i)</CODE></A>; // and its width
axis.<A HREF="../../hep/aida/IAxis.html#binUpperEdge(int)"><CODE>binUpperEdge(i)</CODE></A>; // and its upper edge
double point = 1.23;
int binIndex = axis.<CODE>coordToIndex(point)</CODE>; // Obtain index of bin the point falls into (maps to)
</pre>
</td>
</table>
<p> In this package, a histogram delegates to its axes the task of locating a
bin. In other words, information about the lower and upper edges of a bin or
the width of a given bin are obtained from the corresponding axis. This is shown
in the following code fragment, which demonstrates how the lower and upper edges
and width of a given bin can be obtained.
<table>
<tr>
<td class="PRE">
<pre>
IHistogram1D histo = new Histogram1D("Histo1D", 10, 0.0, 100.0 );
...
histo.<A HREF="../../hep/aida/IHistogram1D.html#xAxis()"><CODE>xAxis()</CODE></A>.bins() // Obtain the number of bins (excluding underflow and overflow bins)
histo.xAxis().binLowerEdge(i) // and the lower edge of bin i
histo.xAxis().binWidth(i) // and its width
histo.xAxis().binUpperEdge(i) // and its upper edge
</pre>
</td>
</tr>
</table>
<p>An axis always sucessfully maps any arbitrary point drawn from the universe
<tt>[-infinity,+infinity]</tt> to a bin index, because it implicitly defines
an additional <i>underflow</i> and <i>overflow</i> bin, both together called
<i>extra bins</i>. </p>
<table>
<td class="LISTING">
<pre>
IHistogram2D h = new Histogram2D(new FixedAxis(2, 0.0, 100.0), new FixedAxis(2, 0.0, 100.0), ...);
y ^ i ... in-range bin, e .. extra bins
|
+inf |
| e | e | e | e
100 - ---------------
| e | i | i | e --> in-range == [0,100]<sup>2</sup>
| --------------- --> universe == [-infinity,+infinity]<sup>2</sup>
| e | i | i | e --> extra bins == universe - inrange
0 - ---------------
| e | e | e | e
-inf|
-----|-------|------> x
-inf 0 100 +inf
</pre>
</td>
</table>
<p>For example if an axis is defined to be <tt>new FixedAxis(2, 0.0, 20.0)</tt>,
it has 2 in-range bins plus one for underflow and one for overflow. <tt>axis.bins()==2</tt>.
Its boundaries are <tt>[Double.NEGATIVE_INFINITY,0.0), [0.0, 10.0), [10.0, 20.0),
[20.0, Double.POSITIVE_INFINITY]</tt>. As a consequence point -5.0 maps to bin
index <tt>IHistogram.UNDERFLOW</tt>, point 5.0 maps to bin index 0, 15.0 maps
to bin index 1 and 25.0 maps to bin index <tt>IHistogram.OVERFLOW</tt>. </p>
<p> As a further example, consider the following case: <tt>new VariableAxis(new
double[] { 10.0, 20.0 })</tt>. The axis has 1 in-range bin: <tt>axis.bins()==1</tt>.
Its boundaries are <tt>[Double.NEGATIVE_INFINITY,10.0), [10.0, 20.0), [20.0,
Double.POSITIVE_INFINITY]</tt>. Point 5.0 maps to bin index <tt>IHistogram.UNDERFLOW</tt>,
point 15.0 maps to bin index 0 and 25.0 maps to bin index <tt>IHistogram.OVERFLOW</tt>.
<p> As can be seen, underflow bins always have an index of <tt>IHistogram.UNDERFLOW</tt>,
whereas overflow outlier bins always have an index of <tt>IHistogram.OVERFLOW</tt>.
<h3>3.2 Bins</h3>
<p> Bins themselves contain information about the data filled into them. They
can be asked for various descriptive statistical measures, such as the minimum,
maximum, size, mean, rms, variance, etc.
<p> Note that bins (of any kind) only know about their contents. They do not know
where they are are located in the histogram to which they belong, nor about
their widths or bounds - this information is stored in the axis to which they
belong, which also defines the bin layout within a histogram.
<h2>4. Advanced Histogramming</h2>
TODO.
<h1><a name="Comparison"></a>Comparison with the old AIDA interfaces</h1>
<h2></h2>
<P>A proposed simpler alternative to the current hep.aida.flat classes.</P>
<P>The classes in this directory have been proposed by Mark Donselmann, Wolfgang
Hoschek and Tony Johnson as a simpler, easier to use alternative to the classes
orignally proposed as the AIDA standard. </P>
<P>Our goals were:</P>
<OL>
<LI>Eliminate methods that are primarily for developers
writing display packages, they should not be complicating the public user
interfaces.
<LI>Reduce unnecessary duplication which makes the
interfaces very long without adding any additional functionality or
ease-of-use
<LI> Eliminate methods that are hard to use (we
could not think of any occasion where the 8 separate methods for getting the 2D
overflows bins would be convenient for anyone).</LI></OL>
Note that
ease of implementation was <STRONG>NOT </STRONG>a primary goal.
Following these goals we were able to reduce the number of methods as
follows:
<TABLE border=1 cellPadding=1 cellSpacing=1>
<TR>
<TD>OLD</TD>
<TD># methods</TD>
<TD>NEW</TD>
<TD>#methods</TD></TR>
<TR>
<TD>IHistogram1D</TD>
<TD>45</TD>
<TD>IHistogram</TD>
<TD>
<DIV><FONT face=Arial size=2>9</FONT></DIV></TD></TR>
<TR>
<TD>IHistogram2D</TD>
<TD>89</TD>
<TD>IHistogram1D</TD>
<TD>9 (+ inherited from IHistogram)</TD></TR>
<TR>
<TD></TD>
<TD></TD>
<TD>IHistogram2D</TD>
<TD>23(+9 inherited from IHistogram)</TD></TR>
<TR>
<TD></TD>
<TD></TD>
<TD>Axis</TD>
<TD>8</TD></TR></TABLE>
<DIV></DIV>The primary differences between the old classes and the new classes
are:
<OL>
<LI>Introduction of an IAxis class, to describe the X
axis for 1D histograms, and the X and Y axes of 2D histograms. We understand
that the desire is to keep the interfaces as flat as possible, but feel this
introduces a significant improvement in terms of reducing complexity, and is
an abstraction that is easy for even the most object-phobic physicist to
grasp.
<LI>We define constants OVERFLOW and UNDERFLOW to
represent the underflow and overflow bins on an axis. This eliminates the need
for special routines that deal with overflows/underflows. It also improves the
interface since it exposes the full set of overflow/underflow bins for 2D
histograms. Under the previous proposal it was necessary for the
implementation to keep the full set of overflow/underflow bins, in order to be
able to do the projections correctly, but there was no way for the end-user to
access them (they were restricted to the 8 overflow bins N,E,S,W,NE,SE,SW,NW).
<LI>We eliminated the methods which return information
about bins based on coordinate (as opposed to index). We felt these functions
were rarely used, were in some cases ambiguous (for example when
projections/slices were specified in terms of coordinates what exactly was the
meaning) and the same functionality with less ambiguity was available by
calling coordToIndex() first.</LI></OL>
<P>A UML diagram of the classes is given below:</P>
<P><U><FONT color=#0000ff><IMG
src="doc-files/simpleaida.png"></FONT></U></P>
<P>
<P>
<HR>
<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_firstrow"><!-- --></A>
<TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
<TR ALIGN="center" VALIGN="top">
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
<TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Package</B></FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <FONT CLASS="NavBarFont1">Class</FONT> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-use.html"><FONT CLASS="NavBarFont1"><B>Use</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-files/index-1.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
<TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
</TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
<b>Colt 1.2.0</b></EM>
</TD>
</TR>
<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../corejava/package-summary.html"><B>PREV PACKAGE</B></A>
<A HREF="../../hep/aida/bin/package-summary.html"><B>NEXT PACKAGE</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
<A HREF="../../index.html" target="_top"><B>FRAMES</B></A>
<A HREF="package-summary.html" target="_top"><B>NO FRAMES</B></A>
<SCRIPT type="text/javascript">
<!--
if(window==top) {
document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
}
//-->
</SCRIPT>
<NOSCRIPT>
<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
</NOSCRIPT>
</FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->
<HR>
<font size=-1 >Jump to the <a target=_top href=http://dsd.lbl.gov/~hoschek/colt >Colt Homepage</a>
</BODY>
</HTML>
|
