mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-12-26 10:31:39 +08:00
294 lines
11 KiB
C++
294 lines
11 KiB
C++
/*
|
|
Copyright (c) 2008-2022 Jan W. Krieger (<jan@jkrieger.de>)
|
|
|
|
|
|
|
|
This software is free software: you can redistribute it and/or modify
|
|
it under the terms of the GNU Lesser General Public License (LGPL) as published by
|
|
the Free Software Foundation, either version 2.1 of the License, or
|
|
(at your option) any later version.
|
|
|
|
This program 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 Lesser General Public License (LGPL) for more details.
|
|
|
|
You should have received a copy of the GNU Lesser General Public License (LGPL)
|
|
along with this program. If not, see <http://www.gnu.org/licenses/>.
|
|
*/
|
|
|
|
#ifndef jkqtpgraphsboxplotbase_H
|
|
#define jkqtpgraphsboxplotbase_H
|
|
|
|
|
|
#include <QString>
|
|
#include <QPainter>
|
|
#include <QPair>
|
|
#include "jkqtplotter/jkqtptools.h"
|
|
#include "jkqtplotter/jkqtplotter_imexport.h"
|
|
#include "jkqtplotter/jkqtpimagetools.h"
|
|
#include "jkqtplotter/jkqtpgraphsbase.h"
|
|
#include "jkqtplotter/graphs/jkqtpboxplotstylingmixins.h"
|
|
#include "jkqtplotter/jkqtpgraphsbasestylingmixins.h"
|
|
|
|
|
|
|
|
|
|
|
|
/** \brief Base class for graphs representing a series of <a href="http://en.wikipedia.org/wiki/Box_plot">boxplot</a>, elements
|
|
* \ingroup jkqtplotter_statgraphs
|
|
*
|
|
* \image html JKQTPBoxplotVerticalGraph.png
|
|
*
|
|
*
|
|
* The different features of a boxplot are:
|
|
*
|
|
* \image html plot_boxplotverticalelement.png
|
|
*
|
|
* \see JKQTPBoxplotVerticalGraph, JKQTPBoxplotHorizontalGraph, JKQTPBoxplotElementBase
|
|
*
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPBoxplotGraphBase: public JKQTPGraph, public JKQTPGraphBoxplotStyleMixin {
|
|
Q_OBJECT
|
|
public:
|
|
|
|
/** \brief Sort order in a JKQTPBoxplotVerticalGraph (or one of its child classes) */
|
|
enum DataSortOrder {
|
|
Unsorted=0,
|
|
Sorted=1
|
|
};
|
|
|
|
|
|
|
|
/** \brief class constructor */
|
|
JKQTPBoxplotGraphBase(JKQTBasePlotter* parent=nullptr);
|
|
|
|
/** \brief returns the color to be used for the key label */
|
|
virtual QColor getKeyLabelColor() const override;
|
|
|
|
/** \copydoc JKQTPGraph::usesColumn() */
|
|
virtual bool usesColumn(int c) const override;
|
|
|
|
/** \copydoc sortData */
|
|
DataSortOrder getDataSortOrder() const;
|
|
/** \copydoc posColumn */
|
|
int getPositionColumn() const;
|
|
/** \copydoc medianColumn */
|
|
int getMedianColumn() const;
|
|
/** \copydoc meanColumn */
|
|
int getMeanColumn() const;
|
|
/** \copydoc minColumn */
|
|
int getMinColumn() const;
|
|
/** \copydoc maxColumn */
|
|
int getMaxColumn() const;
|
|
/** \copydoc percentile25Column */
|
|
int getPercentile25Column() const;
|
|
/** \copydoc percentile75Column */
|
|
int getPercentile75Column() const;
|
|
/** \copydoc medianConfidenceColumn */
|
|
int getMedianConfidenceColumn() const;
|
|
|
|
|
|
/** \copydoc boxWidthRelative */
|
|
double getBoxWidthRelative() const;
|
|
|
|
|
|
/** \copydoc useRelativeBoxWidth */
|
|
bool getUseRelativeBoxWidth() const;
|
|
public Q_SLOTS:
|
|
/** \brief set the color of the graph (colors all elements, based on the given color \a c ) */
|
|
virtual void setColor(QColor c);
|
|
/** \copydoc sortData */
|
|
void setDataSortOrder(DataSortOrder __value);
|
|
/** \copydoc sortData */
|
|
void setDataSortOrder(int __value);
|
|
/** \copydoc posColumn */
|
|
void setPositionColumn(int __value);
|
|
/** \copydoc posColumn */
|
|
void setPositionColumn (size_t __value);
|
|
/** \copydoc medianColumn */
|
|
void setMedianColumn(int __value);
|
|
/** \copydoc medianColumn */
|
|
void setMedianColumn (size_t __value);
|
|
/** \copydoc meanColumn */
|
|
void setMeanColumn(int __value);
|
|
/** \copydoc meanColumn */
|
|
void setMeanColumn (size_t __value);
|
|
/** \copydoc minColumn */
|
|
void setMinColumn(int __value);
|
|
/** \copydoc minColumn */
|
|
void setMinColumn( size_t __value);
|
|
/** \copydoc maxColumn */
|
|
void setMaxColumn(int __value);
|
|
/** \copydoc maxColumn */
|
|
void setMaxColumn (size_t __value);
|
|
/** \copydoc percentile25Column */
|
|
void setPercentile25Column(int __value);
|
|
/** \copydoc percentile25Column */
|
|
void setPercentile25Column (size_t __value);
|
|
/** \copydoc percentile75Column */
|
|
void setPercentile75Column(int __value);
|
|
/** \copydoc percentile75Column */
|
|
void setPercentile75Column (size_t __value);
|
|
/** \copydoc medianConfidenceColumn */
|
|
void setMedianConfidenceColumn (size_t __value);
|
|
/** \copydoc boxWidthRelative */
|
|
void setBoxWidthRelative(double __value);
|
|
/** \copydoc useRelativeBoxWidth */
|
|
void setUseRelativeBoxWidth(bool __value);
|
|
protected:
|
|
/** \brief width of box in percent of distance between the current two posColumn values
|
|
* if we only plot one box&whiskers then JKQTPGraphBoxplotStyleMixin::boxWidthAbsolute in pt is used */
|
|
double boxWidthRelative;
|
|
/** \brief if set \c true, boxplot widths are calculated automatically, based on boxWidthRelative,
|
|
* otherwise JKQTPGraphBoxplotStyleMixin::boxWidthAbsolute is used. */
|
|
bool useRelativeBoxWidth;
|
|
|
|
/** \brief the column that contains the x-component of the datapoints */
|
|
int posColumn;
|
|
/** \brief the column that contains the median-component of the datapoints */
|
|
int medianColumn;
|
|
/** \brief the column that contains the confidence interval width of the median (e.g. 1.57*IQR/sqrt(n) ). This is used to draw a notch in the plot (if set) */
|
|
int medianConfidenceColumn;
|
|
/** \brief the column that contains the median-component of the datapoints. \note This column is strictly optional. */
|
|
int meanColumn;
|
|
/** \brief the column that contains the minimum-component of the datapoints */
|
|
int minColumn;
|
|
/** \brief the column that contains the maximum-component of the datapoints */
|
|
int maxColumn;
|
|
/** \brief the column that contains the 25% percentile-component of the datapoints */
|
|
int percentile25Column;
|
|
/** \brief the column that contains the 75% percentile-component of the datapoints */
|
|
int percentile75Column;
|
|
/** \brief if \c !=Unsorted, the data is sorted before plotting */
|
|
DataSortOrder sortData;
|
|
/** \brief this array contains the order of indices, in which to access the data in the data columns */
|
|
QVector<int> sortedIndices;
|
|
|
|
/** \brief generates a map from unsorted to sorted data \see getDataIndex() */
|
|
virtual void intSortData() ;
|
|
/** \brief retrieves the index of the i-th element when data is sorted (after calling intSortData(), which generates a map from unsorted to sorted data */
|
|
inline int getDataIndex(int i) const {
|
|
if (sortData==Unsorted) return i;
|
|
return sortedIndices.value(i,i);
|
|
}
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
/** \brief Tbaseclass for a single <a href="http://en.wikipedia.org/wiki/Box_plot">(notched) boxplot</a> as a "geometric element",
|
|
* where the data is directly given to the object and not stored in a column, as in JKQTPBoxplotGraphBase
|
|
* \ingroup jkqtplotter_statgraphs
|
|
* \ingroup jkqtplotter_statgraphs
|
|
*
|
|
* The different features of a boxplot are:
|
|
*
|
|
* \image html plot_boxplotverticalelement.png
|
|
*
|
|
* \see JKQTPBoxplotElementBase, JKQTPBoxplotHorizontalElement, JKQTPBoxplotGraphBase
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPBoxplotElementBase: public JKQTPPlotElement, public JKQTPGraphBoxplotStyleMixin {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPBoxplotElementBase(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPBoxplotElementBase(JKQTPlotter* parent);
|
|
|
|
/** \brief returns the color to be used for the key label */
|
|
virtual QColor getKeyLabelColor() const override;
|
|
|
|
/** \copydoc pos */
|
|
double getPos() const;
|
|
/** \copydoc median */
|
|
double getMedian() const;
|
|
/** \copydoc mean */
|
|
double getMean() const;
|
|
/** \copydoc min */
|
|
double getMin() const;
|
|
/** \copydoc max */
|
|
double getMax() const;
|
|
/** \copydoc percentile25 */
|
|
double getPercentile25() const;
|
|
/** \copydoc percentile75 */
|
|
double getPercentile75() const;
|
|
|
|
/** \copydoc drawMean */
|
|
void setDrawMean(bool __value);
|
|
/** \copydoc drawMean */
|
|
bool getDrawMean() const;
|
|
/** \copydoc drawMedian */
|
|
bool getDrawMedian() const;
|
|
/** \copydoc drawMinMax */
|
|
bool getDrawMinMax() const;
|
|
/** \copydoc drawNotch */
|
|
bool getDrawNotch() const;
|
|
|
|
/** \copydoc medianConfidenceIntervalWidth */
|
|
double getMedianConfidenceIntervalWidth() const;
|
|
public Q_SLOTS:
|
|
/** \brief set the color of the graph (colors all elements, based on the given color \a c ) */
|
|
virtual void setColor(QColor c);
|
|
|
|
/** \copydoc pos */
|
|
void setPos(double __value);
|
|
/** \copydoc median */
|
|
void setMedian(double __value);
|
|
/** \copydoc min */
|
|
void setMin(double __value);
|
|
/** \copydoc mean */
|
|
void setMean(double __value);
|
|
/** \copydoc max */
|
|
void setMax(double __value);
|
|
/** \copydoc percentile25 */
|
|
void setPercentile25(double __value);
|
|
/** \copydoc percentile75 */
|
|
void setPercentile75(double __value);
|
|
/** \brief set all properties of the plot at once \see pos, median, min, mean, max, percentile25, percentile75 */
|
|
void setData(double pos, double min, double q25, double median, double mean, double q75, double max);
|
|
|
|
/** \copydoc drawMedian */
|
|
void setDrawMedian(bool __value);
|
|
/** \copydoc drawMinMax */
|
|
void setDrawMinMax(bool __value);
|
|
/** \copydoc drawNotch */
|
|
void setDrawNotch(bool __value);
|
|
/** \copydoc medianConfidenceIntervalWidth */
|
|
void setMedianConfidenceIntervalWidth(double __value);
|
|
|
|
|
|
protected:
|
|
|
|
/** \brief the position of the boxplot on the "other" axis */
|
|
double pos;
|
|
/** \brief the median value to be used for the boxplot */
|
|
double median;
|
|
/** \brief the width of the confidence interval around the median */
|
|
double medianConfidenceIntervalWidth;
|
|
/** \brief indicates whether to draw a notch with width medianConfidenceIntervalWidth */
|
|
bool drawNotch;
|
|
/** \brief the mean value to be used for the boxplot */
|
|
double mean;
|
|
/** \brief indicates whether to draw the mean */
|
|
bool drawMean;
|
|
/** \brief indicates whether to draw the median */
|
|
bool drawMedian;
|
|
/** \brief indicates whether to draw the percentiles */
|
|
bool drawMinMax;
|
|
/** \brief the minimum value to be used for the boxplot */
|
|
double min;
|
|
/** \brief the maximum value to be used for the boxplot */
|
|
double max;
|
|
/** \brief the 25% percentile value to be used for the boxplot */
|
|
double percentile25;
|
|
/** \brief the 75% percentile value to be used for the boxplot */
|
|
double percentile75;
|
|
};
|
|
|
|
|
|
|
|
|
|
#endif // jkqtpgraphsboxplotbase_H
|