summaryrefslogtreecommitdiff
path: root/graphics/epix/data_bins.h
diff options
context:
space:
mode:
authorNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
committerNorbert Preining <norbert@preining.info>2019-09-02 13:46:59 +0900
commite0c6872cf40896c7be36b11dcc744620f10adf1d (patch)
tree60335e10d2f4354b0674ec22d7b53f0f8abee672 /graphics/epix/data_bins.h
Initial commit
Diffstat (limited to 'graphics/epix/data_bins.h')
-rw-r--r--graphics/epix/data_bins.h101
1 files changed, 101 insertions, 0 deletions
diff --git a/graphics/epix/data_bins.h b/graphics/epix/data_bins.h
new file mode 100644
index 0000000000..e0d9a200e6
--- /dev/null
+++ b/graphics/epix/data_bins.h
@@ -0,0 +1,101 @@
+/*
+ * data_bins.h -- ePiX::data_bins class for histogram data
+ *
+ * This file is part of ePiX, a C++ library for creating high-quality
+ * figures in LaTeX
+ *
+ * Version 1.1.19
+ * Last Change: September 17, 2007
+ */
+
+/*
+ * Copyright (C) 2001, 2002, 2003, 2004, 2005, 2006, 2007
+ * Andrew D. Hwang <rot 13 nujnat at zngupf dot ubylpebff dot rqh>
+ * Department of Mathematics and Computer Science
+ * College of the Holy Cross
+ * Worcester, MA, 01610-2395, USA
+ */
+
+/*
+ * ePiX is free software; you can redistribute it and/or modify it
+ * under the terms of the GNU General Public License as published by
+ * the Free Software Foundation; either version 2 of the License, or
+ * (at your option) any later version.
+ *
+ * ePiX is distributed in the hope that it will be useful, but WITHOUT
+ * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
+ * or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public
+ * License for more details.
+ *
+ * You should have received a copy of the GNU General Public License
+ * along with ePiX; if not, write to the Free Software Foundation, Inc.,
+ * 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
+ */
+
+/*
+ * This file provides the "data_bins" class.
+ *
+ * An object of type data_bins models a closed interval [lo, hi]
+ * divided into subintervals (not necessarily of equal length). Each
+ * subinterval is a "d_bin", whose endpoints are "cuts". A data_bins
+ * can read and sort numerical data, count how many numbers lie in
+ * each bin, and print the result as a bar chart (rectangle height
+ * proportional to population), histogram (area proportional to
+ * population), or as a spline interpolation.
+ *
+ * Ideally no data lies outside (lo, hi) or on a cut. Data on an end
+ * cut is "out of range", data on an interior cut contributes 1/2 to
+ * the population of each adjacent bin. A summary statistic warning is
+ * printed if any points are out of range or lie on a cut.
+ */
+
+#ifndef EPIX_DATA_BINS
+#define EPIX_DATA_BINS
+
+#include <vector>
+#include <list>
+
+namespace ePiX {
+
+ class d_bin;
+
+ class data_bins {
+ public:
+ data_bins(double lo, double hi, unsigned int n=1);
+
+ data_bins(const data_bins&);
+ data_bins& operator= (const data_bins&);
+ ~data_bins();
+
+ data_bins& cut(double); // add a cut
+ data_bins& read(const std::vector<double>&);
+
+ unsigned int pop() const; // current population
+
+ // draw rectangles
+ void histogram(double scale=1) const; // area prop to pop
+ void bar_chart(double scale=1) const; // height prop to pop
+ void plot(double scale=1) const; // smooth interpolation
+
+ private:
+ double m_lo_val;
+ double m_hi_val;
+
+ unsigned int m_lo_ct; // population smaller than m_lo_val
+ unsigned int m_hi_ct; // population larger than m_hi_val
+ unsigned int m_pop; // current total population
+
+ unsigned int m_cut_hits; // number of data on a cut
+ bool m_cuts_locked; // true once we read data
+
+ std::list<double> m_cuts;
+ std::list<d_bin*> m_bins;
+
+ // bookkeeping
+ void initialize(); // convert cuts to bins and lock
+ void insert(double); // add data point
+ }; // end of class data_bins
+
+} // end of namespace
+
+#endif /* EPIX_DATA_BINS */