package cern.hep.aida.bin;

/** 
Function objects computing dynamic bin aggregations; to be passed to generic methods.
@see cern.colt.matrix.doublealgo.Formatter
@see cern.colt.matrix.doublealgo.Statistic
@author wolfgang.hoschek@cern.ch
@version 1.0, 09/24/99
*/
public class BinFunctions1D extends Object {
	/**
	Little trick to allow for "aliasing", that is, renaming this class.
	Using the aliasing you can instead write
	

	BinFunctions F = BinFunctions.functions; 

	someAlgo(F.max);
	*/
	public static final BinFunctions1D functions = new BinFunctions1D();

	/**
	 * Function that returns bin.max().
	 */
	public static final BinFunction1D max = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.max(); }
		public final String name() { return "Max"; }
	};		

	/**
	 * Function that returns bin.mean().
	 */
	public static final BinFunction1D mean = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.mean(); }
		public final String name() { return "Mean"; }
	};		

	/**
	 * Function that returns bin.median().
	 */
	public static final BinFunction1D median = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.median(); }
		public final String name() { return "Median"; }
	};		

	/**
	 * Function that returns bin.min().
	 */
	public static final BinFunction1D min = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.min(); }
		public final String name() { return "Min"; }
	};		

	/**
	 * Function that returns bin.rms().
	 */
	public static final BinFunction1D rms = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.rms(); }
		public final String name() { return "RMS"; }
	};		

	/**
	 * Function that returns bin.size().
	 */
	public static final BinFunction1D size = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.size(); }
		public final String name() { return "Size"; }
	};		

	/**
	 * Function that returns bin.standardDeviation().
	 */
	public static final BinFunction1D stdDev = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.standardDeviation(); }
		public final String name() { return "StdDev"; }
	};		

	/**
	 * Function that returns bin.sum().
	 */
	public static final BinFunction1D sum = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.sum(); }
		public final String name() { return "Sum"; }
	};
	/**
	 * Function that returns bin.sumOfLogarithms().
	 */
	public static final BinFunction1D sumLog = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.sumOfLogarithms(); }
		public final String name() { return "SumLog"; }
	};
	/**
	 * Function that returns bin.geometricMean().
	 */
	public static final BinFunction1D geometricMean = new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.geometricMean(); }
		public final String name() { return "GeomMean"; }
	};		


/**
 * Makes this class non instantiable, but still let's others inherit from it.
 */
protected BinFunctions1D() {}
/**
 * Function that returns bin.quantile(percentage).
 * @param the percentage of the quantile (0 <= percentage <= 1).
 */
public static BinFunction1D quantile(final double percentage) {
	return new BinFunction1D() {
		public final double apply(DynamicBin1D bin) { return bin.quantile(percentage); }
		public final String name() { return new cern.colt.matrix.impl.FormerFactory().create("%1.2G").form(percentage*100)+"% Q."; }
	};
}
}