From ebd1a29e1dd0ea7cfab1b6d3bb25ff50fe5713b9 Mon Sep 17 00:00:00 2001
From: jkriege2 <jan@jkrieger.de>
Date: Sat, 27 May 2023 23:46:45 +0200
Subject: [PATCH] BREAKING: Implement better/more access functions to the
 graphs (inlcuding sorting, moving up/down, appending/prepending,
 graphs-iterators ...), solves issue #97

---
 doc/dox/whatsnew.dox                   |   1 +
 lib/jkqtplotter/gui/jkqtpgraphsmodel.h |   2 +-
 lib/jkqtplotter/jkqtpbaseplotter.cpp   | 198 +++++--
 lib/jkqtplotter/jkqtpbaseplotter.h     | 761 ++++++++++++++++---------
 lib/jkqtplotter/jkqtplotter.h          | 181 +++---
 5 files changed, 722 insertions(+), 421 deletions(-)

diff --git a/doc/dox/whatsnew.dox b/doc/dox/whatsnew.dox
index d5bf9b31fa..083345a5b4 100644
--- a/doc/dox/whatsnew.dox
+++ b/doc/dox/whatsnew.dox
@@ -22,6 +22,7 @@ Changes, compared to  \ref page_whatsnew_V4_0_0 "v4.0.0" include:
     <li>NEW: When using a MSVC compiler, the generated PDB files are installed to \c CMAKE_INSTALL_PREFIX/bin/ </li>    
   </ul></li>
   <li>JKQTPlotter:<ul>
+    <li>BREAKING/REWORKED: Implement better/more access functions to the graphs (inlcuding sorting, moving up/down, appending/prepending, graphs-iterators ...), solves issue #97</li>
     <li>FIXED issue described in <a href="https://github.com/jkriege2/JKQtPlotter/pull/62">#62: Fix custom labels draw, because giving exactly two label-strings did not display all of them</a>, thanks to <a href="https://github.com/FalsinSoft">user:FalsinSoft</a></li>
     <li>FIXED issue <a href="https://github.com/jkriege2/JKQtPlotter/pull/70">#70: Typo in jkqtplotter/CMakeLists.txt</a>, thanks to <a href="https://github.com/tedlinlab">user:tedlinlab</a></li>
     <li>FIXED issue <a href="https://github.com/jkriege2/JKQtPlotter/pull/80">#80: Bug with multiple inheritance with Q_GDAGET with CLANG</a>, thanks to <a href="https://github.com/igormironchik">user:igormironchik</a>, caused by <a href="https://bugreports.qt.io/browse/QTBUG-104874">QTBUG-104874</a></li>
diff --git a/lib/jkqtplotter/gui/jkqtpgraphsmodel.h b/lib/jkqtplotter/gui/jkqtpgraphsmodel.h
index 89c8c33bd8..0cdfb3f7b8 100644
--- a/lib/jkqtplotter/gui/jkqtpgraphsmodel.h
+++ b/lib/jkqtplotter/gui/jkqtpgraphsmodel.h
@@ -37,7 +37,7 @@ class JKQTBasePlotter; // forward
   * \image html JKQTPgraphsModel.png
   *
   */
-class JKQTPGraphsModel : public QAbstractTableModel
+class JKQTPLOTTER_LIB_EXPORT JKQTPGraphsModel : public QAbstractTableModel
 {
     Q_OBJECT
 public:
diff --git a/lib/jkqtplotter/jkqtpbaseplotter.cpp b/lib/jkqtplotter/jkqtpbaseplotter.cpp
index c756abf540..9a38b97fc2 100644
--- a/lib/jkqtplotter/jkqtpbaseplotter.cpp
+++ b/lib/jkqtplotter/jkqtpbaseplotter.cpp
@@ -372,7 +372,7 @@ void JKQTBasePlotter::useAsInternalDatastore(JKQTPDatastore* newStore){
     }
     datastore=newStore;
     datastoreInternal=true;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::useInternalDatastore(){
@@ -380,7 +380,7 @@ void JKQTBasePlotter::useInternalDatastore(){
         datastore=new JKQTPDatastore();
         datastoreInternal=true;
     }
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::forceInternalDatastore(){
@@ -390,7 +390,7 @@ void JKQTBasePlotter::forceInternalDatastore(){
     }
     datastore=new JKQTPDatastore();
     datastoreInternal=true;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 bool JKQTBasePlotter::isEmittingSignalsEnabled() const {
@@ -427,7 +427,7 @@ void JKQTBasePlotter::initSettings() {
 
     plotLabel="";
 
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 
@@ -449,7 +449,7 @@ void JKQTBasePlotter::zoomIn(double factor) {
         ax->setRange(ymin, ymax);
     }
 
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
     if (emitSignals) emit zoomChangedLocally(xAxis->getMin(), xAxis->getMax(), yAxis->getMin(), yAxis->getMax(), this);
 }
 
@@ -478,7 +478,7 @@ void JKQTBasePlotter::zoom(double nxmin, double nxmax, double nymin, double nyma
 
     xAxis->setRange(xmin, xmax);
     yAxis->setRange(ymin, ymax);
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
     if (emitSignals) emit zoomChangedLocally(xAxis->getMin(), xAxis->getMax(), yAxis->getMin(), yAxis->getMax(), this);
 }
 
@@ -486,7 +486,7 @@ void JKQTBasePlotter::setWidgetSize(int wid, int heigh) {
     widgetWidth=wid;
     widgetHeight=heigh;
 
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 int JKQTBasePlotter::getWidth() {
@@ -544,12 +544,12 @@ void JKQTBasePlotter::clearGridPrintingPlotters() {
 
 void JKQTBasePlotter::setWidgetWidth(int wid) {
     widgetWidth=wid;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setWidgetHeight(int heigh) {
     widgetHeight=heigh;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::saveSettings(QSettings& settings, const QString& group) const{
@@ -611,7 +611,7 @@ void JKQTBasePlotter::propagateStyle() {
         }
     }
     emitPlotSignals=old;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::loadCurrentPlotterStyle(const QSettings &settings, const QString &group)
@@ -703,7 +703,7 @@ void JKQTBasePlotter::loadSettings(const QSettings &settings, const QString& gro
 
     loadUserSettings();
 
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 
@@ -4205,31 +4205,31 @@ void JKQTBasePlotter::setPlotBorder(int left, int right, int top, int bottom){
     plotterStyle.plotBorderBottom=bottom;
     plotterStyle.plotBorderRight=right;
     //updateGeometry();
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setPlotBorderLeft(int left)
 {
     plotterStyle.plotBorderLeft=left;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setPlotBorderRight(int right)
 {
     plotterStyle.plotBorderRight=right;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setPlotBorderTop(int top)
 {
     plotterStyle.plotBorderTop=top;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setPlotBorderBottom(int bottom)
 {
     plotterStyle.plotBorderBottom=bottom;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::synchronizeToMaster(JKQTBasePlotter* master, SynchronizationDirection synchronizeDirection, bool synchronizeAxisLength, bool synchronizeZoomingMasterToSlave, bool synchronizeZoomingSlaveToMaster) {
@@ -4874,7 +4874,11 @@ JKQTPPlotElement* JKQTBasePlotter::getGraph(size_t i) {
     return graphs[static_cast<int>(i)];
 };
 
-size_t JKQTBasePlotter::getGraphCount() {
+const JKQTPPlotElement* JKQTBasePlotter::getGraph(size_t i) const {
+    return graphs[static_cast<int>(i)];
+};
+
+size_t JKQTBasePlotter::getGraphCount() const {
     return static_cast<size_t>(graphs.size());
 };
 
@@ -4883,18 +4887,18 @@ void JKQTBasePlotter::deleteGraph(size_t i, bool deletegraph) {
     JKQTPPlotElement* g=graphs[static_cast<int>(i)];
     graphs.removeAt(static_cast<int>(i));
     if (deletegraph && g) delete g;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 };
 
 void JKQTBasePlotter::deleteGraph(JKQTPPlotElement* gr, bool deletegraph) {
-    int i=graphs.indexOf(gr);
+    int i=indexOfGraph(gr);
     while (i>=0) {
         graphs.removeAt(i);
-        i=graphs.indexOf(gr);
+        i=indexOfGraph(gr);
     }
 
     if (deletegraph && gr) delete gr;
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::clearGraphs(bool deleteGraphs) {
@@ -4904,7 +4908,7 @@ void JKQTBasePlotter::clearGraphs(bool deleteGraphs) {
     }
     graphs.clear();
     usedStyles.clear();
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setAllGraphsInvisible()
@@ -4913,7 +4917,7 @@ void JKQTBasePlotter::setAllGraphsInvisible()
         JKQTPPlotElement* g=graphs[i];
         g->setVisible(false);
     }
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setAllGraphsVisible()
@@ -4922,14 +4926,19 @@ void JKQTBasePlotter::setAllGraphsVisible()
         JKQTPPlotElement* g=graphs[i];
         g->setVisible(true);
     }
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setGraphVisible(int i, bool visible)
 {
     JKQTPPlotElement* g=graphs.value(i, nullptr);
     if (g) g->setVisible(visible);
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
+}
+
+void JKQTBasePlotter::setGraphInvisible(int i)
+{
+    setGraphVisible(i, false);
 }
 
 void JKQTBasePlotter::setOnlyGraphVisible(int gr)
@@ -4940,7 +4949,7 @@ void JKQTBasePlotter::setOnlyGraphVisible(int gr)
     }
     JKQTPPlotElement* g=graphs.value(gr, nullptr);
     if (g) g->setVisible(true);
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
 void JKQTBasePlotter::setOnlyNthGraphsVisible(int start, int n)
@@ -4953,53 +4962,122 @@ void JKQTBasePlotter::setOnlyNthGraphsVisible(int start, int n)
         JKQTPPlotElement* g=graphs.value(i, nullptr);
         if (g) g->setVisible(true);
     }
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
 }
 
-size_t JKQTBasePlotter::addGraph(JKQTPPlotElement* gr) {
+size_t JKQTBasePlotter::addGraphOnTop(JKQTPPlotElement* gr) {
     gr->setParent(this);
-    for (int i=0; i<graphs.size(); i++) {
-        if (graphs[i]==gr) return static_cast<size_t>(i);
+    const int indexGR=indexOfGraph(gr);
+    if (indexGR>=0) {
+        graphs.removeAt(indexGR);
     }
     graphs.push_back(gr);
-    if (emitPlotSignals) emit plotUpdated();
-    return static_cast<size_t>(graphs.size()-1);
-};
-
-size_t JKQTBasePlotter::moveGraphTop(JKQTPPlotElement* gr) {
-    gr->setParent(this);
-    for (int i=0; i<graphs.size(); i++) {
-        if (graphs[i]==gr) {
-            if (i<graphs.size()-1) {
-                graphs.removeAt(i);
-                graphs.push_back(gr);
-            }
-            return static_cast<size_t>(graphs.size()-1);
-        }
-    }
-    graphs.push_back(gr);
-    if (emitPlotSignals) emit plotUpdated();
+    redrawPlot();
     return static_cast<size_t>(graphs.size()-1);
 }
 
-size_t JKQTBasePlotter::moveGraphBottom(JKQTPPlotElement *gr)
-{
+size_t JKQTBasePlotter::addGraphAtBottom(JKQTPPlotElement* gr) {
     gr->setParent(this);
-    for (int i=0; i<graphs.size(); i++) {
-        if (graphs[i]==gr) {
-            if (i<graphs.size()-1) {
-                graphs.removeAt(i);
-                graphs.push_front(gr);
-            }
-            return 0;
-        }
+    const int indexGR=indexOfGraph(gr);
+    if (indexGR>=0) {
+        graphs.removeAt(indexGR);
     }
     graphs.push_front(gr);
-    if (emitPlotSignals) emit plotUpdated();
-    return static_cast<size_t>(graphs.size()-1);
+    redrawPlot();
+    return static_cast<size_t>(0);
+
+}
+
+void JKQTBasePlotter::moveGraphTop(int idx) {
+    if (idx>=0 && idx<graphs.size()) {
+        JKQTPPlotElement* g=graphs[idx];
+        graphs.removeAt(idx);
+        graphs.push_back(g);
+        redrawPlot();
+    } else {
+        throw std::out_of_range("index out of range in JKQTBasePlotter::moveGraphTop()");
+    }
+}
+
+void JKQTBasePlotter::moveGraphBottom(int idx)
+{
+    if (idx>=0 && idx<graphs.size()) {
+        JKQTPPlotElement* g=graphs[idx];
+        graphs.removeAt(idx);
+        graphs.push_front(g);
+        redrawPlot();
+    } else {
+        throw std::out_of_range("index out of range in JKQTBasePlotter::moveGraphBottom()");
+    }
+}
+
+int JKQTBasePlotter::indexOfGraph(const JKQTPPlotElement *gr) const
+{
+    for (int i=0; i<graphs.size(); i++) {
+        if (graphs[i]==gr) return i;
+    }
+    return -1;
+}
+
+void JKQTBasePlotter::moveGraphUp(int idx)
+{
+    if (idx>=0 && idx<graphs.size()) {
+        if (idx+1<graphs.size()) {
+            graphs.move(idx, idx+1);
+            redrawPlot();
+        }
+    } else {
+        throw std::out_of_range("index out of range in JKQTBasePlotter::moveGraphUp()");
+    }
+}
+
+void JKQTBasePlotter::moveGraphDown(int idx)
+{
+    if (idx>=0 && idx<graphs.size()) {
+        if (idx-1>=0) {
+            graphs.move(idx-1, idx);
+            redrawPlot();
+        }
+    } else {
+        throw std::out_of_range("index out of range in JKQTBasePlotter::moveGraphDown()");
+    }
+}
+
+void JKQTBasePlotter::moveGraphUp(const JKQTPPlotElement *gr) {
+    moveGraphUp(indexOfGraph(gr));
+}
+
+void JKQTBasePlotter::moveGraphDown(const JKQTPPlotElement *gr)
+{
+    moveGraphDown(indexOfGraph(gr));
+}
+
+void JKQTBasePlotter::moveGraphTop(const JKQTPPlotElement *gr) {
+    moveGraphTop(indexOfGraph(gr));
+}
+
+void JKQTBasePlotter::moveGraphBottom(const JKQTPPlotElement *gr)
+{
+    moveGraphBottom(indexOfGraph(gr));
+}
+
+void JKQTBasePlotter::modifyGraphs(const std::function<void (JKQTPPlotElement *)> &func)
+{
+    if (!func) return;
+    for (int i=0; i<graphs.size(); i++) {
+        func(graphs[i]);
+    }
+    redrawPlot();
+}
+
+void JKQTBasePlotter::sortGraphs(const std::function<bool (const JKQTPPlotElement *, const JKQTPPlotElement *)> &compareLess)
+{
+    if (!compareLess) return;
+    std::sort(graphs.begin(), graphs.end(), compareLess);
+    redrawPlot();
 };
 
-bool JKQTBasePlotter::containsGraph(JKQTPPlotElement* gr) const {
+bool JKQTBasePlotter::containsGraph(const JKQTPPlotElement* gr) const {
     for (int i=0; i<graphs.size(); i++) {
         if (graphs[i]==gr) {
             return true;
diff --git a/lib/jkqtplotter/jkqtpbaseplotter.h b/lib/jkqtplotter/jkqtpbaseplotter.h
index 22e2521b89..acb4917c72 100644
--- a/lib/jkqtplotter/jkqtpbaseplotter.h
+++ b/lib/jkqtplotter/jkqtpbaseplotter.h
@@ -407,6 +407,11 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
 
 
 
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Konstruktion and Destruction */
+/**@{*/
+
         /** \brief class constructor
          *
          * if \a datastore_internal is \c true then the constructor will create an internal datastore object. The datastore
@@ -419,20 +424,21 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
 
         /** \brief class destructor */
         virtual ~JKQTBasePlotter();
+/**@}*/
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Plot Data Storage/Management (JKQTPDatastore) */
+/**@{*/
 
         /** \brief returns a pointer to the datastore used by this object */
         inline JKQTPDatastore* getDatastore() { return datastore; }
 
-        /** \brief returns model representing all Plots in this plotter and showing their visible/invisible state */
-        inline JKQTPGraphsModel* getPlotsModel() { return m_plotsModel; }
 
 
         /** \brief returns a pointer to the datastore used by this object */
         inline const JKQTPDatastore* getDatastore() const { return datastore; }
 
-        /** \brief returns model representing all Plots in this plotter and showing their visible/invisible state */
-        inline const JKQTPGraphsModel* getPlotsModel() const { return m_plotsModel; }
-
         /** \brief tells the plotter object to use the given external datastore.
          *
          * If the current datastore is internally managed, this method will free that object and use the supplied datastore
@@ -456,11 +462,256 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
          *         the lather case */
         void forceInternalDatastore();
 
-        /** \brief returns whether this class emits signals, like zoomChangedLocally() or beforePlotScalingRecaluclate() */
-        bool isEmittingSignalsEnabled()const;
-        /** \brief specifies whether this class emits signals, like zoomChangedLocally() or beforePlotScalingRecaluclate() */
-        void setEmittingSignalsEnabled(bool enabled);
 
+        /** \brief save the current plot data as a Comma Separated Values (CSV) file
+         *
+         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
+         * \param decimalSeparator decimal separator for outpu
+         * \param commentInitializer line-start for comment lines
+         */
+        void saveAsCSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);
+
+        /** \brief save the current plot data as a Semicolon Separated Values (SSV) file
+         *
+         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
+         * \param decimalSeparator decimal separator for outpu
+         * \param commentInitializer line-start for comment lines
+         */
+        void saveAsSemicolonSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);        /** \brief save the current plot data as a Tabulator Separated Values (CSV) file
+         *
+         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
+         * \param decimalSeparator decimal separator for outpu
+         * \param commentInitializer line-start for comment lines
+         */
+        void saveAsTabSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);
+
+/**@}*/
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Graphs Management */
+/**@{*/
+
+        typedef QVector<JKQTPPlotElement*> GraphsList;
+        typedef QVector<JKQTPPlotElement*>::iterator GraphsIterator;
+        typedef QVector<JKQTPPlotElement*>::const_iterator GraphsConstIterator;
+
+        /** \brief returns model representing all Plots in this plotter and showing their visible/invisible state */
+        inline const JKQTPGraphsModel* getPlotsModel() const { return m_plotsModel; }
+
+        /** \brief returns model representing all Plots in this plotter and showing their visible/invisible state */
+        inline JKQTPGraphsModel* getPlotsModel() { return m_plotsModel; }
+
+
+
+        /** \brief returns description of i'th graph
+         *
+         *  \note If you modify the returned graph, a replot may not happen, so call redrawPlot() if the plotter is e.g. embedded in a visible widget to cause a redrawing of the plot!
+         */
+        JKQTPPlotElement* getGraph(size_t i);
+        /** \brief returns description of i'th graph */
+        const JKQTPPlotElement* getGraph(size_t i) const;
+
+        /** \brief returns the number of graphs */
+        size_t getGraphCount() const;
+
+        /** \brief remove the i-th graph */
+        void deleteGraph(size_t i, bool deletegraph=true);
+
+        /** \brief remove the given graph, if it is contained */
+        void deleteGraph(JKQTPPlotElement* gr, bool deletegraph=true);
+
+        /** \brief returns a const list of all graphs */
+        inline const GraphsList& getGraphs() const {
+            return graphs;
+        }
+
+        /** \brief returns a list of all graphs
+         *
+         *  \note If you modify the graphs or change their position, a replot may not happen, so call redrawPlot() if the plotter is e.g. embedded in a visible widget to cause a redrawing of the plot!
+          */
+        inline GraphsList& getGraphs()  {
+            return graphs;
+        }
+
+        /** \brief returns a const iterator to the first graph */
+        inline GraphsConstIterator beginGraphs() const {
+            return graphs.cbegin();
+        }
+        /** \brief returns a const iterator behind the last graph */
+        inline GraphsConstIterator endGraphs() const {
+            return graphs.cend();
+        }
+        /** \brief returns a const iterator to the first graph */
+        inline GraphsConstIterator cbeginGraphs() const {
+            return graphs.begin();
+        }
+        /** \brief returns a const iterator behind the last graph */
+        inline GraphsConstIterator cendGraphs() const {
+            return graphs.end();
+        }
+        /** \brief returns an iterator to the first graph
+         *
+         *  \note If you modify the graphs or change their position, a replot may not happen, so call redrawPlot() if the plotter is e.g. embedded in a visible widget to cause a redrawing of the plot!
+         */
+        inline GraphsIterator beginGraphs()  {
+            return graphs.begin();
+        }
+        /** \brief returns an iterator behind the last graph
+         *
+         *  \note If you modify the graphs or change their position, a replot may not happen, so call redrawPlot() if the plotter is e.g. embedded in a visible widget to cause a redrawing of the plot!
+         */
+        inline GraphsIterator endGraphs()  {
+            return graphs.end();
+        }
+        /** \brief add a new graph at the end of the graphs, if the graph is already in the plot, it is moved to the end of the list
+         *
+         * \param gr graph object (of type JKQTPPlotElement) to be added. \b Note: The JKQTPlotter takes ownership of graph \a gr .
+         *
+         * \note the added graph is drawn ABOVE/AFTER all other graphs.
+         */
+        size_t addGraphOnTop(JKQTPPlotElement* gr);
+        inline size_t addGraph(JKQTPPlotElement* gr) { return addGraphOnTop(gr); }
+        /** \brief add a new graph before all other graphs (i.e. at the top of the list of graphs), if the graph is already in the plot, it is moved to the top
+         *
+         * \param gr graph object (of type JKQTPPlotElement) to be added. \b Note: The JKQTPlotter takes ownership of graph \a gr .
+         *
+         * \note the added graph is drawn BELOW/BEFORE all other graphs.
+         */
+        size_t addGraphAtBottom(JKQTPPlotElement* gr);
+
+        /** \brief returns \c true, if the given graph is in this plot */
+        bool containsGraph(const JKQTPPlotElement *gr) const;
+
+        /** \brief move the given graph \a gr to the end of all graphs, so it is drawn  */
+        void moveGraphTop(const JKQTPPlotElement* gr);
+        /** \brief move the given graph \a gr to the bottom of all graphs */
+        void moveGraphBottom(const JKQTPPlotElement* gr);
+        /** \brief move the given graph to the top */
+        void moveGraphTop(int idx);
+        /** \brief move the given graph to the top */
+        void moveGraphBottom(int idx);
+        /** \brief returns the index of the given graph \a gr in the graphs list, or -1 if it was not found */
+        int indexOfGraph(const JKQTPPlotElement* gr) const;
+
+        /** \brief move the given graph \a gr one item up (i.e. it is drawn later/higher in the z-stack) */
+        void moveGraphUp(const JKQTPPlotElement* gr);
+        /** \brief move the given graph \a gr one item down (i.e. it is drawn earlier/lower in the z-stack) */
+        void moveGraphDown(const JKQTPPlotElement* gr);
+        /** \brief move the graph at position \a idx one item up (i.e. it is drawn later/higher in the z-stack) */
+        void moveGraphUp(int idx);
+        /** \brief move the graph at position \a idx one item down (i.e. it is drawn earlier/lower in the z-stack) */
+        void moveGraphDown(int idx);
+
+        /** \brief  add a new graphs from a QVector<JKQTPPlotElement*>, QList<JKQTPPlotElement*>, std::vector<JKQTPPlotElement*> ... or any standard-iterateable container with JKQTPPlotElement*-items
+         *
+         *  \tparam TJKQTPGraphContainer a container type with default C++-sytle iterator interface
+         *                               (i.e. methods \c begin() and \c end() and an iterator, which may be
+         *                               moved to the next element with the operator \c ++ .
+         *  \param gr Container of type TJKQTPGraphContainer, which contains the graphs \b Note: The JKQTPlotter takes ownership of graphs in \a gr .
+         *  \param[out] graphIDsOut optional output parameter, the vector will contain the IDs of each graph added to theis plot
+         */
+        template <class TJKQTPGraphContainer>
+        inline void addGraphs(const TJKQTPGraphContainer& gr, QVector<size_t>* graphIDsOut=nullptr) {
+            for (auto it=gr.begin(); it!=gr.end(); ++it) {
+                const auto id=addGraph(*it);
+                if (graphIDsOut) graphIDsOut->push_back(id);
+            }
+        }
+        /** \brief apply functor \a func to all graphs in the plotter. After completing the operation, the graph is updated */
+        void modifyGraphs(const std::function<void(JKQTPPlotElement*)>& func);
+        /** \brief sort the graphs, using functor \a compareLess to find whether a first graph shall be before (i.e. less) than a second graph. After completing the operation, the graph is updated */
+        void sortGraphs(const std::function<bool(const JKQTPPlotElement* , const JKQTPPlotElement* )>& compareLess);
+
+    public slots:
+        /** \brief remove all plots
+         *
+         *  \param deleteGraphs if set \c true (default) the graph objects will also be deleted
+         */
+        void clearGraphs(bool deleteGraphs=true);
+
+
+        /** \brief set all graphs in the plotter invisible
+         *
+         * \see setAllGraphsVisible(), setGraphVisible(), JKQTPPlotElement::setVisible()  */
+        void setAllGraphsInvisible();
+        /** \brief set all graphs in the plotter visible
+         *
+         * \see setAllGraphsInvisible(), setGraphVisible(), JKQTPPlotElement::setVisible() */
+        void setAllGraphsVisible();
+        /** \brief switch visibility of the \a i -th graph to \a visible
+         *
+         * \see setAllGraphsInvisible(), setAllGraphsVisible(), JKQTPPlotElement::setVisible() */
+        void setGraphVisible(int i, bool visible=true);
+        /** \brief switch visibility of the \a i -th graph to \a visible
+         *
+         * \see setAllGraphsInvisible(), setAllGraphsVisible(), JKQTPPlotElement::setVisible() */
+        void setGraphInvisible(int i);
+
+    public:
+
+        /** \brief Functor which can be used as filter predicate for getGraphsXMinMax() or getGraphsYMinMax()
+         *
+         *  \see getGraphsXMinMax(), getGraphsYMinMax(), allPlotElements
+         */
+        typedef std::function<bool(const JKQTPPlotElement*)> PlotElementPreciate;
+
+        /** \brief Functor which does not apply any filter to JKQTPPlotElement, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
+         *
+         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
+         */
+        struct JKQTPLOTTER_LIB_EXPORT allPlotElements {
+            inline bool operator()(const JKQTPPlotElement*) const { return true; };
+        };
+        /** \brief filter functor which accepts only those JKQTPPlotElement where JKQTPPlotElement::getXAxisRef()
+         *         returns the JKQTPCoordinateAxisRef supplied to the constructor, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
+         *
+         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
+         */
+        struct JKQTPLOTTER_LIB_EXPORT filterPlotElementByXAxis {
+            inline explicit filterPlotElementByXAxis(JKQTPCoordinateAxisRef ref_): ref(ref_) {};
+            inline bool operator()(const JKQTPPlotElement* el) const;
+        private:
+            JKQTPCoordinateAxisRef ref;
+        };
+        /** \brief filter functor which accepts only those JKQTPPlotElement where JKQTPPlotElement::getYAxisRef()
+         *         returns the JKQTPCoordinateAxisRef supplied to the constructor, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
+         *
+         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
+         */
+        struct JKQTPLOTTER_LIB_EXPORT filterPlotElementByYAxis {
+            inline explicit filterPlotElementByYAxis(JKQTPCoordinateAxisRef ref_): ref(ref_) {};
+            inline bool operator()(const JKQTPPlotElement* el) const;
+        private:
+            JKQTPCoordinateAxisRef ref;
+        };
+        /** \brief get the maximum and minimum x-value over all graphs in the plot
+         *  \param[out] minx smallest x value
+         *  \param[out] maxx largest x value
+         *  \param[out] smallestGreaterZero smallest data point which is >0 (needed for scaling of logarithmic axes)
+         *  \param predicate a PlotElementPreciate, which can be used to limit the JKQTPPlotElement to be evaluated
+         *  \returns \c true if at least one matching graph was found and evaluated succcessfully
+         *
+         * The result is given in the two parameters which are call-by-reference parameters!
+         */
+        bool getGraphsXMinMax(double& minx, double& maxx, double& smallestGreaterZero, const PlotElementPreciate &predicate=allPlotElements());
+        /** \brief get the maximum and minimum y-value over all graphs in the plot
+         *  \param[out] miny smallest y value
+         *  \param[out] maxy largest y value
+         *  \param[out] smallestGreaterZero smallest data point which is >0 (needed for scaling of logarithmic axes)
+         *  \param predicate a PlotElementPreciate, which can be used to limit the JKQTPPlotElement to be evaluated
+         *  \returns \c true if at least one matching graph was found and evaluated succcessfully
+         *
+         * The result is given in the two parameters which are call-by-reference parameters!
+         */
+        bool getGraphsYMinMax(double& miny, double& maxy, double& smallestGreaterZero, const PlotElementPreciate &predicate=allPlotElements());
+/**@}*/
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Plot Styling & Settings Management */
+/**@{*/
 
         /** \brief loads all the plot properties from a <a href="http://doc.qt.io/qt-5/qsettings.html")">QSettings</a> object */
         void loadSettings(const QSettings& settings, const QString& group=QString("plots/"));
@@ -508,104 +759,6 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         /** \brief saves the plot user properties into a <a href="http://doc.qt.io/qt-5/qsettings.html")">QSettings</a> object. */
         void saveUserSettings(QSettings& settings, const QString& group=QString("plots_user/")) const;
 
-        /** \brief gets the width of the plot widget */
-        int getWidth();
-
-        /** \brief gets the width of the plot widget */
-        int getHeight();
-
-
-        /** \brief returns the current x-axis min */
-        double getXMin() const;
-
-        /** \brief returns the current x-axis max */
-        double getXMax() const;
-
-        /** \brief returns the current y-axis min */
-        double getYMin() const;
-
-        /** \brief returns the current y-axis max */
-        double getYMax() const;
-
-
-
-        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with given dots per inch) */
-        inline double didot2px(double pt, double dpi) const {
-            return dpi/25.4*0.376*pt;
-        }
-        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with dpi from painter) */
-        inline double didot2px(double pt, JKQTPEnhancedPainter& painter) const {
-            return didot2px(pt, painter.device()->logicalDpiX());
-        }
-        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with dpi from painter) */
-        inline double didot2px(JKQTPEnhancedPainter& painter, double pt) const {
-            return didot2px(pt, painter.device()->logicalDpiX());
-        }
-
-        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
-        inline double pt2px(double pt, double dpi) const {
-            return dpi*pt/72.0;
-        }
-        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
-        inline double pt2px(double pt, JKQTPEnhancedPainter& painter) const {
-            return pt2px(pt, painter.device()->logicalDpiX());
-        }
-        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
-        inline double pt2px(JKQTPEnhancedPainter& painter, double pt) const {
-            return pt2px(pt, painter.device()->logicalDpiX());
-        }
-
-        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
-        inline double mm2px(double mm, double dpi) const {
-            return dpi*mm/25.4;
-        }
-        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
-        inline double mm2px(double mm, JKQTPEnhancedPainter& painter) const {
-            return mm2px(mm, painter.device()->logicalDpiX());
-        }
-        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
-        inline double mm2px(JKQTPEnhancedPainter& painter, double mm) const {
-            return mm2px(mm, painter.device()->logicalDpiX());
-        }
-
-        /** \brief returns the absolute x-axis min */
-        double getAbsoluteXMin() const;
-
-        /** \brief returns the absolute x-axis max */
-        double getAbsoluteXMax() const;
-
-        /** \brief returns the absolute y-axis min */
-        double getAbsoluteYMin() const;
-
-        /** \brief returns the absolute y-axis max */
-        double getAbsoluteYMax() const;
-
-
-        /** \brief add a new plotter for grid printing mode */
-        void addGridPrintingPlotter(size_t x, size_t y, JKQTBasePlotter* plotter);
-
-        /** \brief clear all additional plotters for grid printing mode */
-        void clearGridPrintingPlotters();
-
-        /** \brief return x-pixel coordinate from x coordinate */
-        inline double x2p(double x) const {
-            return xAxis->x2p(x);
-        }
-
-        /** \brief return y-pixel coordinate from y coordinate */
-        inline double y2p(double y) const {
-            return yAxis->x2p(y);
-        }
-
-        /** \brief return x coordinate from x-pixel */
-        inline double p2x(double x) const {
-            return xAxis->p2x(x);
-        }
-
-        /** \brief return y coordinate from y-pixel */
-        inline double p2y(double y) const {
-            return yAxis->p2x(y);
-        }
 
         /** \brief gets the next unused style id, i.e. the smalles number >=0 which is not contained in usedStyles */
         int getNextStyle();
@@ -670,6 +823,157 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         /** \brief returns a QPen object for the i-th plot style */
         JKQTPPen getPlotStyle(int i, JKQTPPlotStyleType type=JKQTPPlotStyleType::Default) const;
 
+/**@}*/
+
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Utilities: Unit Trannsforms */
+/**@{*/
+
+
+        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with given dots per inch) */
+        inline double didot2px(double pt, double dpi) const {
+            return dpi/25.4*0.376*pt;
+        }
+        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with dpi from painter) */
+        inline double didot2px(double pt, JKQTPEnhancedPainter& painter) const {
+            return didot2px(pt, painter.device()->logicalDpiX());
+        }
+        /** \brief returns the given size in Didot points (0.376 mm) to pixels (with dpi from painter) */
+        inline double didot2px(JKQTPEnhancedPainter& painter, double pt) const {
+            return didot2px(pt, painter.device()->logicalDpiX());
+        }
+
+        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
+        inline double pt2px(double pt, double dpi) const {
+            return dpi*pt/72.0;
+        }
+        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
+        inline double pt2px(double pt, JKQTPEnhancedPainter& painter) const {
+            return pt2px(pt, painter.device()->logicalDpiX());
+        }
+        /** \brief returns the given size in DTP points points (1/72inch = 0.353mm) to pixels (with given dots per inch) */
+        inline double pt2px(JKQTPEnhancedPainter& painter, double pt) const {
+            return pt2px(pt, painter.device()->logicalDpiX());
+        }
+
+        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
+        inline double mm2px(double mm, double dpi) const {
+            return dpi*mm/25.4;
+        }
+        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
+        inline double mm2px(double mm, JKQTPEnhancedPainter& painter) const {
+            return mm2px(mm, painter.device()->logicalDpiX());
+        }
+        /** \brief returns the given size in millimeters to pixels (with given dots per inch) */
+        inline double mm2px(JKQTPEnhancedPainter& painter, double mm) const {
+            return mm2px(mm, painter.device()->logicalDpiX());
+        }
+
+        /** \brief return x-pixel coordinate from x coordinate, using the primary axis */
+        inline double x2p(double x) const {
+            return xAxis->x2p(x);
+        }
+
+        /** \brief return y-pixel coordinate from y coordinate, using the primary axis */
+        inline double y2p(double y) const {
+            return yAxis->x2p(y);
+        }
+
+        /** \brief return x coordinate from x-pixel, using the primary axis */
+        inline double p2x(double x) const {
+            return xAxis->p2x(x);
+        }
+
+        /** \brief return y coordinate from y-pixel, using the primary axis */
+        inline double p2y(double y) const {
+            return yAxis->p2x(y);
+        }
+/**@}*/
+
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Access to Plot Properties */
+/**@{*/
+
+
+        /** \brief gets the width of the plot widget */
+        int getWidth();
+
+        /** \brief gets the width of the plot widget */
+        int getHeight();
+
+
+        /** \brief returns the current x-axis min of the primary x-axis
+         *
+         *  \see JKQTPCoordinateAxis::getMin()
+         */
+        double getXMin() const;
+
+        /** \brief returns the current x-axis max of the primary x-axis
+         *
+         *  \see JKQTPCoordinateAxis::getMax()
+         */
+        double getXMax() const;
+
+        /** \brief returns the current y-axis min of the primary y-axis
+         *
+         *  \see JKQTPCoordinateAxis::getMin()
+         */
+        double getYMin() const;
+
+        /** \brief returns the current y-axis max of the primary y-axis
+         *
+         *  \see JKQTPCoordinateAxis::getMax()
+         */
+        double getYMax() const;
+
+
+
+
+        /** \brief returns the absolute x-axis min of the primary x-axis. This is the lowest allowed value the the axis min/max.
+         *
+         *  \see JKQTPCoordinateAxis::getAbsoluteMin()
+         */
+        double getAbsoluteXMin() const;
+
+        /** \brief returns the absolute x-axis max of the primary x-axis  This is the highest allowed value the the axis min/max.
+         *
+         *  \see JKQTPCoordinateAxis::getAbsoluteMax()
+         */
+        double getAbsoluteXMax() const;
+
+        /** \brief returns the absolute y-axis min of the primary y-axis  This is the lowest allowed value the the axis min/max.
+         *
+         *  \see JKQTPCoordinateAxis::getAbsoluteMin()
+         */
+        double getAbsoluteYMin() const;
+
+        /** \brief returns the absolute y-axis max of the primary y-axis  This is the highest allowed value the the axis min/max.
+         *
+         *  \see JKQTPCoordinateAxis::getAbsoluteMax()
+         */
+        double getAbsoluteYMax() const;
+
+
+        /** \brief add a new plotter for grid printing mode */
+        void addGridPrintingPlotter(size_t x, size_t y, JKQTBasePlotter* plotter);
+
+        /** \brief clear all additional plotters for grid printing mode */
+        void clearGridPrintingPlotters();
+
+/**@}*/
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Drawing Functions */
+/**@{*/
+
         /*! \brief draw the contained graph (including grid prints) into the given JKQTPEnhancedPainter
             \param painter JKQTPEnhancedPainter to which the plot should be drawn
             \param rect rectangle to plot into
@@ -694,20 +998,19 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
          */
         void drawNonGrid(JKQTPEnhancedPainter& painter, const QPoint& pos=QPoint(0,0));
 
-        /** \brief updates the secondary axes
-         *
-         *  The plot may contain (in addition to its primary axes) also secondary axes, that depend in their
-         *  scaling (min,max, ...) on the primmary axes of the plot. This function updates/recalculates the
-         *  scaling of these axes.
-         */
-        void updateSecondaryAxes();
-        /** \brief emit plotUpdated() */
-        void redrawPlot() { if (emitPlotSignals) emit plotUpdated(); }
+
+        /** \brief emit plotUpdated(), which can be used by e.g. a widget class to update the displayed plot */
+        inline void redrawPlot() { if (emitPlotSignals) emit plotUpdated(); }
 
         /** \brief controls, whether the signals plotUpdated() are emitted */
         void setEmittingPlotSignalsEnabled(bool __value);
         /** \brief returns, whether the signals plotUpdated() are emitted */
         bool isEmittingPlotSignalsEnabled() const;
+        /** \brief returns whether this class emits signals, like zoomChangedLocally() or beforePlotScalingRecaluclate() */
+        bool isEmittingSignalsEnabled()const;
+        /** \brief specifies whether this class emits signals, like zoomChangedLocally() or beforePlotScalingRecaluclate() */
+        void setEmittingSignalsEnabled(bool enabled);
+
 
         /** \copydoc JKQTBasePlotterStyle::plotBorderTop  */
         int getPlotBorderTop() const;
@@ -794,6 +1097,19 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         double getDefaultTextSize() const;
         /** \copydoc JKQTBasePlotterStyle::defaultFontName */
         QString getDefaultTextFontName() const;
+        /** \copydoc fontSizePrintMultiplier */
+        void setFontSizePrintMultiplier(double __value);
+        /** \copydoc fontSizePrintMultiplier */
+        double getFontSizePrintMultiplier() const;
+        /** \copydoc lineWidthPrintMultiplier */
+        void setLineWidthPrintMultiplier(double __value);
+        /** \copydoc lineWidthPrintMultiplier */
+        double getLineWidthPrintMultiplier() const;
+        /** \copydoc fontSizeMultiplier */
+        double getFontSizeMultiplier() const;
+        /** \copydoc lineWidthMultiplier */
+        double getLineWidthMultiplier() const;
+
         /** \brief if set \c true (default: \c false ) the JKQTBasePlotter draws colored rectangles to indicate the different regions in the plot (border, axes, ...)
          *
          *
@@ -961,6 +1277,30 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
          *  \see \ref jkqtplotter_base_grids_baseplotter_secondaryaxes , \subpage JKQTPlotterSecondaryAxes
          */
         JKQTPCoordinateAxisRef addSecondaryYAxis(JKQTPVerticalAxisBase* axis);
+        /** \brief updates the secondary axes
+         *
+         *  The plot may contain (in addition to its primary axes) also secondary axes, that depend in their
+         *  scaling (min,max, ...) on the primmary axes of the plot. This function updates/recalculates the
+         *  scaling of these axes.
+         */
+        void updateSecondaryAxes();
+
+
+        /** \brief takes a new axis range \a xminn ... \a xmaxx and \a yminn ... \a ymaxx and corrects the values to match the currently set axisAspectRatio
+         *
+         *  This function is used by setXY(), setX(), setY().
+         *
+         *  \see axisAspectRatio, setXY(), setX(), setY()
+         */
+        void correctXYRangeForAspectRatio(double &xminn, double &xmaxx, double &yminn, double &ymaxx) const;
+
+/**@}*/
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name QActions Management */
+/**@{*/
 
         /** \copydoc actSavePlot */
         QAction* getActionSavePlot() const;
@@ -1003,138 +1343,20 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
          */
         void deregisterAdditionalAction(QAction* act);
 
+
+
+/**@}*/
+
+
+
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Master/Slave Plot Synchronization */
+/**@{*/
+
         /** \copydoc masterSynchronizeWidth */ 
         bool getMasterSynchronizeWidth() const;
         /** \copydoc masterSynchronizeHeight */ 
         bool getMasterSynchronizeHeight() const;
-        /** \copydoc fontSizePrintMultiplier */ 
-        void setFontSizePrintMultiplier(double __value);
-        /** \copydoc fontSizePrintMultiplier */ 
-        double getFontSizePrintMultiplier() const;
-        /** \copydoc lineWidthPrintMultiplier */ 
-        void setLineWidthPrintMultiplier(double __value);
-        /** \copydoc lineWidthPrintMultiplier */ 
-        double getLineWidthPrintMultiplier() const;
-        /** \copydoc fontSizeMultiplier */ 
-        double getFontSizeMultiplier() const;
-        /** \copydoc lineWidthMultiplier */ 
-        double getLineWidthMultiplier() const;
-
-
-        /** \brief returns description of i'th graph */
-        JKQTPPlotElement* getGraph(size_t i);
-
-        /** \brief returns the number of graphs */
-        size_t getGraphCount();
-
-        /** \brief remove the i-th graph */
-        void deleteGraph(size_t i, bool deletegraph=true);
-
-        /** \brief remove the given graph, if it is contained */
-        void deleteGraph(JKQTPPlotElement* gr, bool deletegraph=true);
-
-        /** \brief remove all plots
-         *
-         *  \param deleteGraphs if set \c true (default) the graph objects will also be deleted
-         */
-        void clearGraphs(bool deleteGraphs=true);
-
-        /** \brief set all graphs in the plotter invisible
-         *
-         * \see setAllGraphsVisible(), setGraphVisible(), JKQTPPlotElement::setVisible()  */
-        void setAllGraphsInvisible();
-        /** \brief set all graphs in the plotter visible
-         *
-         * \see setAllGraphsInvisible(), setGraphVisible(), JKQTPPlotElement::setVisible() */
-        void setAllGraphsVisible();
-        /** \brief switch visibility of the \a i -th graph to \a visible
-         *
-         * \see setAllGraphsInvisible(), setAllGraphsVisible(), JKQTPPlotElement::setVisible() */
-        void setGraphVisible(int i, bool visible=true);
-
-        /** \brief add a new graph, returns it's position in the graphs list, if the graph is already in the plot, this returns the index in the list */
-        size_t addGraph(JKQTPPlotElement* gr);
-
-        /** \brief returns \c true, if the given graph is in this plot */
-        bool containsGraph(JKQTPPlotElement* gr) const;
-
-        /** \brief move the given graph to the top, or add it, if it is not yet contained */
-        size_t moveGraphTop(JKQTPPlotElement* gr);
-        /** \brief move the given graph to the top, or add it, if it is not yet contained */
-        size_t moveGraphBottom(JKQTPPlotElement* gr);
-
-        /** \brief  add a new graphs from a QVector<JKQTPPlotElement*>, QList<JKQTPPlotElement*>, std::vector<JKQTPPlotElement*> ... or any standard-iterateable container with JKQTPPlotElement*-items
-         *
-         *  \tparam TJKQTPGraphContainer a container type with default C++-sytle iterator interface
-         *                               (i.e. methods \c begin() and \c end() and an iterator, which may be
-         *                               moved to the next element with the operator \c ++ .
-         *  \param gr Container of type TJKQTPGraphContainer, which contains the graphs \b Note: The JKQTPlotter takes ownership of graphs in \a gr .
-         *  \param[out] graphIDsOut optional output parameter, the vector will contain the IDs of each graph added to theis plot
-         */
-        template <class TJKQTPGraphContainer>
-        inline void addGraphs(const TJKQTPGraphContainer& gr, QVector<size_t>* graphIDsOut=nullptr) {
-            for (auto it=gr.begin(); it!=gr.end(); ++it) {
-                const size_t g=addGraph(*it);
-                if (graphIDsOut) graphIDsOut->push_back(g);
-            }
-        }
-
-        /** \brief Functor which can be used as filter predicate for getGraphsXMinMax() or getGraphsYMinMax()
-         *
-         *  \see getGraphsXMinMax(), getGraphsYMinMax(), allPlotElements
-         */
-        typedef std::function<bool(const JKQTPPlotElement*)> PlotElementPreciate;
-
-        /** \brief Functor which does not apply any filter to JKQTPPlotElement, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
-         *
-         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
-         */
-        struct JKQTPLOTTER_LIB_EXPORT allPlotElements {
-            inline bool operator()(const JKQTPPlotElement*) const { return true; };
-        };
-        /** \brief filter functor which accepts only those JKQTPPlotElement where JKQTPPlotElement::getXAxisRef()
-         *         returns the JKQTPCoordinateAxisRef supplied to the constructor, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
-         *
-         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
-         */
-        struct JKQTPLOTTER_LIB_EXPORT filterPlotElementByXAxis {
-            inline explicit filterPlotElementByXAxis(JKQTPCoordinateAxisRef ref_): ref(ref_) {};
-            inline bool operator()(const JKQTPPlotElement* el) const;
-        private:
-            JKQTPCoordinateAxisRef ref;
-        };
-        /** \brief filter functor which accepts only those JKQTPPlotElement where JKQTPPlotElement::getYAxisRef()
-         *         returns the JKQTPCoordinateAxisRef supplied to the constructor, e.g. in getGraphsXMinMax() or getGraphsYMinMax()
-         *
-         *  \see getGraphsXMinMax(), getGraphsYMinMax(), PlotElementPreciate
-         */
-        struct JKQTPLOTTER_LIB_EXPORT filterPlotElementByYAxis {
-            inline explicit filterPlotElementByYAxis(JKQTPCoordinateAxisRef ref_): ref(ref_) {};
-            inline bool operator()(const JKQTPPlotElement* el) const;
-        private:
-            JKQTPCoordinateAxisRef ref;
-        };
-        /** \brief get the maximum and minimum x-value over all graphs in the plot
-         *  \param[out] minx smallest x value
-         *  \param[out] maxx largest x value
-         *  \param[out] smallestGreaterZero smallest data point which is >0 (needed for scaling of logarithmic axes)
-         *  \param predicate a PlotElementPreciate, which can be used to limit the JKQTPPlotElement to be evaluated
-         *  \returns \c true if at least one matching graph was found and evaluated succcessfully
-         *
-         * The result is given in the two parameters which are call-by-reference parameters!
-         */
-        bool getGraphsXMinMax(double& minx, double& maxx, double& smallestGreaterZero, const PlotElementPreciate &predicate=allPlotElements());
-        /** \brief get the maximum and minimum y-value over all graphs in the plot
-         *  \param[out] miny smallest y value
-         *  \param[out] maxy largest y value
-         *  \param[out] smallestGreaterZero smallest data point which is >0 (needed for scaling of logarithmic axes)
-         *  \param predicate a PlotElementPreciate, which can be used to limit the JKQTPPlotElement to be evaluated
-         *  \returns \c true if at least one matching graph was found and evaluated succcessfully
-         *
-         * The result is given in the two parameters which are call-by-reference parameters!
-         */
-        bool getGraphsYMinMax(double& miny, double& maxy, double& smallestGreaterZero, const PlotElementPreciate &predicate=allPlotElements());
-
 
 
         /** \brief denotes, which axes to synchronize in synchronizeToMaster() */
@@ -1191,37 +1413,14 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         /** \brief switches any synchronization off, that has been created by synchronizeToMaster() */
         void resetMasterSynchronization(SynchronizationDirection synchronizeDirection=sdXYAxes);
 
+/**@}*/
 
 
 
 
-
-
-
-        /** \brief save the current plot data as a Comma Separated Values (CSV) file
-         *
-         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
-         * \param decimalSeparator decimal separator for outpu
-         * \param commentInitializer line-start for comment lines
-         */
-        void saveAsCSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);
-
-        /** \brief save the current plot data as a Semicolon Separated Values (SSV) file
-         *
-         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
-         * \param decimalSeparator decimal separator for outpu
-         * \param commentInitializer line-start for comment lines
-         */
-        void saveAsSemicolonSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);        /** \brief save the current plot data as a Tabulator Separated Values (CSV) file
-         *
-         * \param filename the file to save to, if \a filename is empty, a file open dialog will be shown
-         * \param decimalSeparator decimal separator for outpu
-         * \param commentInitializer line-start for comment lines
-         */
-        void saveAsTabSV(const QString& filename, const QString& decimalSeparator, const QString& commentInitializer);
-
-
-
+//////////////////////////////////////////////////////////////////////////////////////////////////////////////
+/** @name Utilities: (math-markup) Text Sizing */
+/**@{*/
         /** \brief internal tool class for text sizes
          *   \ingroup jkqtpplottersupprt
          *  \internal */
@@ -1266,15 +1465,11 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
          * \internal
          */
         QSizeF getTextSizeSize(const QString& fontName, double fontSize, const QString& text,  QPainter &painter);
+/**@}*/
+
+
 
 
-        /** \brief takes a new axis range \a xminn ... \a xmaxx and \a yminn ... \a ymaxx and corrects the values to match the currently set axisAspectRatio
-         *
-         *  This function is used by setXY(), setX(), setY().
-         *
-         *  \see axisAspectRatio, setXY(), setX(), setY()
-         */
-        void correctXYRangeForAspectRatio(double &xminn, double &xmaxx, double &yminn, double &ymaxx) const;
     signals:
         /** \brief signal: emitted whenever the user selects a new x-y zoom range (by mouse) */
         void zoomChangedLocally(double newxmin, double newxmax, double newymin, double newymax, JKQTBasePlotter* sender);
@@ -1488,7 +1683,11 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         /** \brief sets x/ymin and x/ymax to the supplied values and replots the graph (zoom operation!) */
         void zoom(double nxmin, double nxmax, double nymin, double nymax);
 
-        /** \brief sets whether to plot grid lines or not */
+        /** \brief sets whether to plot grid lines or not
+        *
+        * \image html jkqtplotter_gridvisible.png "Grid visible"
+        * \image html jkqtplotter_gridinvisible.png "Grid invisible"
+        */
         void setGrid(bool val);
 
         /** \brief sets the color of all Major grid lines
@@ -1871,7 +2070,7 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
         void drawSystemXAxis(JKQTPEnhancedPainter& painter);
         /** \brief plot the x coordinate axis (incl. labels) */
         void drawSystemYAxis(JKQTPEnhancedPainter& painter);
-        /** \brief plot the graphs */
+        /** \brief plot the graphs in the order they appear in the list graphs, i.e. initially the order of the addGraph() calls. So the graph at the end of the list is drawn ON TOP. */
         void drawGraphs(JKQTPEnhancedPainter& painter);
         /** \brief plot a key */
         void drawKey(JKQTPEnhancedPainter& painter);
@@ -2330,7 +2529,7 @@ class JKQTPLOTTER_LIB_EXPORT JKQTBasePlotter: public QObject {
 
 
         /** \brief a vector that contains all graphs to be plottet in the system */
-        QList<JKQTPPlotElement*> graphs;
+        GraphsList graphs;
 
 
 
diff --git a/lib/jkqtplotter/jkqtplotter.h b/lib/jkqtplotter/jkqtplotter.h
index 3208dc7e8e..81b111f1c9 100644
--- a/lib/jkqtplotter/jkqtplotter.h
+++ b/lib/jkqtplotter/jkqtplotter.h
@@ -696,119 +696,147 @@ class JKQTPLOTTER_LIB_EXPORT JKQTPlotter: public QWidget {
          */
         int getMouseLastClickY() const;
 
-        /** \brief returns the coordinate axis object for the x-axis \see JKQTBasePlotter::getXAxis() */
+        /** \copydoc JKQTBasePlotter::getXAxis()   */
         inline JKQTPHorizontalAxisBase* getXAxis(JKQTPCoordinateAxisRef axis=JKQTPPrimaryAxis) { return plotter->getXAxis(axis); }
-        /** \brief returns the coordinate axis object for the y-axis \see JKQTBasePlotter::getYAxis()  */
+        /** \copydoc JKQTBasePlotter::getYAxis()   */
         inline JKQTPVerticalAxisBase* getYAxis(JKQTPCoordinateAxisRef axis=JKQTPPrimaryAxis) { return plotter->getYAxis(axis); }
-        /** \brief returns the coordinate axis object for the x-axis as a const pointer \see JKQTBasePlotter::getXAxis()  */
+        /** \copydoc JKQTBasePlotter::getXAxis()   */
         inline const JKQTPHorizontalAxisBase* getXAxis(JKQTPCoordinateAxisRef axis=JKQTPPrimaryAxis) const { return plotter->getXAxis(axis); }
-        /** \brief returns the coordinate axis object for the y-axis as a const pointer \see JKQTBasePlotter::getYAxis()  */
+        /** \copydoc JKQTBasePlotter::getYAxis()   */
         inline const JKQTPVerticalAxisBase* getYAxis(JKQTPCoordinateAxisRef axis=JKQTPPrimaryAxis) const { return plotter->getYAxis(axis); }
 
-       /** \brief returns the \a i -th graph (of type JKQTPPlotElement) in this plotter instance \see JKQTBasePlotter::getGraph() */
-        inline JKQTPPlotElement* getGraph(size_t i) { return plotter->getGraph(i); }
 
-        /** \brief returns the number of graphs \see JKQTBasePlotter::getGraphCount() */
+
+
+        /** \copydoc JKQTBasePlotter::beginGraphs() */
+        inline typename JKQTBasePlotter::GraphsConstIterator cbeginGraphs() const  {
+            return plotter->cendGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::endGraphs() */
+        inline typename JKQTBasePlotter::GraphsConstIterator cendGraphs() const {
+            return plotter->cendGraphs();
+        }
+
+        /** \copydoc JKQTBasePlotter::beginGraphs() */
+        inline typename JKQTBasePlotter::GraphsConstIterator beginGraphs() const  {
+            return plotter->endGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::endGraphs() */
+        inline typename JKQTBasePlotter::GraphsConstIterator endGraphs() const {
+            return plotter->endGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::beginGraphs() */
+        inline typename JKQTBasePlotter::GraphsIterator beginGraphs()  {
+            return plotter->endGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::endGraphs() */
+        inline typename JKQTBasePlotter::GraphsIterator endGraphs()  {
+            return plotter->endGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::modifyGraphs() */
+        inline void modifyGraphs(const std::function<void(JKQTPPlotElement*)>& func) {
+            plotter->modifyGraphs(func);
+        }
+        /** \copydoc JKQTBasePlotter::sortGraphs() */
+        inline void sortGraphs(const std::function<bool(const JKQTPPlotElement* , const JKQTPPlotElement* )>& compareLess) {
+            plotter->sortGraphs(compareLess);
+        }
+        /** \copydoc JKQTBasePlotter::getGraphs()   */
+        inline const typename JKQTBasePlotter::GraphsList& getGraphs() const {
+            return plotter->getGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::getGraphs()   */
+        inline typename JKQTBasePlotter::GraphsList& getGraphs()  {
+            return plotter->getGraphs();
+        }
+        /** \copydoc JKQTBasePlotter::getGraph()   */
+        inline JKQTPPlotElement* getGraph(size_t i) { return plotter->getGraph(i); }
+        /** \copydoc JKQTBasePlotter::getGraph()   */
+        inline const JKQTPPlotElement* getGraph(size_t i) const { return plotter->getGraph(i); }
+
+        /** \copydoc JKQTBasePlotter::getGraphCount()   */
         inline size_t getGraphCount() { return plotter->getGraphCount(); }
 
-        /** \brief remove the i-th graph \see JKQTBasePlotter::deleteGraph() */
+        /** \copydoc JKQTBasePlotter::deleteGraph()   */
         inline void deleteGraph(size_t i, bool deletegraph=true) { plotter->deleteGraph(i, deletegraph); }
 
-        /** \brief returns \c true, if the given graph is present \see JKQTBasePlotter::containsGraph() */
+        /** \copydoc JKQTBasePlotter::containsGraph()   */
         inline bool containsGraph(JKQTPPlotElement* gr) { return plotter->containsGraph(gr); }
 
-        /** \brief remove the given graph, if it is contained \see JKQTBasePlotter::deleteGraph() */
+        /** \copydoc JKQTBasePlotter::deleteGraph()   */
         inline void deleteGraph(JKQTPPlotElement* gr, bool deletegraph=true) { plotter->deleteGraph(gr, deletegraph);  }
 
-        /** \brief remove all plots
-         *
-         *  \param deleteGraphs if set \c true (default) the graph objects will also be deleted
-         *
-         *  \see JKQTBasePlotter::clearGraphs()
-         */
+        /** \copydoc JKQTBasePlotter::clearGraphs()   */
         inline void clearGraphs(bool deleteGraphs=true) { plotter->clearGraphs(deleteGraphs); }
 
-        /** \brief add a new graph, returns it's position in the graphs list
-         *
-         * \param gr graph object (of type JKQTPPlotElement) to be added. \b Note: The JKQTPlotter takes ownership of graph \a gr .
-         * \return ID of the added graph object \a gr in the internal list of graphs
-         *
-         *  \see JKQTBasePlotter::addGraph()
-         */
-        inline size_t addGraph(JKQTPPlotElement* gr) { return plotter->addGraph(gr); }
+        /** \copydoc JKQTBasePlotter::addGraph()   */
+        inline void addGraph(JKQTPPlotElement* gr) { plotter->addGraph(gr); }
+        /** \copydoc JKQTBasePlotter::addGraphOnTop()   */
+        inline void addGraphOnTop(JKQTPPlotElement* gr) { plotter->addGraphOnTop(gr); }
+        /** \copydoc JKQTBasePlotter::addGraphAtBotom()   */
+        inline void addGraphAtBottom(JKQTPPlotElement* gr) { plotter->addGraphAtBottom(gr); }
 
-        /** \brief move the given graph to the top, or add it, if it is not yet contained
-         *
-         * \param gr graph object (of type JKQTPPlotElement) to be moved (needs to be containing to the JKQTPlotter already!)
-         * \return ID of the added graph object \a gr in the internal list of graphs
-         *
-         *  \see JKQTBasePlotter::moveGraphTop()
-         */
-        inline size_t moveGraphTop(JKQTPPlotElement* gr) { return plotter->moveGraphTop(gr); }
+        /** \copydoc JKQTBasePlotter::moveGraphTop()   */
+        inline void moveGraphTop(JKQTPPlotElement* gr) {  plotter->moveGraphTop(gr); }
 
-        /** \brief move the given graph to the top, or add it, if it is not yet contained
-         *
-         * \param gr graph object (of type JKQTPPlotElement) to be moved (needs to be containing to the JKQTPlotter already!)
-         * \return ID of the added graph object \a gr in the internal list of graphs
-         *
-         *  \see JKQTBasePlotter::moveGraphBottom()
-         */
-        inline size_t moveGraphBottom(JKQTPPlotElement* gr) { return plotter->moveGraphBottom(gr); }
+        /** \copydoc JKQTBasePlotter::moveGraphBottom()   */
+        inline void moveGraphBottom(JKQTPPlotElement* gr) {  plotter->moveGraphBottom(gr); }
 
-        /** \brief add a new graphs from a QVector<JKQTPPlotElement*>, QList<JKQTPPlotElement*>, std::vector<JKQTPPlotElement*> ... or any standard-iterateable container with JKQTPPlotElement*-items
-         *
-         *  \tparam TJKQTPGraphContainer a container type with default C++-sytle iterator interface
-         *                               (i.e. methods \c begin() and \c end() and an iterator, which may be
-         *                               moved to the next element with the operator \c ++ .
-         *  \param gr Container of type TJKQTPGraphContainer, which contains the graphs \b Note: The JKQTPlotter takes ownership of graphs in \a gr .
-         *  \param[out] graphIDsOut optional output parameter, the vector will contain the IDs of each graph added to theis plot
-         *
-         *  \see JKQTBasePlotter::addGraphs()
-         */
+        /** \copydoc JKQTBasePlotter::moveGraphUp()   */
+        inline void moveGraphUp(JKQTPPlotElement* gr) {  plotter->moveGraphUp(gr); }
+
+        /** \copydoc JKQTBasePlotter::moveGraphDown()   */
+        inline void moveGraphDown(JKQTPPlotElement* gr) {  plotter->moveGraphDown(gr); }
+
+        /** \copydoc JKQTBasePlotter::moveGraphTop()   */
+        inline void moveGraphTop(int idx) {  plotter->moveGraphTop(idx); }
+
+        /** \copydoc JKQTBasePlotter::moveGraphBottom()   */
+        inline void moveGraphBottom(int idx) {  plotter->moveGraphBottom(idx); }
+
+        /** \copydoc JKQTBasePlotter::moveGraphUp()   */
+        inline void moveGraphUp(int idx) {  plotter->moveGraphUp(idx); }
+
+        /** \copydoc JKQTBasePlotter::moveGraphDown()   */
+        inline void moveGraphDown(int idx) {  plotter->moveGraphDown(idx); }
+
+        /** \copydoc JKQTBasePlotter::addGraphs()   */
         template <class TJKQTPGraphContainer>
         inline void addGraphs(const TJKQTPGraphContainer& gr, QVector<size_t>* graphIDsOut=nullptr) { plotter->addGraphs(gr, graphIDsOut); }
 
 
-        /** \brief returns the current x-axis min  \see JKQTBasePlotter::getYAxis() */
+        /** \copydoc JKQTBasePlotter::getXMin()   */
         inline double getXMin() const {return plotter->getXMin(); }
-
-        /** \brief returns the current x-axis max  \see JKQTBasePlotter::getYAxis() */
+        /** \copydoc JKQTBasePlotter::getXMax()   */
         inline double getXMax() const {return plotter->getXMax(); }
-
-        /** \brief returns the current y-axis min  \see JKQTBasePlotter::getYAxis() */
+        /** \copydoc JKQTBasePlotter::getYMin()   */
         inline double getYMin() const {return plotter->getYMin(); }
-
-        /** \brief returns the current y-axis max  \see JKQTBasePlotter::getYAxis() */
+        /** \copydoc JKQTBasePlotter::getYMax()   */
         inline double getYMax() const {return plotter->getYMax(); }
-
-
-
-        /** \brief returns the absolute x-axis min */
+        /** \copydoc JKQTBasePlotter::getAbsoluteXMin()   */
         inline double getAbsoluteXMin() const {return plotter->getAbsoluteXMin(); }
-        /** \brief returns the absolute x-axis max */
+        /** \copydoc JKQTBasePlotter::getAbsoluteXMax()   */
         inline double getAbsoluteXMax() const {return plotter->getAbsoluteXMax(); }
-
-        /** \brief returns the absolute y-axis min */
+        /** \copydoc JKQTBasePlotter::getAbsoluteYMin()   */
         inline double getAbsoluteYMin() const {return plotter->getAbsoluteYMin(); }
-
-        /** \brief returns the absolute y-axis max */
+        /** \copydoc JKQTBasePlotter::getAbsoluteYMax()   */
         inline double getAbsoluteYMax() const {return plotter->getAbsoluteYMax(); }
 
         /** \brief returns the current magnification factor */
         inline double getMagnification() const { return magnification; }
 
-        /** \brief gets the next unused style id, i.e. the smalles number >=0 which is not contained in usedStyles */
+        /** \copydoc JKQTBasePlotter::getNextStyle()   */
         inline int getNextStyle() {
             return getPlotter()->getNextStyle();
         }
 
-        /** \brief returns a QPen object for the i-th plot style */
+        /** \copydoc JKQTBasePlotter::getPlotStyle()   */
         inline JKQTBasePlotter::JKQTPPen getPlotStyle(int i) const {
             return getConstplotter()->getPlotStyle(i);
         }
 
 
-        /** \brief font size for key labels [in points] */
+        /** \copydoc JKQTBasePlotter::getKeyFontSize()   */
         inline double getKeyFontSize() const {
             return getConstplotter()->getKeyFontSize();
         }
@@ -872,11 +900,11 @@ class JKQTPLOTTER_LIB_EXPORT JKQTPlotter: public QWidget {
         /** \brief \copydoc actMouseLeftAsPanView */
         const QAction *getActMouseLeftAsPanView() const;
 
-        /** \brief save the current plot as a pixel image into a QImage with the given size */
+        /** \copydoc JKQTBasePlotter::grabPixelImage()   */
         inline QImage grabPixelImage(QSize size=QSize(), bool showPreview=false) {
             return plotter->grabPixelImage(size,showPreview);
         }
-        /** \brief copy the current plot as a pixel+svg image to the clipboard */
+        /** \copydoc JKQTBasePlotter::copyPixelImage()   */
         inline void copyPixelImage(bool showPreview=true) {
             plotter->copyPixelImage(showPreview);
         }
@@ -889,17 +917,12 @@ class JKQTPLOTTER_LIB_EXPORT JKQTPlotter: public QWidget {
             plotter->zoom(nxmin, nxmax, nymin, nymax);
         }
 
-        /** \brief sets whether to plot grid lines or not
-         *
-         * \image html jkqtplotter_gridvisible.png "Grid visible"
-         * \image html jkqtplotter_gridinvisible.png "Grid invisible"
-         * */
-        inline void setGrid(bool val) {
+        /** \copydoc JKQTBasePlotter::setGrid()   */
+         inline void setGrid(bool val) {
             plotter->setGrid(val);
         }
 
-        /** \brief sets the color of all Major grid lines
-         * */
+        /** \copydoc JKQTBasePlotter::setGridColor()   */
         inline void setGridColor(QColor color) {
             plotter->setGridColor(color);
         }