Isis 3 Programmer Reference
PlotWindow.h
Go to the documentation of this file.
1 #ifndef PlotWindow_h
2 #define PlotWindow_h
3 
27 // This is needed for the QVariant macro
28 #include <QMetaType>
29 
30 // This is the parent
31 #include "MainWindow.h"
32 
33 // This is for an enum inside of plot curve
34 #include "PlotCurve.h"
35 
36 class QwtPlot;
37 class QwtPlotGrid;
38 class QwtPlotSpectrogram;
39 class QwtPlotZoomer;
40 class QwtLegend;
41 
42 class QDockWidget;
43 class QListWidgetItem;
44 class QLineEdit;
45 class QComboBox;
46 class QCheckBox;
47 
48 template <typename A, typename B> struct QPair;
49 
50 namespace Isis {
51  class MdiCubeViewport;
52  class CubePlotCurve;
53  //class CubePlotCurveConfigureDialog;
54  class PvlKeyword;
55  class TableMainWindow;
56 
88  class PlotWindow : public MainWindow {
89  Q_OBJECT
90 
91  public:
96  enum MenuOptions {
164 
181 
182 
183  };
184 
185  PlotWindow(QString title, PlotCurve::Units xAxisUnits,
187  MenuOptions optionsToProvide = AllMenuOptions);
188  ~PlotWindow();
189  virtual void add(CubePlotCurve *pc);
190  virtual void clearPlotCurves();
191 
192  bool canAdd(CubePlotCurve *curveToTest) const;
193  QColor plotBackgroundColor() const;
198  QString plotTitle() const;
199  bool userCanAddCurves() const;
202 
203  virtual void paint(MdiCubeViewport *vp, QPainter *painter);
204  void replot();
205  void setAxisLabel(int axisId, QString title);
206  void setPlotBackground(QColor c);
207  void setPlotTitle(QString pt);
208  void setUserCanAddCurves(bool);
209  void showWindow();
210  virtual void update(MdiCubeViewport *activeViewport);
211 
212  static QString defaultWindowTitle();
213 
214 
215  signals:
220  void closed();
222  void plotChanged();
223 
224  void requestFillTable();
225 
226  public slots:
227  void clearPlot();
228  void configurePlotCurves();
229  void createBestFitLine();
230  void printPlot();
231  void changePlotLabels();
232  void savePlot();
233  void setDefaultRange();
234  void setLabels();
235  void setUserValues();
236  void showHideAllMarkers();
237  void showHideAllCurves();
238  void resetScale();
239  void showHideGrid();
240  void showHelp();
241  void showTable();
242  void switchBackground();
243  void trackerEnabled();
244 
245  void scheduleFillTable();
246  void fillTable();
247 
248  protected:
249  void createWidgets(MenuOptions optionsToProvide);
250  void disableAxisAutoScale();
251  virtual void dragEnterEvent(QDragEnterEvent *event);
252  virtual void dropEvent(QDropEvent *event);
253  virtual bool eventFilter(QObject *o, QEvent *e);
254 
255  using QWidget::mousePressEvent;
256  void mousePressEvent(QObject *object, QMouseEvent *e);
257 
258  QwtPlot *plot();
259  void setMenus(QList<QMenu *> menus, QList<QAction *> actions);
260  QwtPlotZoomer *zoomer();
261 
262  private slots:
264  void onClipboardChanged();
265  void pasteCurve();
266 
267  private:
268  QPair<double, double> findDataRange(int axisId) const;
269  static bool numericStringLessThan(QString left, QString right);
270  bool userCanAddCurve(const QMimeData *curve);
271  void updateVisibility(PlotCurve *curve);
272  void setupDefaultMenu(MenuOptions optionsToProvide);
273 
277  QwtPlotZoomer *m_zoomer;
279  QwtPlotGrid *m_grid;
283  QCheckBox *m_xLogCheckBox;
285  QCheckBox *m_yLogCheckBox;
287  QLineEdit *m_xMinEdit;
289  QLineEdit *m_xMaxEdit;
291  QLineEdit *m_yMinEdit;
293  QLineEdit *m_yMaxEdit;
295  QLineEdit *m_xAxisText;
297  QLineEdit *m_yAxisText;
299  QLineEdit *m_plotTitleText;
300 
302  QMenuBar *m_menubar;
303 
310 
312  QPointer<QAction> m_action;
314  QPointer<QAction> m_showHideAllCurves;
316  QPointer<QAction> m_showHideAllMarkers;
318  QPointer<QAction> m_showHideGrid;
319 
324 
329 
331  QwtLegend *m_legend;
336 
337  bool m_scheduledFillTable;
338  };
339 };
340 
343 
344 // There isn't a great place to put this currently since it's not a class we
345 // can manage the header for.
347 Q_DECLARE_OPAQUE_POINTER(QwtPlotSpectrogram *);
348 Q_DECLARE_METATYPE(QwtPlotSpectrogram *);
349 
350 #endif
Isis::PlotWindow::dragEnterEvent
virtual void dragEnterEvent(QDragEnterEvent *event)
When a user drags data into our plot window, we need to indicate whether or not this data is compatib...
Definition: PlotWindow.cpp:1823
QwtPlot
Isis::PlotWindow::m_plotXLogScale
bool m_plotXLogScale
Tracks if the plot X axis is using a log (true) or linear (false) scale.
Definition: PlotWindow.h:332
Isis::PlotWindow::m_xMinEdit
QLineEdit * m_xMinEdit
Set Scale Dialog's edit for the min X-axis value.
Definition: PlotWindow.h:287
Isis::PlotWindow::yAxisUnits
PlotCurve::Units yAxisUnits() const
This is the data-type of the curves' y data in this plot window.
Definition: PlotWindow.cpp:278
Isis::PlotWindow::m_showHideAllMarkers
QPointer< QAction > m_showHideAllMarkers
Hide all markers action.
Definition: PlotWindow.h:316
Isis::PlotWindow::setMenus
void setMenus(QList< QMenu * > menus, QList< QAction * > actions)
Sets up the menus added from a parent object.
Definition: PlotWindow.cpp:1358
Isis::PlotWindow::m_legend
QwtLegend * m_legend
The legend inserted in this plot.
Definition: PlotWindow.h:331
Isis::PlotWindow::showWindow
void showWindow()
Shows the plot window, and raises it to the front of any overlapping sibling widgets.
Definition: PlotWindow.cpp:185
Isis::PlotWindow::showHideGrid
void showHideGrid()
This method hides/shows the grid on the plotWindow and changes the text for the action.
Definition: PlotWindow.cpp:923
Isis::MdiCubeViewport
Cube display widget for certain Isis MDI applications.
Definition: MdiCubeViewport.h:39
QWidget
Isis::PlotWindow::createBestFitLine
void createBestFitLine()
This method prompts the user to select the best fit line criterea.
Definition: PlotWindow.cpp:529
Isis::PlotWindow::m_grid
QwtPlotGrid * m_grid
Plot grid lines.
Definition: PlotWindow.h:279
Isis::PlotWindow::m_showHideGrid
QPointer< QAction > m_showHideGrid
Show plot grid lines action.
Definition: PlotWindow.h:318
Isis::PlotWindow::ResetScaleMenuOption
@ ResetScaleMenuOption
This option provides the user with an alternative zoom out button.
Definition: PlotWindow.h:147
Isis::PlotWindow::setLabels
void setLabels()
Makes the user specified changes to the plot labels.
Definition: PlotWindow.cpp:910
Isis::PlotWindow::m_autoscaleAxes
bool m_autoscaleAxes
True if we are autoscaling the x-bottom and y-left axes.
Definition: PlotWindow.h:328
QList
This is free and unencumbered software released into the public domain.
Definition: BoxcarCachingAlgorithm.h:13
Isis::PlotWindow::plotTitle
QString plotTitle() const
Returns the plot title.
Definition: PlotWindow.cpp:241
Isis::PlotWindow::PlotWindow
PlotWindow(QString title, PlotCurve::Units xAxisUnits, PlotCurve::Units yAxisUnits, QWidget *parent, MenuOptions optionsToProvide=AllMenuOptions)
This constructs a plot window.
Definition: PlotWindow.cpp:66
Isis::CubePlotCurve
This is a plot curve with information relating it to a particular cube or region of a cube.
Definition: CubePlotCurve.h:53
Isis::PlotWindow::setAxisLabel
void setAxisLabel(int axisId, QString title)
Sets the plots given axis title to the given string.
Definition: PlotWindow.cpp:208
Isis::PlotWindow::showHelp
void showHelp()
This method creates and shows the help dialog box for the plot window.
Definition: PlotWindow.cpp:999
Isis::PlotWindow::showHideAllMarkers
void showHideAllMarkers()
Shows/Hides all the markers(symbols)
Definition: PlotWindow.cpp:939
Isis::PlotWindow::setUserValues
void setUserValues()
This method sets the scale for the axis according to the user specified numbers.
Definition: PlotWindow.cpp:694
Isis::PlotWindow::userCanAddCurves
bool userCanAddCurves() const
Ask if a user action can add this curve to this window in general.
Definition: PlotWindow.cpp:254
Isis::PlotWindow::fillTable
void fillTable()
Fills in the table with the data from the current curves in the plotWindow immediately.
Definition: PlotWindow.cpp:1411
Isis::PlotWindow::m_yLogCheckBox
QCheckBox * m_yLogCheckBox
Set Scale Dialog's checkbox for using logarithmic scale for the y axis.
Definition: PlotWindow.h:285
Isis::PlotWindow::showHideAllCurves
void showHideAllCurves()
This method shows or hides all of the curves in the plotWindow.
Definition: PlotWindow.cpp:967
Isis::PlotWindow::printPlot
void printPlot()
Provides printing support of the plot image.
Definition: PlotWindow.cpp:573
Isis::PlotWindow::ShowHideCurvesMenuOption
@ ShowHideCurvesMenuOption
This option is titled 'Hide All Curves' which makes all curves invisible.
Definition: PlotWindow.h:103
Isis::PlotCurve
Definition: PlotCurve.h:44
Isis::PlotWindow::changePlotLabels
void changePlotLabels()
This method creates the dialog box which allows the user to relabel the plot window.
Definition: PlotWindow.cpp:854
Isis::PlotWindow::m_yMaxEdit
QLineEdit * m_yMaxEdit
Set Scale Dialog's edit for the max Y-axis value.
Definition: PlotWindow.h:293
Isis::PlotWindow::m_plotTitleText
QLineEdit * m_plotTitleText
Set Labels Dialog's edit for the plot title.
Definition: PlotWindow.h:299
Isis::PlotWindow::MenuOptions
MenuOptions
There is a menu option for everything in the plot window's menu.
Definition: PlotWindow.h:96
Isis::PlotWindow::showTable
void showTable()
This method is called from the showTable action on the tool bar There are some checks done to make su...
Definition: PlotWindow.cpp:1566
Isis::PlotWindow::m_yAxisUnits
PlotCurve::Units m_yAxisUnits
The units of the data on the y-left axis.
Definition: PlotWindow.h:323
Isis::PlotWindow::defaultWindowTitle
static QString defaultWindowTitle()
This is the typical suffix for plot windows, it's here in case we want to update all plot windows to ...
Definition: PlotWindow.cpp:1810
Isis::PlotWindow::findDataRange
QPair< double, double > findDataRange(int axisId) const
This calculates the data range of the specified axis (works with xBottom and yLeft only).
Definition: PlotWindow.cpp:1722
Isis::PlotWindow::updateVisibility
void updateVisibility(PlotCurve *curve)
This method sets the visibility states in the curve (and it's symbols) to match with this window's cu...
Definition: PlotWindow.cpp:1330
Isis::PlotCurve::Units
Units
These are all the possible units for the x or y data in a plot curve.
Definition: PlotCurve.h:54
Isis::PlotWindow::update
virtual void update(MdiCubeViewport *activeViewport)
This is provided to allow children to react to tool updates.
Definition: PlotWindow.cpp:197
Isis::PlotWindow::add
virtual void add(CubePlotCurve *pc)
This method adds the curves to the plot.
Definition: PlotWindow.cpp:436
Isis::PlotWindow::ShowHideGridMenuOption
@ ShowHideGridMenuOption
This option enables the ability for a user to enable a grid over the plot area.
Definition: PlotWindow.h:134
QToolBar
Isis::PlotWindow::BackgroundSwitchMenuOption
@ BackgroundSwitchMenuOption
This option enables the ability for a user to change the background color of the plot from black to w...
Definition: PlotWindow.h:129
QComboBox
Isis::PlotWindow::m_xLogCheckBox
QCheckBox * m_xLogCheckBox
Set Scale Dialog's checkbox for using logarithmic scale for the x axis.
Definition: PlotWindow.h:283
Isis::PlotWindow::m_zoomer
QwtPlotZoomer * m_zoomer
Plot Zoomer.
Definition: PlotWindow.h:277
Isis::PlotWindow::configurePlotCurves
void configurePlotCurves()
This method creates a CubePlotCurveConfigureDialog object.
Definition: PlotWindow.cpp:508
Isis::PlotWindow::ShowTableMenuOption
@ ShowTableMenuOption
This option brings up the table.
Definition: PlotWindow.h:108
Isis::PlotWindow::AllMenuOptions
@ AllMenuOptions
This is all of the available menu options.
Definition: PlotWindow.h:173
Isis::PlotWindow::zoomer
QwtPlotZoomer * zoomer()
Get this window's plot's zoomer.
Definition: PlotWindow.cpp:1388
Isis::PlotWindow::xAxisUnits
PlotCurve::Units xAxisUnits() const
This is the data-type of the curves' x data in this plot window.
Definition: PlotWindow.cpp:266
Isis::PlotWindow::setupDefaultMenu
void setupDefaultMenu(MenuOptions optionsToProvide)
The user can add menu items from parent classes, but there are some menu items that are common betwee...
Definition: PlotWindow.cpp:1048
Isis::PlotWindow::onClipboardChanged
void onClipboardChanged()
This slot will be called when the system clipboard is changed.
Definition: PlotWindow.cpp:1686
Isis::PlotWindow::plotBackgroundColor
QColor plotBackgroundColor() const
Returns the plot's background color.
Definition: PlotWindow.cpp:317
Isis::PlotWindow::m_pasteAct
QAction * m_pasteAct
This is the paste action in the edit menu to paste a curve into the plot window.
Definition: PlotWindow.h:309
Isis::PlotWindow::RenameLabelsMenuOption
@ RenameLabelsMenuOption
This option enables the ability for a user to change the x/y axis labels and plot title.
Definition: PlotWindow.h:139
PlotCurve.h
Isis::PlotWindow::m_tableWindow
TableMainWindow * m_tableWindow
Table window.
Definition: PlotWindow.h:334
Isis::PlotWindow::dropEvent
virtual void dropEvent(QDropEvent *event)
This is called when a user drops data into our window.
Definition: PlotWindow.cpp:1844
Isis::PlotWindow::setUserCanAddCurves
void setUserCanAddCurves(bool)
Allow or disallow users from manually putting curves into this plot window through either copy-and-pa...
Definition: PlotWindow.cpp:231
Isis::PlotWindow::mousePressEvent
void mousePressEvent(QObject *object, QMouseEvent *e)
This is a helper method for the eventFilter() method.
Definition: PlotWindow.cpp:1628
Isis::PlotWindow::setDefaultRange
void setDefaultRange()
Resets the x/y min/max to the defaults.
Definition: PlotWindow.cpp:743
Isis::PlotWindow::plotCurves
QList< CubePlotCurve * > plotCurves()
Get a comprehensive list of the plot curves inside of this plot window, excluding plot curves that ar...
Definition: PlotWindow.cpp:328
Isis::PlotWindow::userCanAddCurve
bool userCanAddCurve(const QMimeData *curve)
Ask if a user action can add this curve to this window.
Definition: PlotWindow.cpp:1306
Isis::PlotWindow::scheduleFillTable
void scheduleFillTable()
Fills in the table with the data from the current curves in the plotWindow once all current actions/a...
Definition: PlotWindow.cpp:1399
Isis::PlotWindow::m_showHideAllCurves
QPointer< QAction > m_showHideAllCurves
Hide all curves action.
Definition: PlotWindow.h:314
Isis::PlotWindow::SaveMenuOption
@ SaveMenuOption
This option exports the plot into a standard image format.
Definition: PlotWindow.h:114
Isis::TableMainWindow
a subclass of the qisis mainwindow, tablemainwindow handles all of the table tasks.
Definition: TableMainWindow.h:57
Isis::PlotWindow::m_action
QPointer< QAction > m_action
Plot window's action.
Definition: PlotWindow.h:312
Isis::PlotWindow::PrintMenuOption
@ PrintMenuOption
This option sends the plot to a printer.
Definition: PlotWindow.h:118
Isis::PlotWindow::m_parent
QWidget * m_parent
Parent widget.
Definition: PlotWindow.h:275
Isis::PlotWindow::setPlotBackground
void setPlotBackground(QColor c)
Sets the plot background color to the given color.
Definition: PlotWindow.cpp:289
Isis::PlotWindow::LineFitMenuOption
@ LineFitMenuOption
This option allows the user to create a best fit line for any of the scatter plot data or cube plot c...
Definition: PlotWindow.h:163
Isis::PlotWindow::disableAxisAutoScale
void disableAxisAutoScale()
This turns off scaling the x/y axes automatically.
Definition: PlotWindow.cpp:1664
Isis::PlotWindow::plotSpectrograms
QList< QwtPlotSpectrogram * > plotSpectrograms()
Get a comprehensive list of the scatter plots (spectrograms) inside of this plot window.
Definition: PlotWindow.cpp:381
Isis::PlotWindow::plot
QwtPlot * plot()
Get the plot encapsulated by this PlotWindow.
Definition: PlotWindow.cpp:1653
Isis::PlotWindow::m_xAxisText
QLineEdit * m_xAxisText
Set Labels Dialog's edit for the x-axis label.
Definition: PlotWindow.h:295
Isis::PlotWindow::m_toolBar
QToolBar * m_toolBar
Tool bar on the plot window.
Definition: PlotWindow.h:335
Isis::PlotWindow::canAdd
bool canAdd(CubePlotCurve *curveToTest) const
This method tests whethere or not a CubePlotCurve can be successfully added to this window.
Definition: PlotWindow.cpp:305
Isis::PlotWindow::m_yAxisText
QLineEdit * m_yAxisText
Set Labels Dialog's edit for the y-axis label.
Definition: PlotWindow.h:297
Isis::PlotWindow::savePlot
void savePlot()
This method allows the user to save the plot as a png, jpg, or tif image file.
Definition: PlotWindow.cpp:605
Isis::PlotWindow::m_xMaxEdit
QLineEdit * m_xMaxEdit
Set Scale Dialog's edit for the max X-axis value.
Definition: PlotWindow.h:289
Isis::PlotWindow::autoScaleCheckboxToggled
void autoScaleCheckboxToggled()
This is a helper method for the set scale configuration dialog.
Definition: PlotWindow.cpp:1675
QPair
This is free and unencumbered software released into the public domain.
Definition: CubeIoHandler.h:23
Isis::PlotWindow::SetDisplayRangeMenuOption
@ SetDisplayRangeMenuOption
This option allows the user to set the x/y axis display value ranges.
Definition: PlotWindow.h:143
Isis::PlotWindow::m_menubar
QMenuBar * m_menubar
Plot window's menu bar.
Definition: PlotWindow.h:302
Isis::PlotWindow::m_allowUserToAddCurves
bool m_allowUserToAddCurves
Is the window showing the curve markers?
Definition: PlotWindow.h:326
Isis::PlotWindow::trackerEnabled
void trackerEnabled()
Enables the plot mouse tracker.
Definition: PlotWindow.cpp:560
Isis::PlotWindow::m_xAxisUnits
PlotCurve::Units m_xAxisUnits
The units of the data on the x-bottom axis.
Definition: PlotWindow.h:321
Isis::PlotWindow::ShowHideMarkersMenuOption
@ ShowHideMarkersMenuOption
This option is titled 'Hide All Symbols' which hides all markers.
Definition: PlotWindow.h:98
Isis::PlotWindow::TrackMenuOption
@ TrackMenuOption
This option enables mouse tracking on the plot area (displays next to the mouse which x/y point you a...
Definition: PlotWindow.h:124
Isis::PlotWindow::m_yMinEdit
QLineEdit * m_yMinEdit
Set Scale Dialog's edit for the min Y-axis value.
Definition: PlotWindow.h:291
Isis::PlotWindow::ConfigurePlotMenuOption
@ ConfigurePlotMenuOption
This option allows the user to change the curve name, color, style size, and symbol of the curve.
Definition: PlotWindow.h:169
Isis::MainWindow
Base class for the Qisis main windows.
Definition: MainWindow.h:24
Isis::PlotWindow::m_autoScaleCheckBox
QCheckBox * m_autoScaleCheckBox
Set Scale Dialog's checkbox for enabling automatic scaling on x & y.
Definition: PlotWindow.h:281
QObject
Isis::PlotWindow::createWidgets
void createWidgets(MenuOptions optionsToProvide)
This method is called by the constructor to create the plot, legend.
Definition: PlotWindow.cpp:145
Isis::PlotWindow::replot
void replot()
Reset the scale of the plot, replot it and emit plot changed.
Definition: PlotWindow.cpp:1797
Isis::PlotWindow::m_plot
QwtPlot * m_plot
The plot in this window.
Definition: PlotWindow.h:330
Isis::PlotWindow::switchBackground
void switchBackground()
This method toggles the plot background color between black and white.
Definition: PlotWindow.cpp:635
Isis::PlotWindow
Definition: PlotWindow.h:88
Isis::PlotWindow::clearPlot
void clearPlot()
This method completely clears the plot of all plot items.
Definition: PlotWindow.cpp:492
QAction
QDockWidget
Isis::PlotWindow::ClearPlotMenuOption
@ ClearPlotMenuOption
This option allows the user to delete all of the data inside the plot.
Definition: PlotWindow.h:153
Isis::PlotWindow::eventFilter
virtual bool eventFilter(QObject *o, QEvent *e)
This method filters the events of the objects it is connected to.
Definition: PlotWindow.cpp:1590
Isis::PlotWindow::setPlotTitle
void setPlotTitle(QString pt)
Sets the plot title to the given string.
Definition: PlotWindow.cpp:219
Isis::PlotWindow::plotChanged
void plotChanged()
Emitted every time there is a change to the plot window.
Isis::PlotWindow::resetScale
void resetScale()
Sets plot scale back to the defaults.
Definition: PlotWindow.cpp:660
Isis::PlotWindow::closed
void closed()
Emitted when there is a close event on this window that will be accepted.
Isis::PlotWindow::m_plotYLogScale
bool m_plotYLogScale
Tracks if the plot Y axis is using a log (true) or linear (false) scale.
Definition: PlotWindow.h:333
Isis::PlotWindow::pasteCurve
void pasteCurve()
When the user pastes a curve try to put it into this plot window.
Definition: PlotWindow.cpp:1697
Isis::PlotWindow::clearPlotCurves
virtual void clearPlotCurves()
This method also clears the plot of all plot items, but does not call the table delete stuff This met...
Definition: PlotWindow.cpp:540
Isis
This is free and unencumbered software released into the public domain.
Definition: Apollo.h:16
Q_DECLARE_OPAQUE_POINTER
Q_DECLARE_OPAQUE_POINTER(QwtPlotSpectrogram *)
We have scatter plot types as QVariant data types, so here it's enabled.
Q_DECLARE_METATYPE
Q_DECLARE_METATYPE(Isis::PlotWindow *)
We have plot windows as QVariant data types, so here it's enabled.
Isis::PlotWindow::paint
virtual void paint(MdiCubeViewport *vp, QPainter *painter)
Paint plot curve information onto the viewport.
Definition: PlotWindow.cpp:1787
Isis::PlotWindow::DefaultHelpMenuOption
@ DefaultHelpMenuOption
Not implemented.
Definition: PlotWindow.h:157