mirror of
https://github.com/jkriege2/JKQtPlotter.git
synced 2024-12-26 18:41:40 +08:00
f2004a6f66
IMPROVED/REWORKED: legend/key positioning as combination of 3 values, e.g. \c JKQTPKeyOutsideTop|JKQTPKeyTop|JKQTPKeyRight or \c JKQTPKeyInside|JKQTPKeyTopJKQTPKeyRight
383 lines
15 KiB
C++
383 lines
15 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 jkqtpgraphsfilledcurve_H
|
|
#define jkqtpgraphsfilledcurve_H
|
|
|
|
|
|
#include "jkqtplotter/jkqtplotter_imexport.h"
|
|
#include "jkqtplotter/jkqtpgraphsbase.h"
|
|
#include "jkqtplotter/jkqtpgraphsbaseerrors.h"
|
|
#include "jkqtplotter/graphs/jkqtpspecialline.h"
|
|
|
|
|
|
|
|
|
|
|
|
/** \brief a Base class for filled curve graphs like e.g. JKQTPFilledCurveXGraph
|
|
* \ingroup jkqtplotter_filledgraphs
|
|
*
|
|
* \image html filledgraphs.png
|
|
*
|
|
*
|
|
* \see JKQTPFilledCurveXGraph, JKQTPFilledCurveYGraph
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledCurveGraphBase: public JKQTPXYBaselineGraph, public JKQTPGraphLineAndFillStyleMixin {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief specifies how the area below the graph is filled
|
|
*
|
|
* \see setFillMode(), getFillMode(), fillStyleBelow(), \ref JKQTPlotterWigglePlots
|
|
*/
|
|
enum FillMode {
|
|
SingleFilling=0, /*!< \brief the whole area is filled with the same color/pattern, generates "simple filled plots", such as \image html filledgraphs_small.png */
|
|
TwoColorFilling=1 /*!< \brief the area above and below baseline with the two different colors/patterns, generates "wiggle plots", such as \image html wiggleplots_small.png */
|
|
};
|
|
Q_ENUM(FillMode)
|
|
|
|
/** \brief class constructor */
|
|
explicit JKQTPFilledCurveGraphBase(JKQTBasePlotter* parent=nullptr);
|
|
|
|
/** \brief returns the color to be used for the key label */
|
|
virtual QColor getKeyLabelColor() const override;
|
|
/** \brief plots a key marker inside the specified rectangle \a rect */
|
|
virtual void drawKeyMarker(JKQTPEnhancedPainter& painter, const QRectF& rect) override;
|
|
/** \copydoc m_fillStyleBelow */
|
|
JKQTPGraphFillStyleMixin& fillStyleBelow();
|
|
/** \copydoc m_fillStyleBelow */
|
|
const JKQTPGraphFillStyleMixin& fillStyleBelow() const;
|
|
/** \copydoc m_fillMode */
|
|
FillMode getFillMode() const;
|
|
|
|
public Q_SLOTS:
|
|
/** \brief set line-color, fill color and symbol color */
|
|
void setColor(QColor c);
|
|
/** \copydoc m_fillMode */
|
|
void setFillMode(JKQTPFilledCurveGraphBase::FillMode mode);
|
|
protected:
|
|
/** \brief specifies how the area of the graph is filles */
|
|
FillMode m_fillMode;
|
|
/** \brief if m_fillMode \c ==FillAboveAndBelowDifferently then this fill style is used below the baseline and
|
|
* the default fill style is used above */
|
|
JKQTPGraphFillStyleMixin m_fillStyleBelow;
|
|
};
|
|
|
|
|
|
|
|
/*! \brief This implements filled curve plots where the area is filled between the plot line and the x-Axis.
|
|
\ingroup jkqtplotter_filledgraphs
|
|
|
|
\image html JKQTPFilledCurveXGraph.png
|
|
|
|
\see \ref JKQTPlotterFilledGraphs
|
|
|
|
This class also provides the possibility to file above and below the baseline with different style.
|
|
Such plots are sometimes called "Wiggle Plots" and are often used (in their black/white-variety for seismographic
|
|
data plotting.
|
|
|
|
* \image html JKQTPFilledCurveXGraph_wiggle.png
|
|
|
|
To generate such a plot, used \c JKQTPFilledCurveXGraph::setFillMode(JKQTPFilledCurveXGraph::FillMode::TwoColorFilling)
|
|
and then use \c JKQTPFilledCurveXGraph::fillStyleBelow() to access the fill style for the area below the baseline
|
|
and the default fill style to define the fill style above the baseline.
|
|
|
|
\see \ref JKQTPlotterWigglePlots
|
|
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledCurveXGraph: public JKQTPFilledCurveGraphBase {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveXGraph(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveXGraph(JKQTPlotter* parent);
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
void draw(JKQTPEnhancedPainter &painter) override;
|
|
|
|
/** \brief get the maximum and minimum y-value of the graph
|
|
*
|
|
* The result is given in the two parameters which are call-by-reference parameters!
|
|
*/
|
|
virtual bool getYMinMax(double& miny, double& maxy, double& smallestGreaterZero) override;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*! \brief This implements filled curve plots with y errors where the area is filled between the plot line and the x-Axis.
|
|
\ingroup jkqtplotter_filledgraphs
|
|
|
|
\image html JKQTPFilledCurveXErrorGraph.png
|
|
|
|
|
|
\see \ref JKQTPlotterFilledGraphs, jkqtpstatAddXErrorFilledCurveGraph()
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledCurveXErrorGraph: public JKQTPFilledCurveXGraph, public JKQTPYGraphErrors {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveXErrorGraph(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveXErrorGraph(JKQTPlotter* parent);
|
|
/** \copydoc JKQTPGraph::usesColumn() */
|
|
virtual bool usesColumn(int c) const override;
|
|
/** \brief get the maximum and minimum y-value of the graph
|
|
*
|
|
* The result is given in the two parameters which are call-by-reference parameters!
|
|
*/
|
|
virtual bool getYMinMax(double& miny, double& maxy, double& smallestGreaterZero) override;
|
|
|
|
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorSymmetric */
|
|
inline void setValueErrorSymmetric(bool __value) {
|
|
setYErrorSymmetric(__value);
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorSymmetric */
|
|
inline bool getValueErrorSymmetric() const {
|
|
return getYErrorSymmetric();
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorColumnLower */
|
|
inline int getValueErrorColumnLower() const {
|
|
return getYErrorColumnLower();
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorColumn */
|
|
inline int getValueErrorColumn() const {
|
|
return getYErrorColumn();
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorStyle */
|
|
inline void setValueErrorStyle(JKQTPErrorPlotstyle __value) {
|
|
setYErrorStyle(__value);
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorStyle */
|
|
inline JKQTPErrorPlotstyle getValueErrorStyle() const {
|
|
return getYErrorStyle();
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorColumn */
|
|
inline void setValueErrorColumn(int __value) {
|
|
setYErrorColumn(__value);
|
|
}
|
|
/** \copydoc JKQTPYGraphErrorData::yErrorColumnLower */
|
|
inline void setValueErrorColumnLower(int __value) {
|
|
setYErrorColumnLower(__value);
|
|
}
|
|
protected:
|
|
/** \brief this function is used to plot error inidcators before plotting the graphs. */
|
|
virtual void drawErrorsAfter(JKQTPEnhancedPainter& painter) override;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/*! \brief This implements filled curve plots where the area is filled between the plot line and y-Axis
|
|
\ingroup jkqtplotter_filledgraphs
|
|
|
|
\image html JKQTPFilledCurveYGraph.png
|
|
|
|
\see \ref JKQTPlotterFilledGraphs
|
|
|
|
This class also provides the possibility to file above and below the baseline with different style.
|
|
Such plots are sometimes called "Wiggle Plots" and are often used (in their black/white-variety for seismographic
|
|
data plotting.
|
|
|
|
* \image html JKQTPFilledCurveYGraph_wiggle.png
|
|
|
|
To generate such a plot, used \c JKQTPFilledCurveXGraph::setFillMode(JKQTPFilledCurveXGraph::FillMode::TwoColorFilling)
|
|
and then use \c JKQTPFilledCurveXGraph::fillStyleBelow() to access the fill style for the area below the baseline
|
|
and the default fill style to define the fill style above the baseline.
|
|
|
|
\see \ref JKQTPlotterWigglePlots
|
|
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledCurveYGraph: public JKQTPFilledCurveGraphBase {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveYGraph(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveYGraph(JKQTPlotter* parent);
|
|
|
|
/** \brief get the maximum and minimum x-value of the graph
|
|
*
|
|
* The result is given in the two parameters which are call-by-reference parameters!
|
|
*/
|
|
virtual bool getXMinMax(double& minx, double& maxx, double& smallestGreaterZero) override;
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
void draw(JKQTPEnhancedPainter &painter) override;
|
|
/** \brief returns the column used as "key" for the current graph (typically this call getXColumn(), but for horizontal graphs like filled curves or barcharts it may call getYColumn() ) */
|
|
virtual int getKeyColumn() const override;
|
|
/** \brief returns the column used as "value" for the current graph (typically this call getXColumn(), but for horizontal graphs like filled curves or barcharts it may call getYColumn() ) */
|
|
virtual int getValueColumn() const override;
|
|
public Q_SLOTS:
|
|
/** \brief sets the column used as "key" for the current graph (typically this call setXColumn(), but for horizontal graphs like filled curves or barcharts it may call setYColumn() ) */
|
|
virtual void setKeyColumn(int __value) override;
|
|
/** \brief sets the column used as "value" for the current graph (typically this call setXColumn(), but for horizontal graphs like filled curves or barcharts it may call setYColumn() ) */
|
|
virtual void setValueColumn(int __value) override;
|
|
|
|
};
|
|
|
|
|
|
|
|
/*! \brief This implements filled curve plots with y errors where the area is filled between the plot line and the x-Axis.
|
|
\ingroup jkqtplotter_filledgraphs
|
|
|
|
\image html JKQTPFilledCurveYErrorGraph.png
|
|
|
|
\see \ref JKQTPlotterFilledGraphs, jkqtpstatAddYErrorFilledCurveGraph()
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledCurveYErrorGraph: public JKQTPFilledCurveYGraph, public JKQTPXGraphErrors {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledCurveYErrorGraph(JKQTBasePlotter* parent=nullptr);
|
|
JKQTPFilledCurveYErrorGraph(JKQTPlotter* parent);
|
|
/** \copydoc JKQTPGraph::usesColumn() */
|
|
virtual bool usesColumn(int c) const override;
|
|
|
|
/** \brief get the maximum and minimum x-value of the graph
|
|
*
|
|
* The result is given in the two parameters which are call-by-reference parameters!
|
|
*/
|
|
virtual bool getXMinMax(double& minx, double& maxx, double& smallestGreaterZero) override;
|
|
|
|
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorSymmetric */
|
|
inline void setValueErrorSymmetric(bool __value) {
|
|
setXErrorSymmetric(__value);
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorSymmetric */
|
|
inline bool getValueErrorSymmetric() const {
|
|
return getXErrorSymmetric();
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorColumnLower */
|
|
inline int getValueErrorColumnLower() const {
|
|
return getXErrorColumnLower();
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorColumn */
|
|
inline int getValueErrorColumn() const {
|
|
return getXErrorColumn();
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorStyle */
|
|
inline void setValueErrorStyle(JKQTPErrorPlotstyle __value) {
|
|
setXErrorStyle(__value);
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorStyle */
|
|
inline JKQTPErrorPlotstyle getValueErrorStyle() const {
|
|
return getXErrorStyle();
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorColumn */
|
|
inline void setValueErrorColumn(int __value) {
|
|
setXErrorColumn(__value);
|
|
}
|
|
/** \copydoc JKQTPXGraphErrorData::xErrorColumnLower */
|
|
inline void setValueErrorColumnLower(int __value) {
|
|
setXErrorColumnLower(__value);
|
|
}
|
|
protected:
|
|
/** \brief this function is used to plot error inidcators before plotting the graphs. */
|
|
virtual void drawErrorsAfter(JKQTPEnhancedPainter& painter) override;
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** \brief This implements filled curve plots where the area is filled between two data columns for each x-value
|
|
* \ingroup jkqtplotter_filledgraphs
|
|
*
|
|
* With \c setDrawlines(false):
|
|
*
|
|
* \image html JKQTPfilledVerticalRangeGraph.png
|
|
*
|
|
* With \c setDrawlines(true):
|
|
*
|
|
* \image html JKQTPfilledVerticalRangeGraph_WithLines.png
|
|
*
|
|
* \see JKQTPFilledHorizontalRangeGraph, \ref JKQTPlotterDateTimeAxes
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledVerticalRangeGraph: public JKQTPXYYGraph, public JKQTPGraphLineAndFillStyleMixin {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledVerticalRangeGraph(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPFilledVerticalRangeGraph(JKQTPlotter* parent);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter) override;
|
|
/** \brief plots a key marker inside the specified rectangle \a rect */
|
|
virtual void drawKeyMarker(JKQTPEnhancedPainter& painter, const QRectF& rect) override;
|
|
/** \brief returns the color to be used for the key label */
|
|
virtual QColor getKeyLabelColor() const override;
|
|
|
|
|
|
protected:
|
|
|
|
|
|
};
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
/** \brief This implements filled curve plots where the area is filled between two data columns for each y-value
|
|
* \ingroup jkqtplotter_filledgraphs
|
|
*
|
|
* With \c setDrawlines(false):
|
|
*
|
|
* \image html JKQTPFilledHorizontalRangeGraph.png
|
|
*
|
|
* With \c setDrawlines(true):
|
|
*
|
|
* \image html JKQTPFilledHorizontalRangeGraph_WithLines.png
|
|
*
|
|
* \see JKQTPFilledVerticalRangeGraph, \ref JKQTPlotterDateTimeAxes
|
|
*/
|
|
class JKQTPLOTTER_LIB_EXPORT JKQTPFilledHorizontalRangeGraph: public JKQTPXXYGraph, public JKQTPGraphLineAndFillStyleMixin {
|
|
Q_OBJECT
|
|
public:
|
|
/** \brief class constructor */
|
|
JKQTPFilledHorizontalRangeGraph(JKQTBasePlotter* parent=nullptr);
|
|
/** \brief class constructor */
|
|
JKQTPFilledHorizontalRangeGraph(JKQTPlotter* parent);
|
|
|
|
/** \brief plots the graph to the plotter object specified as parent */
|
|
virtual void draw(JKQTPEnhancedPainter& painter) override;
|
|
/** \brief plots a key marker inside the specified rectangle \a rect */
|
|
virtual void drawKeyMarker(JKQTPEnhancedPainter& painter, const QRectF& rect) override;
|
|
/** \brief returns the color to be used for the key label */
|
|
virtual QColor getKeyLabelColor() const override;
|
|
|
|
|
|
protected:
|
|
|
|
|
|
};
|
|
|
|
|
|
#endif // jkqtpgraphsfilledcurve_H
|