Portfolio Code | Clement Colmerauer
Repositories
Site
Rabbit simulation
Code
Commits
Branches
Tags
Search
Tree:
a20104a
Branches
Tags
master
Rabbit simulation
build
colt
doc
api
hep
aida
bin
MightyStaticBin1D.html
initial commit
Clement COLMERAUER
commited
a20104a
at 2024-09-09 10:17:52
MightyStaticBin1D.html
Blame
History
Raw
<!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:14 PDT 2004 --> <TITLE> MightyStaticBin1D (Colt 1.2.0 - API Specification) </TITLE> <META NAME="keywords" CONTENT="hep.aida.bin.MightyStaticBin1D class"> <LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"> <SCRIPT type="text/javascript"> function windowTitle() { parent.document.title="MightyStaticBin1D (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="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/MightyStaticBin1D.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="../../../hep/aida/bin/DynamicBin1D.html" title="class in hep.aida.bin"><B>PREV CLASS</B></A> <A HREF="../../../hep/aida/bin/QuantileBin1D.html" title="class in hep.aida.bin"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="MightyStaticBin1D.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> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#fields_inherited_from_class_cern.colt.PersistentObject">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD> </TR> </TABLE> <A NAME="skip-navbar_top"></A> <!-- ========= END OF TOP NAVBAR ========= --> <HR> <!-- ======== START OF CLASS DATA ======== --> <H2> <FONT SIZE="-1"> hep.aida.bin</FONT> <BR> Class MightyStaticBin1D</H2> <PRE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">java.lang.Object</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../cern/colt/PersistentObject.html" title="class in cern.colt">cern.colt.PersistentObject</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../hep/aida/bin/AbstractBin.html" title="class in hep.aida.bin">hep.aida.bin.AbstractBin</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">hep.aida.bin.AbstractBin1D</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><A HREF="../../../hep/aida/bin/StaticBin1D.html" title="class in hep.aida.bin">hep.aida.bin.StaticBin1D</A> <IMG SRC="../../../resources/inherit.gif" ALT="extended by"><B>hep.aida.bin.MightyStaticBin1D</B> </PRE> <DL> <DT><B>All Implemented Interfaces:</B> <DD><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Cloneable.html" title="class or interface in java.lang">Cloneable</A>, <A HREF="../../../cern/colt/buffer/DoubleBufferConsumer.html" title="interface in cern.colt.buffer">DoubleBufferConsumer</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/io/Serializable.html" title="class or interface in java.io">Serializable</A></DD> </DL> <DL> <DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../hep/aida/bin/QuantileBin1D.html" title="class in hep.aida.bin">QuantileBin1D</A></DD> </DL> <HR> <DL> <DT>public class <B>MightyStaticBin1D</B><DT>extends <A HREF="../../../hep/aida/bin/StaticBin1D.html" title="class in hep.aida.bin">StaticBin1D</A></DL> <P> Static and the same as its superclass, except that it can do more: Additionally computes moments of arbitrary integer order, harmonic mean, geometric mean, etc. Constructors need to be told what functionality is required for the given use case. Only maintains aggregate measures (incrementally) - the added elements themselves are not kept. <P> <P> <DL> <DT><B>Version:</B></DT> <DD>0.9, 03-Jul-99</DD> <DT><B>See Also:</B><DD><A HREF="../../../serialized-form.html#hep.aida.bin.MightyStaticBin1D">Serialized Form</A></DL> <HR> <P> <!-- ======== NESTED CLASS SUMMARY ======== --> <!-- =========== FIELD SUMMARY =========== --> <A NAME="field_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=2><FONT SIZE="+2"> <B>Field Summary</B></FONT></TD> </TR> </TABLE> <A NAME="fields_inherited_from_class_cern.colt.PersistentObject"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Fields inherited from class cern.colt.<A HREF="../../../cern/colt/PersistentObject.html" title="class in cern.colt">PersistentObject</A></B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../cern/colt/PersistentObject.html#serialVersionUID">serialVersionUID</A></CODE></TD> </TR> </TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --> <A NAME="constructor_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=2><FONT SIZE="+2"> <B>Constructor Summary</B></FONT></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#MightyStaticBin1D()">MightyStaticBin1D</A></B>()</CODE> <BR> Constructs and returns an empty bin with limited functionality but good performance; equivalent to <tt>MightyStaticBin1D(false,false,4)</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#MightyStaticBin1D(boolean, boolean, int)">MightyStaticBin1D</A></B>(boolean hasSumOfLogarithms, boolean hasSumOfInversions, int maxOrderForSumOfPowers)</CODE> <BR> Constructs and returns an empty bin with the given capabilities.</TD> </TR> </TABLE> <!-- ========== METHOD SUMMARY =========== --> <A NAME="method_summary"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=2><FONT SIZE="+2"> <B>Method Summary</B></FONT></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> void</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#addAllOfFromTo(cern.colt.list.DoubleArrayList, int, int)">addAllOfFromTo</A></B>(<A HREF="../../../cern/colt/list/DoubleArrayList.html" title="class in cern.colt.list">DoubleArrayList</A> list, int from, int to)</CODE> <BR> Adds the part of the specified list between indexes <tt>from</tt> (inclusive) and <tt>to</tt> (inclusive) to the receiver.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#clone()">clone</A></B>()</CODE> <BR> Returns a deep copy of the receiver.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#compareWith(hep.aida.bin.AbstractBin1D)">compareWith</A></B>(<A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">AbstractBin1D</A> other)</CODE> <BR> Computes the deviations from the receiver's measures to another bin's measures.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#geometricMean()">geometricMean</A></B>()</CODE> <BR> Returns the geometric mean, which is <tt>Product( x[i] )<sup>1.0/size()</sup></tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#getMaxOrderForSumOfPowers()">getMaxOrderForSumOfPowers</A></B>()</CODE> <BR> Returns the maximum order <tt>k</tt> for which sums of powers are retrievable, as specified upon instance construction.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> int</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#getMinOrderForSumOfPowers()">getMinOrderForSumOfPowers</A></B>()</CODE> <BR> Returns the minimum order <tt>k</tt> for which sums of powers are retrievable, as specified upon instance construction.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#harmonicMean()">harmonicMean</A></B>()</CODE> <BR> Returns the harmonic mean, which is <tt>size() / Sum( 1/x[i] )</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfInversions()">hasSumOfInversions</A></B>()</CODE> <BR> Returns whether <tt>sumOfInversions()</tt> can return meaningful results.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfLogarithms()">hasSumOfLogarithms</A></B>()</CODE> <BR> Tells whether <tt>sumOfLogarithms()</tt> can return meaningful results.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> boolean</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)">hasSumOfPowers</A></B>(int k)</CODE> <BR> Tells whether <tt>sumOfPowers(k)</tt> can return meaningful results.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#kurtosis()">kurtosis</A></B>()</CODE> <BR> Returns the kurtosis (aka excess), which is <tt>-3 + moment(4,mean()) / standardDeviation()<sup>4</sup></tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#moment(int, double)">moment</A></B>(int k, double c)</CODE> <BR> Returns the moment of <tt>k</tt>-th order with value <tt>c</tt>, which is <tt>Sum( (x[i]-c)<sup>k</sup> ) / size()</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#product()">product</A></B>()</CODE> <BR> Returns the product, which is <tt>Prod( x[i] )</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#skew()">skew</A></B>()</CODE> <BR> Returns the skew, which is <tt>moment(3,mean()) / standardDeviation()<sup>3</sup></tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfInversions()">sumOfInversions</A></B>()</CODE> <BR> Returns the sum of inversions, which is <tt>Sum( 1 / x[i] )</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfLogarithms()">sumOfLogarithms</A></B>()</CODE> <BR> Returns the sum of logarithms, which is <tt>Sum( Log(x[i]) )</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> double</CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfPowers(int)">sumOfPowers</A></B>(int k)</CODE> <BR> Returns the <tt>k-th</tt> order sum of powers, which is <tt>Sum( x[i]<sup>k</sup> )</tt>.</TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"> <CODE> <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A></CODE></FONT></TD> <TD><CODE><B><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#toString()">toString</A></B>()</CODE> <BR> Returns a String representation of the receiver.</TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_hep.aida.bin.StaticBin1D"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Methods inherited from class hep.aida.bin.<A HREF="../../../hep/aida/bin/StaticBin1D.html" title="class in hep.aida.bin">StaticBin1D</A></B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../hep/aida/bin/StaticBin1D.html#add(double)">add</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#clear()">clear</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#isRebinnable()">isRebinnable</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#max()">max</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#min()">min</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#size()">size</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#sum()">sum</A>, <A HREF="../../../hep/aida/bin/StaticBin1D.html#sumOfSquares()">sumOfSquares</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_hep.aida.bin.AbstractBin1D"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Methods inherited from class hep.aida.bin.<A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">AbstractBin1D</A></B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../hep/aida/bin/AbstractBin1D.html#addAllOf(cern.colt.list.DoubleArrayList)">addAllOf</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#buffered(int)">buffered</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#equals(java.lang.Object)">equals</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#mean()">mean</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#rms()">rms</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#standardDeviation()">standardDeviation</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#standardError()">standardError</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#trimToSize()">trimToSize</A>, <A HREF="../../../hep/aida/bin/AbstractBin1D.html#variance()">variance</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_hep.aida.bin.AbstractBin"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Methods inherited from class hep.aida.bin.<A HREF="../../../hep/aida/bin/AbstractBin.html" title="class in hep.aida.bin">AbstractBin</A></B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="../../../hep/aida/bin/AbstractBin.html#center()">center</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#center(int)">center</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#error()">error</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#error(int)">error</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#offset()">offset</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#offset(int)">offset</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#value()">value</A>, <A HREF="../../../hep/aida/bin/AbstractBin.html#value(int)">value</A></CODE></TD> </TR> </TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"> <TD><B>Methods inherited from class java.lang.<A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A></B></TD> </TR> <TR BGCOLOR="white" CLASS="TableRowColor"> <TD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#getClass()" title="class or interface in java.lang">getClass</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#hashCode()" title="class or interface in java.lang">hashCode</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notify()" title="class or interface in java.lang">notify</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#notifyAll()" title="class or interface in java.lang">notifyAll</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait()" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long)" title="class or interface in java.lang">wait</A>, <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html#wait(long, int)" title="class or interface in java.lang">wait</A></CODE></TD> </TR> </TABLE> <P> <!-- ============ FIELD DETAIL =========== --> <!-- ========= CONSTRUCTOR DETAIL ======== --> <A NAME="constructor_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=1><FONT SIZE="+2"> <B>Constructor Detail</B></FONT></TD> </TR> </TABLE> <A NAME="MightyStaticBin1D()"><!-- --></A><H3> MightyStaticBin1D</H3> <PRE> public <B>MightyStaticBin1D</B>()</PRE> <DL> <DD>Constructs and returns an empty bin with limited functionality but good performance; equivalent to <tt>MightyStaticBin1D(false,false,4)</tt>. <P> </DL> <HR> <A NAME="MightyStaticBin1D(boolean, boolean, int)"><!-- --></A><H3> MightyStaticBin1D</H3> <PRE> public <B>MightyStaticBin1D</B>(boolean hasSumOfLogarithms, boolean hasSumOfInversions, int maxOrderForSumOfPowers)</PRE> <DL> <DD>Constructs and returns an empty bin with the given capabilities. <P> <DT><B>Parameters:</B><DD><CODE>hasSumOfLogarithms</CODE> - Tells whether <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfLogarithms()"><CODE>sumOfLogarithms()</CODE></A> can return meaningful results. Set this parameter to <tt>false</tt> if measures of sum of logarithms, geometric mean and product are not required. <p><DD><CODE>hasSumOfInversions</CODE> - Tells whether <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfInversions()"><CODE>sumOfInversions()</CODE></A> can return meaningful results. Set this parameter to <tt>false</tt> if measures of sum of inversions, harmonic mean and sumOfPowers(-1) are not required. <p><DD><CODE>maxOrderForSumOfPowers</CODE> - The maximum order <tt>k</tt> for which <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfPowers(int)"><CODE>sumOfPowers(int)</CODE></A> can return meaningful results. Set this parameter to at least 3 if the skew is required, to at least 4 if the kurtosis is required. In general, if moments are required set this parameter at least as large as the largest required moment. This method always substitutes <tt>Math.max(2,maxOrderForSumOfPowers)</tt> for the parameter passed in. Thus, <tt>sumOfPowers(0..2)</tt> always returns meaningful results.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A>, <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#moment(int, double)"><CODE>moment(int,double)</CODE></A></DL> <!-- ============ METHOD DETAIL ========== --> <A NAME="method_detail"><!-- --></A> <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""> <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"> <TD COLSPAN=1><FONT SIZE="+2"> <B>Method Detail</B></FONT></TD> </TR> </TABLE> <A NAME="addAllOfFromTo(cern.colt.list.DoubleArrayList, int, int)"><!-- --></A><H3> addAllOfFromTo</H3> <PRE> public void <B>addAllOfFromTo</B>(<A HREF="../../../cern/colt/list/DoubleArrayList.html" title="class in cern.colt.list">DoubleArrayList</A> list, int from, int to)</PRE> <DL> <DD>Adds the part of the specified list between indexes <tt>from</tt> (inclusive) and <tt>to</tt> (inclusive) to the receiver. <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE><A HREF="../../../hep/aida/bin/StaticBin1D.html#addAllOfFromTo(cern.colt.list.DoubleArrayList, int, int)">addAllOfFromTo</A></CODE> in class <CODE><A HREF="../../../hep/aida/bin/StaticBin1D.html" title="class in hep.aida.bin">StaticBin1D</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>list</CODE> - the list of which elements shall be added.<DD><CODE>from</CODE> - the index of the first element to be added (inclusive).<DD><CODE>to</CODE> - the index of the last element to be added (inclusive). <DT><B>Throws:</B> <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IndexOutOfBoundsException.html" title="class or interface in java.lang">IndexOutOfBoundsException</A></CODE> - if <tt>list.size()>0 && (from<0 || from>to || to>=list.size())</tt>.</DL> </DD> </DL> <HR> <A NAME="clone()"><!-- --></A><H3> clone</H3> <PRE> public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/Object.html" title="class or interface in java.lang">Object</A> <B>clone</B>()</PRE> <DL> <DD>Returns a deep copy of the receiver. <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE><A HREF="../../../cern/colt/PersistentObject.html#clone()">clone</A></CODE> in class <CODE><A HREF="../../../cern/colt/PersistentObject.html" title="class in cern.colt">PersistentObject</A></CODE></DL> </DD> <DD><DL> <DT><B>Returns:</B><DD>a deep copy of the receiver.</DL> </DD> </DL> <HR> <A NAME="compareWith(hep.aida.bin.AbstractBin1D)"><!-- --></A><H3> compareWith</H3> <PRE> public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>compareWith</B>(<A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">AbstractBin1D</A> other)</PRE> <DL> <DD>Computes the deviations from the receiver's measures to another bin's measures. <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE><A HREF="../../../hep/aida/bin/AbstractBin1D.html#compareWith(hep.aida.bin.AbstractBin1D)">compareWith</A></CODE> in class <CODE><A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">AbstractBin1D</A></CODE></DL> </DD> <DD><DL> <DT><B>Parameters:</B><DD><CODE>other</CODE> - the other bin to compare with <DT><B>Returns:</B><DD>a summary of the deviations.</DL> </DD> </DL> <HR> <A NAME="geometricMean()"><!-- --></A><H3> geometricMean</H3> <PRE> public double <B>geometricMean</B>()</PRE> <DL> <DD>Returns the geometric mean, which is <tt>Product( x[i] )<sup>1.0/size()</sup></tt>. This method tries to avoid overflows at the expense of an equivalent but somewhat inefficient definition: <tt>geoMean = exp( Sum( Log(x[i]) ) / size())</tt>. Note that for a geometric mean to be meaningful, the minimum of the data sequence must not be less or equal to zero. <P> <DD><DL> <DT><B>Returns:</B><DD>the geometric mean; <tt>Double.NaN</tt> if <tt>!hasSumOfLogarithms()</tt>.</DL> </DD> </DL> <HR> <A NAME="getMaxOrderForSumOfPowers()"><!-- --></A><H3> getMaxOrderForSumOfPowers</H3> <PRE> public int <B>getMaxOrderForSumOfPowers</B>()</PRE> <DL> <DD>Returns the maximum order <tt>k</tt> for which sums of powers are retrievable, as specified upon instance construction. <P> <DD><DL> <DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A>, <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfPowers(int)"><CODE>sumOfPowers(int)</CODE></A></DL> </DD> </DL> <HR> <A NAME="getMinOrderForSumOfPowers()"><!-- --></A><H3> getMinOrderForSumOfPowers</H3> <PRE> public int <B>getMinOrderForSumOfPowers</B>()</PRE> <DL> <DD>Returns the minimum order <tt>k</tt> for which sums of powers are retrievable, as specified upon instance construction. <P> <DD><DL> <DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A>, <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#sumOfPowers(int)"><CODE>sumOfPowers(int)</CODE></A></DL> </DD> </DL> <HR> <A NAME="harmonicMean()"><!-- --></A><H3> harmonicMean</H3> <PRE> public double <B>harmonicMean</B>()</PRE> <DL> <DD>Returns the harmonic mean, which is <tt>size() / Sum( 1/x[i] )</tt>. Remember: If the receiver contains at least one element of <tt>0.0</tt>, the harmonic mean is <tt>0.0</tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the harmonic mean; <tt>Double.NaN</tt> if <tt>!hasSumOfInversions()</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfInversions()"><CODE>hasSumOfInversions()</CODE></A></DL> </DD> </DL> <HR> <A NAME="hasSumOfInversions()"><!-- --></A><H3> hasSumOfInversions</H3> <PRE> public boolean <B>hasSumOfInversions</B>()</PRE> <DL> <DD>Returns whether <tt>sumOfInversions()</tt> can return meaningful results. <P> <DD><DL> <DT><B>Returns:</B><DD><tt>false</tt> if the bin was constructed with insufficient parametrization, <tt>true</tt> otherwise. See the constructors for proper parametrization.</DL> </DD> </DL> <HR> <A NAME="hasSumOfLogarithms()"><!-- --></A><H3> hasSumOfLogarithms</H3> <PRE> public boolean <B>hasSumOfLogarithms</B>()</PRE> <DL> <DD>Tells whether <tt>sumOfLogarithms()</tt> can return meaningful results. <P> <DD><DL> <DT><B>Returns:</B><DD><tt>false</tt> if the bin was constructed with insufficient parametrization, <tt>true</tt> otherwise. See the constructors for proper parametrization.</DL> </DD> </DL> <HR> <A NAME="hasSumOfPowers(int)"><!-- --></A><H3> hasSumOfPowers</H3> <PRE> public boolean <B>hasSumOfPowers</B>(int k)</PRE> <DL> <DD>Tells whether <tt>sumOfPowers(k)</tt> can return meaningful results. Defined as <tt>hasSumOfPowers(k) <==> getMinOrderForSumOfPowers() <= k && k <= getMaxOrderForSumOfPowers()</tt>. A return value of <tt>true</tt> implies that <tt>hasSumOfPowers(k-1) .. hasSumOfPowers(0)</tt> will also return <tt>true</tt>. See the constructors for proper parametrization. <p> <b>Details</b>: <tt>hasSumOfPowers(0..2)</tt> will always yield <tt>true</tt>. <tt>hasSumOfPowers(-1) <==> hasSumOfInversions()</tt>. <P> <DD><DL> <DT><B>Returns:</B><DD><tt>false</tt> if the bin was constructed with insufficient parametrization, <tt>true</tt> otherwise.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#getMinOrderForSumOfPowers()"><CODE>getMinOrderForSumOfPowers()</CODE></A>, <A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#getMaxOrderForSumOfPowers()"><CODE>getMaxOrderForSumOfPowers()</CODE></A></DL> </DD> </DL> <HR> <A NAME="kurtosis()"><!-- --></A><H3> kurtosis</H3> <PRE> public double <B>kurtosis</B>()</PRE> <DL> <DD>Returns the kurtosis (aka excess), which is <tt>-3 + moment(4,mean()) / standardDeviation()<sup>4</sup></tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the kurtosis; <tt>Double.NaN</tt> if <tt>!hasSumOfPowers(4)</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A></DL> </DD> </DL> <HR> <A NAME="moment(int, double)"><!-- --></A><H3> moment</H3> <PRE> public double <B>moment</B>(int k, double c)</PRE> <DL> <DD>Returns the moment of <tt>k</tt>-th order with value <tt>c</tt>, which is <tt>Sum( (x[i]-c)<sup>k</sup> ) / size()</tt>. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>k</CODE> - the order; must be greater than or equal to zero.<DD><CODE>c</CODE> - any number. <DT><B>Returns:</B><DD><tt>Double.NaN</tt> if <tt>!hasSumOfPower(k)</tt>. <DT><B>Throws:</B> <DD><CODE><A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/IllegalArgumentException.html" title="class or interface in java.lang">IllegalArgumentException</A></CODE> - if <tt>k < 0</tt>.</DL> </DD> </DL> <HR> <A NAME="product()"><!-- --></A><H3> product</H3> <PRE> public double <B>product</B>()</PRE> <DL> <DD>Returns the product, which is <tt>Prod( x[i] )</tt>. In other words: <tt>x[0]*x[1]*...*x[size()-1]</tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the product; <tt>Double.NaN</tt> if <tt>!hasSumOfLogarithms()</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfLogarithms()"><CODE>hasSumOfLogarithms()</CODE></A></DL> </DD> </DL> <HR> <A NAME="skew()"><!-- --></A><H3> skew</H3> <PRE> public double <B>skew</B>()</PRE> <DL> <DD>Returns the skew, which is <tt>moment(3,mean()) / standardDeviation()<sup>3</sup></tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the skew; <tt>Double.NaN</tt> if <tt>!hasSumOfPowers(3)</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A></DL> </DD> </DL> <HR> <A NAME="sumOfInversions()"><!-- --></A><H3> sumOfInversions</H3> <PRE> public double <B>sumOfInversions</B>()</PRE> <DL> <DD>Returns the sum of inversions, which is <tt>Sum( 1 / x[i] )</tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the sum of inversions; <tt>Double.NaN</tt> if <tt>!hasSumOfInversions()</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfInversions()"><CODE>hasSumOfInversions()</CODE></A></DL> </DD> </DL> <HR> <A NAME="sumOfLogarithms()"><!-- --></A><H3> sumOfLogarithms</H3> <PRE> public double <B>sumOfLogarithms</B>()</PRE> <DL> <DD>Returns the sum of logarithms, which is <tt>Sum( Log(x[i]) )</tt>. <P> <DD><DL> <DT><B>Returns:</B><DD>the sum of logarithms; <tt>Double.NaN</tt> if <tt>!hasSumOfLogarithms()</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfLogarithms()"><CODE>hasSumOfLogarithms()</CODE></A></DL> </DD> </DL> <HR> <A NAME="sumOfPowers(int)"><!-- --></A><H3> sumOfPowers</H3> <PRE> public double <B>sumOfPowers</B>(int k)</PRE> <DL> <DD>Returns the <tt>k-th</tt> order sum of powers, which is <tt>Sum( x[i]<sup>k</sup> )</tt>. <P> <DD><DL> <DT><B>Parameters:</B><DD><CODE>k</CODE> - the order of the powers. <DT><B>Returns:</B><DD>the sum of powers; <tt>Double.NaN</tt> if <tt>!hasSumOfPowers(k)</tt>.<DT><B>See Also:</B><DD><A HREF="../../../hep/aida/bin/MightyStaticBin1D.html#hasSumOfPowers(int)"><CODE>hasSumOfPowers(int)</CODE></A></DL> </DD> </DL> <HR> <A NAME="toString()"><!-- --></A><H3> toString</H3> <PRE> public <A HREF="http://java.sun.com/j2se/1.4/docs/api/java/lang/String.html" title="class or interface in java.lang">String</A> <B>toString</B>()</PRE> <DL> <DD>Returns a String representation of the receiver. <P> <DD><DL> <DT><B>Overrides:</B><DD><CODE><A HREF="../../../hep/aida/bin/AbstractBin1D.html#toString()">toString</A></CODE> in class <CODE><A HREF="../../../hep/aida/bin/AbstractBin1D.html" title="class in hep.aida.bin">AbstractBin1D</A></CODE></DL> </DD> <DD><DL> </DL> </DD> </DL> <!-- ========= END OF CLASS DATA ========= --> <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="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="class-use/MightyStaticBin1D.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="../../../hep/aida/bin/DynamicBin1D.html" title="class in hep.aida.bin"><B>PREV CLASS</B></A> <A HREF="../../../hep/aida/bin/QuantileBin1D.html" title="class in hep.aida.bin"><B>NEXT CLASS</B></A></FONT></TD> <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" target="_top"><B>FRAMES</B></A> <A HREF="MightyStaticBin1D.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> <TR> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#fields_inherited_from_class_cern.colt.PersistentObject">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD> <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></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>