Isis::ScatterPlotWindow Class Reference

Scatter Plot Window. More...

#include <ScatterPlotWindow.h>

Inherits Isis::PlotWindow.

List of all members.

Public Types
enum	AlarmRangeUnits { CubeUnits, ScreenUnits }
	This enumeration differentiates alarming a strict cube DN box size from a screen region. More...
enum	MenuOptions {   ShowHideMarkersMenuOption = 1, ShowHideCurvesMenuOption = 2, ShowTableMenuOption = 4, SaveMenuOption = 8,   PrintMenuOption = 16, TrackMenuOption = 32, BackgroundSwitchMenuOption = 64, ShowHideGridMenuOption = 128,   RenameLabelsMenuOption = 256, SetDisplayRangeMenuOption = 512, ResetScaleMenuOption = 1024, ClearPlotMenuOption = 2048,   DefaultHelpMenuOption = 4096, LineFitMenuOption = 8192, AllMenuOptions }
	There is a menu option for everything in the plot window's menu. More...
Public Slots
void	forgetCubes ()
	This causes the window to lose it's pointers to the input cubes.
void	clearPlot ()
	This method completely clears the plot of all plot items.
void	createBestFitLine ()
	This method prompts the user to select the best fit line criterea.
void	printPlot ()
	Provides printing support of the plot image.
void	changePlotLabels ()
	This method creates the dialog box which allows the user to relabel the plot window.
void	savePlot ()
	This method allows the user to save the plot as a png, jpg, or tif image file.
void	setDefaultRange ()
	Resets the x/y min/max to the defaults.
void	setLabels ()
	Makes the user specified changes to the plot labels.
void	setUserValues ()
	This method sets the scale for the axis according to the user specified numbers.
void	showHideAllMarkers ()
	Shows/Hides all the markers(symbols).
void	showHideAllCurves ()
	This method shows or hides all of the curves in the plotWindow.
void	resetScale ()
	Sets plot scale back to the defaults.
void	showHideGrid ()
	This method hides/shows the grid on the plotWindow and changes the text for the action.
void	showHelp ()
	This method creates and shows the help dialog box for the plot window.
void	showTable ()
	This method is called from the showTable action on the tool bar There are some checks done to make sure there are data to fill the table.
void	switchBackground ()
	This method toggles the plot background color between black and white.
void	trackerEnabled ()
	Enables the plot mouse tracker.
void	scheduleFillTable ()
	Fills in the table with the data from the current curves in the plotWindow once all current actions/activations are done.
void	fillTable ()
	Fills in the table with the data from the current curves in the plotWindow immediately.
Signals
void	closed ()
	Emitted when there is a close event on this window that will be accepted.
void	plotChanged ()
	Emitted every time there is a change to the plot window.
void	requestFillTable ()
Public Member Functions
	ScatterPlotWindow (QString title, Cube *xAxisCube, int xAxisBand, int xAxisBinCount, Cube *yAxisCube, int yAxisBand, int yAxisBinCount, QwtInterval sampleRange, QwtInterval lineRange, QWidget *parent)
	Create a scatter plot window with the given data.
virtual	~ScatterPlotWindow ()
bool	alarmingPlot () const
	This indicates if we are alarming from viewport to plot.
bool	alarmingViewport () const
	This indicates if we are alarming from plot to viewport.
QPair< int, int >	alarmPlotBoxSize () const
	This is the sample/line box sizes for alarming from viewport to plot.
AlarmRangeUnits	alarmViewportUnits () const
	This is the active alarming units for plot->viewport.
QPair< int, int >	alarmViewportScreenBoxSize () const
	This is the alarming box size for plot->viewport in screen units.
QPair< double, double >	alarmViewportDnBoxSize () const
	This is the alarming box size for plot->viewport in cube units (number of samples/lines).
bool	eventFilter (QObject *o, QEvent *e)
	We override events done on the plot canvas for alarming purposes.
virtual void	paint (MdiCubeViewport *vp, QPainter *painter)
	If the viewport is showing the x axis cube data or y axis cube data, and alarming is enabled, this paints alarmed values from the plot onto the viewport.
void	setMousePosition (MdiCubeViewport *vp, QPoint mouseLoc)
	Saves the current mouse position in the viewport so that the plot can be alarmed around that position.
void	setAlarmingPlot (bool)
	This enables or disables alarming viewport->plot.
void	setAlarmingViewport (bool)
	This enables or disables alarming plot->viewport.
void	setAlarmPlotBoxSize (int, int)
	This sets the box size for alarming viewport->plot in cube samples/lines.
void	setAlarmViewportUnits (AlarmRangeUnits)
	This sets the units to be used for alarming plot->viewport.
void	setAlarmViewportScreenBoxSize (int, int)
	This sets the screen pixel box size for alarming plot->viewport.
void	setAlarmViewportDnBoxSize (double, double)
	This sets the cube DN box size for alarming plot->viewport.
virtual void	add (CubePlotCurve *pc)
	This method adds the curves to the plot.
virtual void	clearPlotCurves ()
	This method also clears the plot of all plot items, but does not call the table delete stuff This method is called from plotTool each time the changePlot() method is called.
bool	canAdd (CubePlotCurve *curveToTest) const
	This method tests whethere or not a CubePlotCurve can be successfully added to this window.
QColor	plotBackgroundColor () const
	Returns the plot's background color.
QList< CubePlotCurve * >	plotCurves ()
	Get a comprehensive list of the plot curves inside of this plot window, excluding plot curves that are in the process of being removed.
QList< const CubePlotCurve * >	plotCurves () const
	Get a comprehensive const list of the plot curves inside of this plot window, excluding plot curves that are in the process of being removed.
QList< QwtPlotSpectrogram * >	plotSpectrograms ()
	Get a comprehensive list of the scatter plots (spectrograms) inside of this plot window.
QList< const QwtPlotSpectrogram * >	plotSpectrograms () const
	Get a comprehensive const list of the scatter plots (spectrograms) inside of this plot window.
QString	plotTitle () const
	Returns the plot title.
bool	userCanAddCurves () const
	Ask if a user action can add this curve to this window in general.
PlotCurve::Units	xAxisUnits () const
	This is the data-type of the curves' x data in this plot window.
PlotCurve::Units	yAxisUnits () const
	This is the data-type of the curves' y data in this plot window.
void	replot ()
	Reset the scale of the plot, replot it and emit plot changed.
void	setAxisLabel (int axisId, QString title)
	Sets the plots given axis title to the given string.
void	setPlotBackground (QColor c)
	Sets the plot background color to the given color.
void	setPlotTitle (QString pt)
	Sets the plot title to the given string.
void	setUserCanAddCurves (bool)
	Allow or disallow users from manually putting curves into this plot window through either copy-and-paste or drag-and-drop.
void	showWindow ()
	Shows the plot window, and raises it to the front of any overlapping sibling widgets.
virtual void	update (MdiCubeViewport *activeViewport)
	This is provided to allow children to react to tool updates.
Static Public Member Functions
static QString	defaultWindowTitle ()
	This is the typical suffix for plot windows, it's here in case we want to update all plot windows to have a different ending than just 'Plot' on them (for example, 'Plot Window').
static QString	settingsFileName (QString objectTitle)
Protected Slots
void	colorPlot ()
	This method switches the color mode of the scatter plot from black and white to color and visa versa.
void	showHideContour ()
	This method hides or displays the contour lines on the spectrogram.
Protected Member Functions
void	createWidgets (MenuOptions optionsToProvide)
	This method is called by the constructor to create the plot, legend.
void	disableAxisAutoScale ()
	This turns off scaling the x/y axes automatically.
virtual void	dragEnterEvent (QDragEnterEvent *event)
	When a user drags data into our plot window, we need to indicate whether or not this data is compatible with this window.
virtual void	dropEvent (QDropEvent *event)
	This is called when a user drops data into our window.
void	mousePressEvent (QObject *object, QMouseEvent *e)
	This is a helper method for the eventFilter() method.
QwtPlot *	plot ()
	Get the plot encapsulated by this PlotWindow.
void	setMenus (QList< QMenu * > menus, QList< QAction * > actions)
	Sets up the menus added from a parent object.
QwtPlotZoomer *	zoomer ()
	Get this window's plot's zoomer.
QString	settingsFileName () const
virtual void	closeEvent (QCloseEvent *event)
	This method is overridden so that we can be sure to write the current settings of the Main window.
virtual void	readSettings (QSize defaultSize=QSize())
	This method ensure that the settings get written even if the Main window was only hidden, not closed.

---

Detailed Description

Scatter Plot Window.

Author:

????-??-?? Stacy Alley

---

Member Enumeration Documentation

enum Isis::ScatterPlotWindow::AlarmRangeUnits

This enumeration differentiates alarming a strict cube DN box size from a screen region.

Enumerator:

CubeUnits	Alarming is a DN range around the mouse.
ScreenUnits	Alarming is a visible area around the mouse.

enum Isis::PlotWindow::MenuOptions [inherited]

There is a menu option for everything in the plot window's menu.

This is provided so that you can enable/disable any given option.

Enumerator:

ShowHideMarkersMenuOption	This option is titled 'Hide All Symbols' which hides all markers.
ShowHideCurvesMenuOption	This option is titled 'Hide All Curves' which makes all curves invisible.
ShowTableMenuOption	This option brings up the table. No table will be available without this option.
SaveMenuOption	This option exports the plot into a standard image format. No conversion to a standard image format file will be available without this option, but printing will still be available.
PrintMenuOption	This option sends the plot to a printer.
TrackMenuOption	This option enables mouse tracking on the plot area (displays next to the mouse which x/y point you are hovering over). This option is by default disabled.
BackgroundSwitchMenuOption	This option enables the ability for a user to change the background color of the plot from black to white.
ShowHideGridMenuOption	This option enables the ability for a user to enable a grid over the plot area.
RenameLabelsMenuOption	This option enables the ability for a user to change the x/y axis labels and plot title.
SetDisplayRangeMenuOption	This option allows the user to set the x/y axis display value ranges.
ResetScaleMenuOption	This option provides the user with an alternative zoom out button.
ClearPlotMenuOption	This option allows the user to delete all of the data inside the plot. If you don't want the user deleting a custom plot item, you should disable this option.
DefaultHelpMenuOption	Not implemented.
LineFitMenuOption	This option allows the user to create a best fit line for any of the scatter plot data or cube plot curve data in the window. This allows the user to create new plot curves.
AllMenuOptions	This is all of the available menu options.

---

Constructor & Destructor Documentation

Isis::ScatterPlotWindow::ScatterPlotWindow	(	QString	title,
		Cube *	xAxisCube,
		int	xAxisBand,
		int	xAxisBinCount,
		Cube *	yAxisCube,
		int	yAxisBand,
		int	yAxisBinCount,
		QwtInterval	sampleRange,
		QwtInterval	lineRange,
		QWidget *	parent
	)

Create a scatter plot window with the given data.

This will fully populate the window with scatter plot data automatically.

Parameters:

	title	The window title and plot title
	xAxisCube	The cube to use for reading X values
	xAxisBand	The band of the x axis cube to read
	xAxisBinCount	The resolution of the x axis data
	yAxisCube	The cube to use for reading X values
	yAxisBand	The band of the y axis cube to read
	yAxisBinCount	The resolution of the y axis data
	sampleRange	The sample range, inclusive 1-based, to read data from
	lineRange	The line range, inclusive 1-based, to read data from
	parent	The Qt-parent relationship parent widget

References colorPlot(), Isis::PlotWindow::disableAxisAutoScale(), Isis::FileName::expanded(), Isis::Cube::fileName(), Isis::Null, Isis::PlotWindow::plot(), Isis::PlotWindow::replot(), ScreenUnits, showHideContour(), Isis::ScatterPlotData::xCubeMax(), Isis::ScatterPlotData::xCubeMin(), Isis::ScatterPlotData::yCubeMax(), Isis::ScatterPlotData::yCubeMin(), and Isis::PlotWindow::zoomer().

Isis::ScatterPlotWindow::~ScatterPlotWindow

(

)

[virtual]

References Isis::FileName::expanded().

---

Member Function Documentation

void Isis::PlotWindow::add

(

CubePlotCurve *

pc

)

[virtual, inherited]

This method adds the curves to the plot.

Parameters:

pc

References Isis::PlotCurve::attachMarkers(), Isis::PlotWindow::canAdd(), Isis::PlotWindow::fillTable(), Isis::PlotWindow::plotChanged(), Isis::PlotWindow::replot(), and Isis::PlotWindow::resetScale().

Referenced by Isis::PlotWindow::dropEvent().

bool Isis::ScatterPlotWindow::alarmingPlot

(

)

const

This indicates if we are alarming from viewport to plot.

Returns:

True if alarming viewport->plot, false otherwise

Referenced by setMousePosition().

bool Isis::ScatterPlotWindow::alarmingViewport

(

)

const

This indicates if we are alarming from plot to viewport.

Returns:

True if alarming plot->viewport, false otherwise

Referenced by paint().

QPair< int, int > Isis::ScatterPlotWindow::alarmPlotBoxSize

(

)

const

This is the sample/line box sizes for alarming from viewport to plot.

Returns:

Sample Box Size, Line Box Size

QPair< double, double > Isis::ScatterPlotWindow::alarmViewportDnBoxSize

(

)

const

This is the alarming box size for plot->viewport in cube units (number of samples/lines).

If the current units are not cube units then this is not actively alarming the given box. These values are valid even when alarming is a screen pixel box, just not use, and they are never translated/re-calculated based on the conversion from screen pixels to cube pixels.

Returns:

The sample/line alarming box size

QPair< int, int > Isis::ScatterPlotWindow::alarmViewportScreenBoxSize

(

)

const

This is the alarming box size for plot->viewport in screen units.

If the current units are not screen units, this is not actively alarming the given box. These values are valid even when alarming is a Cube DN box, just not use, and they are never translated/re-calculated based on the conversion from screen pixels to cube pixels.

Returns:

The screen pixel alarming box size

ScatterPlotWindow::AlarmRangeUnits Isis::ScatterPlotWindow::alarmViewportUnits

(

)

const

This is the active alarming units for plot->viewport.

We either alarm a screen pixel box size or a cube sample/line range around the mouse.

Returns:

The units used for alarming plot->viewport

bool Isis::PlotWindow::canAdd

(

CubePlotCurve *

curveToTest

)

const [inherited]

This method tests whethere or not a CubePlotCurve can be successfully added to this window.

Plot curves with mismatched X/Y data from the plot's x/y axis types can not be added to the window. This does not test whether or not a user is allowed to add the curve manually, just if the curve can be added programatically.

Parameters:

curveToTest

The plot curve to test for compatibility with this window

Returns:

True if the curve is compatible with this window, false otherwise

References Isis::PlotCurve::xUnits(), and Isis::PlotCurve::yUnits().

Referenced by Isis::PlotWindow::add().

void Isis::PlotWindow::changePlotLabels

(

)

[slot, inherited]

This method creates the dialog box which allows the user to relabel the plot window.

References Isis::PlotWindow::plot(), and Isis::PlotWindow::setLabels().

void Isis::PlotWindow::clearPlot

(

)

[slot, inherited]

This method completely clears the plot of all plot items.

i.e. curves and markers, which also deletes the legend also calls the necessary method to delete the table stuff

References Isis::PlotWindow::clearPlotCurves(), and Isis::TableMainWindow::table().

void Isis::PlotWindow::clearPlotCurves

(

)

[virtual, inherited]

This method also clears the plot of all plot items, but does not call the table delete stuff This method is called from plotTool each time the changePlot() method is called.

References Isis::PlotWindow::replot().

Referenced by Isis::PlotWindow::clearPlot().

void Isis::PlotWindow::closed

(

)

[signal, inherited]

Emitted when there is a close event on this window that will be accepted.

Referenced by Isis::PlotWindow::eventFilter().

void Isis::MainWindow::closeEvent

(

QCloseEvent *

event

)

[protected, virtual, inherited]

This method is overridden so that we can be sure to write the current settings of the Main window.

Parameters:

event

Reimplemented in Isis::TableMainWindow, and Isis::ViewportMainWindow.

void Isis::ScatterPlotWindow::colorPlot

(

)

[protected, slot]

This method switches the color mode of the scatter plot from black and white to color and visa versa.

References Isis::PlotWindow::plot(), and Isis::PlotWindow::replot().

Referenced by ScatterPlotWindow().

void Isis::PlotWindow::createBestFitLine

(

)

[slot, inherited]

This method prompts the user to select the best fit line criterea.

The PlotWindowBestFitDialog will create the best fit line automatically when the user asks for one, so we don't need to worry about doing any more than showing a dialog here.

References Isis::PlotWindow::plot().

void Isis::PlotWindow::createWidgets

(

MenuOptions

optionsToProvide

)

[protected, inherited]

This method is called by the constructor to create the plot, legend.

zoomer, and main window.

Parameters:

optionsToProvide

This is a bit-flag containing information on which menu options to give the user/put in the GUI.

Referenced by Isis::PlotWindow::PlotWindow().

QString Isis::PlotWindow::defaultWindowTitle

(

)

[static, inherited]

This is the typical suffix for plot windows, it's here in case we want to update all plot windows to have a different ending than just 'Plot' on them (for example, 'Plot Window').

Returns:

A string to be appended to your window title

Referenced by Isis::SpectralPlotTool::createWindow(), Isis::SpatialPlotTool::createWindow(), and Isis::HistogramTool::createWindow().

void Isis::PlotWindow::disableAxisAutoScale

(

)

[protected, inherited]

This turns off scaling the x/y axes automatically.

Use this if you have a very specific axis range you want to use, but keep in mind that users (potentially) have an option to re-enable axis auto scaling if they want to.

Referenced by ScatterPlotWindow().

void Isis::PlotWindow::dragEnterEvent

(

QDragEnterEvent *

event

)

[protected, virtual, inherited]

When a user drags data into our plot window, we need to indicate whether or not this data is compatible with this window.

This checks userCanAddCurve() on the drag & drop data and allows or disallowed the event accordingly.

Parameters:

event

The drag event to test

void Isis::PlotWindow::dropEvent

(

QDropEvent *

event

)

[protected, virtual, inherited]

This is called when a user drops data into our window.

The dragEnterEvent() must have said that this curve is compatible with this window. This provides all of the available options to the user (if any) set by the creator of the drag & drop event (i.e. whether or not we can move or just copy). If there are options, we create a context menu - otherwise the default action is taken.

Parameters:

event

The drop event containing the curve to put into the current window.

References Isis::PlotWindow::add(), and Isis::PlotWindow::plotChanged().

bool Isis::ScatterPlotWindow::eventFilter	(	QObject *	o,
		QEvent *	e
	)			[virtual]

We override events done on the plot canvas for alarming purposes.

This method will forward mouse moves and leaves to the appropriate methods.

Parameters:

	o	The object on which the event happened
	e	The event that triggered this method call

Returns:

True if no more processing should happen with this event

Reimplemented from Isis::PlotWindow.

References Isis::PlotWindow::plot().

void Isis::PlotWindow::fillTable

(

)

[slot, inherited]

Fills in the table with the data from the current curves in the plotWindow immediately.

References Isis::TableMainWindow::addToTable(), Isis::IsSpecial(), Isis::TableMainWindow::listWidget(), Isis::Null, Isis::PlotWindow::plotCurves(), Isis::TableMainWindow::table(), Isis::toDouble(), Isis::toString(), and y.

Referenced by Isis::PlotWindow::add(), Isis::PlotWindow::PlotWindow(), and Isis::PlotWindow::showTable().

void Isis::ScatterPlotWindow::forgetCubes

(

)

[slot]

This causes the window to lose it's pointers to the input cubes.

When a viewport is closed, this will prevent using the cube pointers still for alarming.

void Isis::PlotWindow::mousePressEvent	(	QObject *	object,
		QMouseEvent *	event
	)			[protected, inherited]

This is a helper method for the eventFilter() method.

When a mouse press event is seen, this handles it. For example, if the user right clicks and the clipboard contains compatible data then this will give a paste option.

Parameters:

	object	The object which was pressed
	event	The mouse event which contains button information

Referenced by Isis::PlotWindow::eventFilter().

void Isis::ScatterPlotWindow::paint	(	MdiCubeViewport *	vp,
		QPainter *	painter
	)			[virtual]

If the viewport is showing the x axis cube data or y axis cube data, and alarming is enabled, this paints alarmed values from the plot onto the viewport.

Parameters:

	vp	The viewport that might need to be alarmed/painted red
	painter	The painter to paint with

Reimplemented from Isis::PlotWindow.

References alarmingViewport(), Isis::ViewportBuffer::bufferXYRect(), Isis::ViewportBuffer::getLine(), Isis::CubeViewport::grayBuffer(), Isis::IsSpecial(), line, Isis::Null, numLines, Isis::Cube::pixelType(), Isis::Cube::read(), Isis::CubeViewport::viewportToCube(), and Isis::ViewportBuffer::working().

Referenced by Isis::ScatterPlotTool::paintViewport().

QwtPlot * Isis::PlotWindow::plot

(

)

[protected, inherited]

Get the plot encapsulated by this PlotWindow.

Returns:

The QwtPlot that this window encapsulates.

Referenced by Isis::HistogramPlotWindow::add(), Isis::PlotWindow::changePlotLabels(), colorPlot(), Isis::PlotWindow::createBestFitLine(), eventFilter(), Isis::PlotWindow::eventFilter(), Isis::HistogramPlotWindow::HistogramPlotWindow(), Isis::PlotWindow::PlotWindow(), ScatterPlotWindow(), Isis::PlotWindow::setDefaultRange(), and setMousePosition().

QColor Isis::PlotWindow::plotBackgroundColor

(

)

const [inherited]

Returns the plot's background color.

Returns:

QColor

void Isis::PlotWindow::plotChanged

(

)

[signal, inherited]

Emitted every time there is a change to the plot window.

Referenced by Isis::PlotWindow::add(), Isis::PlotWindow::dropEvent(), Isis::PlotWindow::PlotWindow(), and Isis::PlotWindow::replot().

QList< const CubePlotCurve * > Isis::PlotWindow::plotCurves

(

)

const [inherited]

Get a comprehensive const list of the plot curves inside of this plot window, excluding plot curves that are in the process of being removed.

Returns:

The const plot curves contained inside of this plot window

QList< CubePlotCurve * > Isis::PlotWindow::plotCurves

(

)

[inherited]

Get a comprehensive list of the plot curves inside of this plot window, excluding plot curves that are in the process of being removed.

Returns:

The plot curves contained inside of this plot window

References Isis::PlotCurve::color().

Referenced by Isis::PlotWindow::fillTable(), Isis::PlotWindow::paint(), Isis::PlotWindow::showTable(), and Isis::PlotWindow::~PlotWindow().

QList< const QwtPlotSpectrogram * > Isis::PlotWindow::plotSpectrograms

(

)

const [inherited]

Get a comprehensive const list of the scatter plots (spectrograms) inside of this plot window.

Returns:

The const spectrograms (scatter plots) contained inside of this plot window

QList< QwtPlotSpectrogram * > Isis::PlotWindow::plotSpectrograms

(

)

[inherited]

Get a comprehensive list of the scatter plots (spectrograms) inside of this plot window.

Returns:

The spectrograms (scatter plots) contained inside of this plot window

QString Isis::PlotWindow::plotTitle

(

)

const [inherited]

Returns the plot title.

Returns:

QwtText

void Isis::PlotWindow::printPlot

(

)

[slot, inherited]

Provides printing support of the plot image.

References size.

void Isis::MainWindow::readSettings

(

QSize

defaultSize = QSize()

)

[protected, virtual, inherited]

This method ensure that the settings get written even if the Main window was only hidden, not closed.

Parameters:

event

This method is called from the constructor so that when the Main window is created, it know's it's size and location.

References Isis::MainWindow::settingsFileName().

Referenced by Isis::PlotWindow::PlotWindow(), Isis::TableMainWindow::TableMainWindow(), and Isis::ViewportMainWindow::ViewportMainWindow().

void Isis::PlotWindow::replot

(

)

[inherited]

Reset the scale of the plot, replot it and emit plot changed.

References Isis::PlotWindow::plotChanged(), and Isis::PlotWindow::resetScale().

Referenced by Isis::PlotWindow::add(), Isis::PlotWindow::clearPlotCurves(), colorPlot(), Isis::SpectralPlotTool::refreshPlot(), Isis::SpatialPlotTool::refreshPlot(), Isis::HistogramTool::refreshPlot(), ScatterPlotWindow(), Isis::SpectralPlotWindow::setBandMarkersVisible(), Isis::PlotWindow::setUserValues(), and showHideContour().

void Isis::PlotWindow::requestFillTable

(

)

[signal, inherited]

Referenced by Isis::PlotWindow::PlotWindow(), and Isis::PlotWindow::scheduleFillTable().

void Isis::PlotWindow::resetScale

(

)

[slot, inherited]

Sets plot scale back to the defaults.

References Isis::PlotCurve::Band.

Referenced by Isis::PlotWindow::add(), and Isis::PlotWindow::replot().

void Isis::PlotWindow::savePlot

(

)

[slot, inherited]

This method allows the user to save the plot as a png, jpg, or tif image file.

void Isis::PlotWindow::scheduleFillTable

(

)

[slot, inherited]

Fills in the table with the data from the current curves in the plotWindow once all current actions/activations are done.

This is provided for performance reasons - re-plotting 4 curves only requires one fillTable at the end, instead of after each curve change.

References Isis::PlotWindow::requestFillTable().

Referenced by Isis::PlotWindow::PlotWindow().

void Isis::ScatterPlotWindow::setAlarmingPlot

(

bool

alarming

)

This enables or disables alarming viewport->plot.

Parameters:

alarming

True to enable alarming viewport->plot, false to disable alarming viewport->plot

void Isis::ScatterPlotWindow::setAlarmingViewport

(

bool

alarming

)

This enables or disables alarming plot->viewport.

Parameters:

alarming

True to enable alarming plot->viewport, false to disable alarming plot->viewport

void Isis::ScatterPlotWindow::setAlarmPlotBoxSize	(	int	samples,
		int	lines
	)

This sets the box size for alarming viewport->plot in cube samples/lines.

Parameters:

	samples	How many samples (total) the alarming box size should be. This should be odd because the mouse is in the center.
	lines	How many lines (total) the alarming box size should be. This should be odd because the mouse is in the center.

void Isis::ScatterPlotWindow::setAlarmViewportDnBoxSize	(	double	xDnBoxSize,
		double	yDnBoxSize
	)

This sets the cube DN box size for alarming plot->viewport.

If the current alarming units for plot->viewport isn't cube pixels, these values will still be stored off and just not be active until the units are changed.

Parameters:

	xDnBoxSize	The Cube DN box size (total) around the mouse in the X direction to be used for alarming.
	yDnBoxSize	The Cube DN box size (total) around the mouse in the Y direction to be used for alarming.

void Isis::ScatterPlotWindow::setAlarmViewportScreenBoxSize	(	int	width,
		int	height
	)

This sets the screen pixel box size for alarming plot->viewport.

If the current alarming units for plot->viewport isn't screen pixels, these values will still be stored off and just not be active until the units are changed.

Parameters:

	width	The screen pixels (total) around the mouse in the X direction to be used for alarming.
	height	The screen pixels (total) around the mouse in the Y direction to be used for alarming.

void Isis::ScatterPlotWindow::setAlarmViewportUnits

(

AlarmRangeUnits

units

)

This sets the units to be used for alarming plot->viewport.

Parameters:

units

The units (screen or cube DN range) to use for alarming.

void Isis::PlotWindow::setAxisLabel	(	int	axisId,
		QString	title
	)			[inherited]

Sets the plots given axis title to the given string.

Parameters:

	axisId
	title

void Isis::PlotWindow::setDefaultRange

(

)

[slot, inherited]

Resets the x/y min/max to the defaults.

References Isis::PlotWindow::plot(), and Isis::PlotWindow::setUserValues().

void Isis::PlotWindow::setLabels

(

)

[slot, inherited]

Makes the user specified changes to the plot labels.

Referenced by Isis::PlotWindow::changePlotLabels().

void Isis::PlotWindow::setMenus	(	QList< QMenu * >	menu,
		QList< QAction * >	actions
	)			[protected, inherited]

Sets up the menus added from a parent object.

Parameters:

	menu
	actions

void Isis::ScatterPlotWindow::setMousePosition	(	MdiCubeViewport *	vp,
		QPoint	mouseLoc
	)

Saves the current mouse position in the viewport so that the plot can be alarmed around that position.

Parameters:

	vp	The viewport that received the mouse event
	mouseLoc	The location on the viewport wheere the mouse is, in screen coordinates.

References Isis::ScatterPlotData::alarm(), alarmingPlot(), ASSERT, Isis::ScatterPlotData::clearAlarms(), Isis::IsSpecial(), Isis::Null, Isis::Cube::pixelType(), Isis::PlotWindow::plot(), Isis::Cube::read(), Isis::CubeViewport::viewportToCube(), x, and y.

Referenced by Isis::ScatterPlotTool::mouseLeave(), and Isis::ScatterPlotTool::mouseMove().

void Isis::PlotWindow::setPlotBackground

(

QColor

c

)

[inherited]

Sets the plot background color to the given color.

Parameters:

c

Referenced by Isis::HistogramPlotWindow::HistogramPlotWindow(), and Isis::PlotWindow::PlotWindow().

void Isis::PlotWindow::setPlotTitle

(

QString

pt

)

[inherited]

Sets the plot title to the given string.

This does not update the window title.

Parameters:

pt

The plot title to use

Referenced by Isis::PlotWindow::PlotWindow().

QString Isis::MainWindow::settingsFileName

(

)

const [protected, inherited]

References _FILEINFO_, and Isis::IException::Programmer.

Referenced by Isis::TableMainWindow::readItemSettings(), Isis::MainWindow::readSettings(), Isis::BlinkTool::readSettings(), Isis::TableMainWindow::writeSettings(), and Isis::BlinkTool::writeSettings().

QString Isis::MainWindow::settingsFileName

(

QString

objectTitle

)

[static, inherited]

References _FILEINFO_, and Isis::IException::Programmer.

void Isis::PlotWindow::setUserCanAddCurves

(

bool

userHasControl

)

[inherited]

Allow or disallow users from manually putting curves into this plot window through either copy-and-paste or drag-and-drop.

Parameters:

userHasControl

True if users can add curves manually, false otherwise

void Isis::PlotWindow::setUserValues

(

)

[slot, inherited]

This method sets the scale for the axis according to the user specified numbers.

References Isis::PlotWindow::replot().

Referenced by Isis::PlotWindow::setDefaultRange().

void Isis::PlotWindow::showHelp

(

)

[slot, inherited]

This method creates and shows the help dialog box for the plot window.

this is called from the Help-->Basic Help menu.

References d.

void Isis::PlotWindow::showHideAllCurves

(

)

[slot, inherited]

This method shows or hides all of the curves in the plotWindow.

void Isis::PlotWindow::showHideAllMarkers

(

)

[slot, inherited]

Shows/Hides all the markers(symbols).

void Isis::ScatterPlotWindow::showHideContour

(

)

[protected, slot]

This method hides or displays the contour lines on the spectrogram.

References Isis::PlotWindow::replot().

Referenced by ScatterPlotWindow().

void Isis::PlotWindow::showHideGrid

(

)

[slot, inherited]

This method hides/shows the grid on the plotWindow and changes the text for the action.

void Isis::PlotWindow::showTable

(

)

[slot, inherited]

This method is called from the showTable action on the tool bar There are some checks done to make sure there are data to fill the table.

References Isis::PlotWindow::fillTable(), Isis::PlotWindow::plotCurves(), Isis::TableMainWindow::setTrackListItems(), size, and Isis::TableMainWindow::syncColumns().

void Isis::PlotWindow::showWindow

(

)

[inherited]

Shows the plot window, and raises it to the front of any overlapping sibling widgets.

Referenced by Isis::AbstractPlotTool::showPlotWindow().

void Isis::PlotWindow::switchBackground

(

)

[slot, inherited]

This method toggles the plot background color between black and white.

void Isis::PlotWindow::trackerEnabled

(

)

[slot, inherited]

Enables the plot mouse tracker.

void Isis::PlotWindow::update

(

MdiCubeViewport *

activeViewport

)

[virtual, inherited]

This is provided to allow children to react to tool updates.

This is useful for example for band markers in the spectral plots.

Parameters:

activeViewport

The currently selected viewport

Reimplemented in Isis::SpectralPlotWindow.

Referenced by Isis::AbstractPlotTool::updateTool().

bool Isis::PlotWindow::userCanAddCurves

(

)

const [inherited]

Ask if a user action can add this curve to this window in general.

This verifies that the user is allowed to add curves to this window but not that a particular curve is compatible with this window.

Returns:

True if the user should be allowed to paste/drop curves in general into this window

PlotCurve::Units Isis::PlotWindow::xAxisUnits

(

)

const [inherited]

This is the data-type of the curves' x data in this plot window.

All of the cube plot curves must have the same units for x axis data or the display will not make sense.

Returns:

X-Axis Curve Data Units

Referenced by Isis::SpectralPlotTool::refreshPlot(), and Isis::SpatialPlotTool::refreshPlot().

PlotCurve::Units Isis::PlotWindow::yAxisUnits

(

)

const [inherited]

This is the data-type of the curves' y data in this plot window.

All of the cube plot curves must have the same units for y-left axis data (y-right sometimes has different units) or the display will not make sense.

Returns:

Left Y-Axis Data Units

QwtPlotZoomer * Isis::PlotWindow::zoomer

(

)

[protected, inherited]

Get this window's plot's zoomer.

Returns:

A QwtPlotZoomer which is associated with this PlotWindow's QwtPlot

Referenced by ScatterPlotWindow().

---

The documentation for this class was generated from the following files:

• src/qisis/objs/ScatterPlotTool/ScatterPlotWindow.h
• src/qisis/objs/ScatterPlotTool/ScatterPlotWindow.cpp