/* Copyright (c) 2008-2019 Jan W. Krieger () 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 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 . */ /** \file jkqtpgraphsbarchart.h * \ingroup jkqtplotter_barssticks */ #include #include #include #include "jkqtplottertools/jkqtptools.h" #include "jkqtplottertools/jkqtp_imexport.h" #include "jkqtplottertools/jkqtpimagetools.h" #include "jkqtplotter/jkqtpgraphsbase.h" #ifndef jkqtpgraphsbarchart_H #define jkqtpgraphsbarchart_H /*! \brief This implements a bar graph with bars starting at \f$ y=0 \f$ to \f$ y=f(x) \f$ \ingroup jkqtplotter_barssticks This class plots a bargraph. This image explains the parameters: \image html bargraph_basics.png By default the sift parameter is, so the bar is centered at the x-value. The width is 0.9, so adjacent bars are plotted with a small distance between them. It is possible to use these two parameters to plot multiple bars for every x-value, by having on JKQTPStepHorizontalGraph object per set of bars that belong together. For example for three bars per x-value one would set: \verbatim width=0.3 shift=-0.3 / 0 / +0.3 \endverbatim This results in a bargraph, as shown here: \image html plot_bargraphverplot.png You can use JKQTPlotter::addHorizontalBargraph() to add a series of bargraphs, where the width and shift are determined automatically. The y-columns are given as a QVector to this function. */ class LIB_EXPORT JKQTPBarVerticalGraph: public JKQTPXYGraph { Q_OBJECT public: /** \brief class constructor */ JKQTPBarVerticalGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarVerticalGraph(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, QRectF& rect) override; /** \brief returns the color to be used for the key label */ virtual QColor getKeyLabelColor() 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; /** \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 finds all bar charts of the same orientation and determines width and shift, so they stand side by side * * \param maxWidth the maximum (relative) width, that all bars will span of the (doubled) inter-bar distance * \param shrinkFactor factor, by which the bar are shrinked compared to the available space * * \note This function will scale ALL graphs of the parent plot, which were derived from JKQTPBarHorizontalGraph, that match in orientation (as returned by isHorizontal() ). */ virtual void autoscaleBarWidthAndShift(double maxWidth=0.9, double shrinkFactor=0.8); void autoscaleBarWidthAndShiftSeparatedGroups(double groupWidth=0.75); virtual bool isHorizontal() const; /*! \brief sets the property color ( \copybrief color ) to the specified \a __value. \details Description of the parameter color is:
\copydoc color
\see color for more information */ inline virtual void setColor(const QColor & __value) { this->color = __value; } /*! \brief returns the property color ( \copybrief color ). \details Description of the parameter color is:
\copydoc color
\see color for more information */ inline virtual QColor getColor() const { return this->color; } /*! \brief sets the property fillColor ( \copybrief fillColor ) to the specified \a __value. \details Description of the parameter fillColor is:
\copydoc fillColor
\see fillColor for more information */ inline virtual void setFillColor(const QColor & __value) { this->fillColor = __value; } /*! \brief returns the property fillColor ( \copybrief fillColor ). \details Description of the parameter fillColor is:
\copydoc fillColor
\see fillColor for more information */ inline virtual QColor getFillColor() const { return this->fillColor; } /*! \brief sets the property fillStyle ( \copybrief fillStyle ) to the specified \a __value. \details Description of the parameter fillStyle is:
\copydoc fillStyle
\see fillStyle for more information */ inline virtual void setFillStyle(const Qt::BrushStyle & __value) { this->fillStyle = __value; } /*! \brief returns the property fillStyle ( \copybrief fillStyle ). \details Description of the parameter fillStyle is:
\copydoc fillStyle
\see fillStyle for more information */ inline virtual Qt::BrushStyle getFillStyle() const { return this->fillStyle; } /*! \brief sets the property style ( \copybrief style ) to the specified \a __value. \details Description of the parameter style is:
\copydoc style
\see style for more information */ inline virtual void setStyle(const Qt::PenStyle & __value) { this->style = __value; } /*! \brief returns the property style ( \copybrief style ). \details Description of the parameter style is:
\copydoc style
\see style for more information */ inline virtual Qt::PenStyle getStyle() const { return this->style; } /*! \brief sets the property lineWidth ( \copybrief lineWidth ) to the specified \a __value. \details Description of the parameter lineWidth is:
\copydoc lineWidth
\see lineWidth for more information */ inline virtual void setLineWidth(double __value) { this->lineWidth = __value; } /*! \brief returns the property lineWidth ( \copybrief lineWidth ). \details Description of the parameter lineWidth is:
\copydoc lineWidth
\see lineWidth for more information */ inline virtual double getLineWidth() const { return this->lineWidth; } /*! \brief sets the property shift ( \copybrief shift ) to the specified \a __value. \details Description of the parameter shift is:
\copydoc shift
\see shift for more information */ inline virtual void setShift(double __value) { this->shift = __value; } /*! \brief returns the property shift ( \copybrief shift ). \details Description of the parameter shift is:
\copydoc shift
\see shift for more information */ inline virtual double getShift() const { return this->shift; } /*! \brief sets the property width ( \copybrief width ) to the specified \a __value. \details Description of the parameter width is:
\copydoc width
\see width for more information */ inline virtual void setWidth(double __value) { this->width = __value; } /*! \brief returns the property width ( \copybrief width ). \details Description of the parameter width is:
\copydoc width
\see width for more information */ inline virtual double getWidth() const { return this->width; } /*! \brief sets the property baseline ( \copybrief baseline ) to the specified \a __value. \details Description of the parameter baseline is:
\copydoc baseline
\see baseline for more information */ inline virtual void setBaseline(double __value) { this->baseline = __value; } /*! \brief returns the property baseline ( \copybrief baseline ). \details Description of the parameter baseline is:
\copydoc baseline
\see baseline for more information */ inline virtual double getBaseline() const { return this->baseline; } /** \brief sets the fill color and the color together, where fillColor is set to \a fill and the line-color is set to \c fill.darker(colorDarker) */ void setFillColor_and_darkenedColor(QColor fill, int colorDarker=200); protected: /** \brief color of the graph */ QColor color; /** \brief color of the graph fill */ QColor fillColor; /** \brief linestyle of the graph lines */ Qt::PenStyle style; /** \brief width (pt) of the graph, given in pt */ double lineWidth; /** \brief fill style, if the curve should be filled */ Qt::BrushStyle fillStyle; /** \brief the width of the bargraphs, relative to the distance between the current and the next x-value * * See the following graphic to understand this concept: * \image html bargraph_basics.png */ double width; /** \brief the shift of the bargraphs, relative to the distance between the current and the next x-value * * See the following graphic to understand this concept: * \image html bargraph_basics.png */ double shift; /** \brief baseline of the plot (NOTE: 0 is interpreted as until plot border in log-mode!!!) */ double baseline; /** \brief which plot style to use from the parent plotter (via JKQTBasePlotter::getPlotStyle() and JKQTBasePlotter::getNextStyle() ) */ int parentPlotStyle; QBrush getBrush(JKQTPEnhancedPainter& painter) const; QPen getLinePen(JKQTPEnhancedPainter &painter) const; /** \brief used to generate stacked plots: returns the upper boundary of this plot in a stack, for the index-th datapoint * * \note This function returns \a baseline in this implementation. It is implemented in the derived classes JKQTPBarVerticalStackableGraph * and JKQTPBarHorizontalStackableGraph. The function is placed here, so the plotting does not have to be reimplemented in the * derived classes that allow for stacking, but can be implemented once centrally. */ virtual double getStackedMax(int index) const; /** \brief calls getStackedMax() on the stack parent (if available) * * \note This function returns \c 0.0 in this implementation. It is implemented in the derived classes JKQTPBarVerticalStackableGraph * and JKQTPBarHorizontalStackableGraph. The function is placed here, so the plotting does not have to be reimplemented in the * derived classes that allow for stacking, but can be implemented once centrally. */ virtual double getParentStackedMax(int index) const; /** \brief returns \c true, if a stack parent is set (if available) * * \note This function returns \c false in this implementation. It is implemented in the derived classes JKQTPBarVerticalStackableGraph * and JKQTPBarHorizontalStackableGraph. The function is placed here, so the plotting does not have to be reimplemented in the * derived classes that allow for stacking, but can be implemented once centrally. */ virtual bool hasStackParent() const; }; /*! \brief This implements a bar graph with bars starting at \f$ y=0 \f$ to \f$ y=f(x) \f$ * Optionally several graphs of this type may be stacked on top of each other * \ingroup jkqtplotter_barssticks * * Draw stacked barcharts by connecting several plots by calling \c setStackedParent(belowPlot) for each plot * \image html JKQTPBarVerticalGraphStacked.png * */ class LIB_EXPORT JKQTPBarVerticalStackableGraph: public JKQTPBarVerticalGraph { Q_OBJECT public: /** \brief class constructor */ JKQTPBarVerticalStackableGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarVerticalStackableGraph(JKQTPlotter* parent); /** \brief stacks this barchart upon the given \a parentGraph */ void stackUpon(JKQTPBarVerticalStackableGraph* parentGraph); /** \brief unstacks this graph (i.e. deletes the parent graph in the stack) */ void dontStackUpon(); /** \brief returns the stack parent graph, or \c nullptr */ const JKQTPBarVerticalStackableGraph* getStackParent() const; protected: /** \brief if set (!=nullptr), the current plot is drawn stacked onto this plot * * draw stacked barcharts by connecting several plots by calling \c setStackedParent(belowPlot) for each plot */ JKQTPBarVerticalStackableGraph* stackParent; /** \brief used to generate stacked plots: returns the upper boundary of this plot in a stack, for the index-th datapoint */ virtual double getStackedMax(int index) const override; /** \brief calls getStackedMax() on the stack parent (if available), or \c 0.0 */ virtual double getParentStackedMax(int index) const override; /** \brief returns \c true, if a stack parent is set (if available) */ virtual bool hasStackParent() const override; }; /*! \brief This implements a bar graph with bars starting at \f$ y=0 \f$ to \f$ y=f(x) \f$ * and error indicator * \ingroup jkqtplotter_barssticks * * This works much the same as JKQTPBarHorizontalGraph. Here is an example output: * \image html plot_bargraphverploterr.png * */ class LIB_EXPORT JKQTPBarVerticalErrorGraph: public JKQTPBarVerticalGraph, public JKQTPYGraphErrors { Q_OBJECT public: /** \brief class constructor */ JKQTPBarVerticalErrorGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarVerticalErrorGraph(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; protected: /** \brief this function is used to plot error inidcators before plotting the graphs. */ virtual void drawErrorsAfter(JKQTPEnhancedPainter& painter) override; }; /*! \brief This implements a bar graph with bars starting at \f$ x=0 \f$ to \f$ x=f(y) \f$ \ingroup jkqtplotter_barssticks This works much the same as JKQTPBarHorizontalGraph. Here is an example output: \image html plot_bargraphhorplot.png */ class LIB_EXPORT JKQTPBarHorizontalGraph: public JKQTPBarVerticalGraph { Q_OBJECT public: /** \brief class constructor */ JKQTPBarHorizontalGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarHorizontalGraph(JKQTPlotter* parent); /** \brief plots the graph to the plotter object specified as parent */ virtual void draw(JKQTPEnhancedPainter& painter) 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; /** \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; virtual bool isHorizontal() const override; }; /*! \brief This implements a bar graph with bars starting at \f$ y=0 \f$ to \f$ y=f(x) \f$ * Optionally several graphs of this type may be stacked on top of each other * \ingroup jkqtplotter_barssticks * * Draw stacked barcharts by connecting several plots by calling \c setStackedParent(belowPlot) for each plot * \image html JKQTPBarHorizontalGraphStacked.png * */ class LIB_EXPORT JKQTPBarHorizontalStackableGraph: public JKQTPBarHorizontalGraph { Q_OBJECT public: /** \brief class constructor */ JKQTPBarHorizontalStackableGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarHorizontalStackableGraph(JKQTPlotter* parent); /** \brief stacks this barchart upon the given \a parentGraph */ void stackUpon(JKQTPBarHorizontalStackableGraph* parentGraph); /** \brief unstacks this graph (i.e. deletes the parent graph in the stack) */ void dontStackUpon(); /** \brief returns the stack parent graph, or \c nullptr */ const JKQTPBarHorizontalStackableGraph* getStackParent() const; protected: /** \brief if set (!=nullptr), the current plot is drawn stacked onto this plot * * draw stacked barcharts by connecting several plots by calling \c setStackedParent(belowPlot) for each plot */ JKQTPBarHorizontalStackableGraph* stackParent; /** \brief used to generate stacked plots: returns the upper boundary of this plot in a stack, for the index-th datapoint */ virtual double getStackedMax(int index) const override; /** \brief calls getStackedMax() on the stack parent (if available), or \c 0.0 */ virtual double getParentStackedMax(int index) const override; /** \brief returns \c true, if a stack parent is set (if available) */ virtual bool hasStackParent() const override; }; /*! \brief This implements a bar graph with bars starting at \f$ x=0 \f$ to \f$ x=f(y) \f$ * and error indicator * \ingroup jkqtplotter_barssticks * * This works much the same as JKQTPBarHorizontalGraph. Here is an example output: * \image html plot_bargraphhorploterr.png * */ class LIB_EXPORT JKQTPBarHorizontalErrorGraph: public JKQTPBarHorizontalGraph, public JKQTPXGraphErrors { Q_OBJECT public: /** \brief class constructor */ JKQTPBarHorizontalErrorGraph(JKQTBasePlotter* parent=nullptr); /** \brief class constructor */ JKQTPBarHorizontalErrorGraph(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; protected: /** \brief this function is used to plot error inidcators before plotting the graphs. */ virtual void drawErrorsAfter(JKQTPEnhancedPainter& painter) override; }; #endif // jkqtpgraphsbarchart_H