This is a plot curve with information relating it to a particular cube or region of a cube. More...

#include <CubePlotCurve.h>

Inheritance diagram for Isis::CubePlotCurve:

Collaboration diagram for Isis::CubePlotCurve:

Public Types
enum	Units { Unknown, Band, CubeDN, Elevation, Percentage, PixelNumber, Meters, Kilometers, Wavelength }
	These are all the possible units for the x or y data in a plot curve. More...

Public Slots
void	updateLegendItemWidget (QWidget *legendItem)
	This creates a legend item and overrides events from it. More...

Signals
void	needsRepaint ()
	This is emitted when the curve is modified in such a way that it would paint a viewport differently. More...

void	removing ()
	This is emitted just before the cube plot curve is deleted. More...

Public Member Functions
	CubePlotCurve (Units xUnits, Units yUnits)
	This constructs a CubePlotCurve... More...

	CubePlotCurve (const QByteArray &parentAndChildData)
	Construct the plot tool curve given the past results of toByteArray(...). More...

bool	eventFilter (QObject o, QEvent e)
	This will start the drag & drop operation for these curves. More...

void	paint (CubeViewport vp, QPainter painter)
	Use information inside of the plot curve to paint onto a cube viewport. More...

QList< QList< QPointF > >	sourceVertices () const
	This method returns a list of points which are the vertices of the selected area (by the rubberband) on the cvp. More...

virtual QWidget *	legendItem () const
	This method is necessary for getting the correct (event filter altered) legend item. More...

QStringList	sourceCube () const
	This method returns the cube view port associated with the curve. More...

void	enableAutoRenaming (bool)
	This enables/disables the plot curve from changing it's title when the source data changes. More...

void	copySource (const CubePlotCurve &other)
	This copies the source data from another CubePlotCurve. More...

void	setSource (CubeViewport *cvp, QList< QPoint > screenPoints, int band=-1)
	Tell this plot curve from where its data originated. More...

void	setSource (QList< CubeViewport * > cvps, QList< QList< QPoint > > screenPoints, QList< int > band)

void	attachMarkers ()
	After attaching this curve to a plot, due to an inheritance/implementation complication with qwt the markers will remain detached until they are recreated. More...

QColor	color () const
	This method returns the color of the curve. More...

QwtSymbol *	markerSymbol () const
	This method returns the shape of the markers. More...

Units	xUnits () const
	Get the units of the x-axis double data. More...

Units	yUnits () const
	Get the units of the y-axis double data. More...

void	setColor (const QColor &color)
	Set the color of this curve and it's markers. More...

void	setData (QwtSeriesData< QPointF > *data)
	This method sets the data for the curve, then sets the value for the markers associated with the curve. More...

void	setPen (const QPen &pen)
	Sets the plot pen to the passed-in pen. More...

void	setMarkerSymbol (QwtSymbol::Style style)
	This method sets the shape of the markers. More...

void	setMarkerVisible (bool visible)
	This method sets the visibility states of the markers at each value point. More...

Protected Member Functions
QByteArray	fromByteArray (const QByteArray &classData)
	Construct the plot curve given the past results of toByteArray(...). More...

Private Member Functions
QMimeData *	createMimeData () const
	This converts the plot curve into a binary, clipboard-compatible storage format (QMimeData). More...

QByteArray	toByteArray () const
	Serialize this plot curve into a binary byte array. More...

void	mousePressEvent (QMouseEvent *e)
	Handle various events on the legend item. More...

void	clearSource ()

void	addSource (CubeViewport *cvp, QList< QPoint > screenPoints, int band=-1)

void	clearMarkers ()

void	recreateMarkers ()

Private Attributes
QPointer< QWidget >	m_legendItem
	This is the widget legend item associated with this curve. More...

QString	m_originalName
	This is the curve's name before any automatic renaming happened. More...

bool	m_renameAutomatically
	This indicates if we are allowed to modify the title of this curve when the source (origin) data changes. More...

QList< QList< QPointF > >	m_pointList
	List of vertices in sample,line coordinates from the rubber band. More...

QStringList	m_sourceCube
	The cube that the data is coming from. More...

QColor	m_color

QwtSymbol *	m_markerSymbol
	Marker's styles. More...

QList< QwtPlotMarker * >	m_valuePointMarkers

Units	m_xUnits

Units	m_yUnits

Detailed Description

This is a plot curve with information relating it to a particular cube or region of a cube.

This class was created specifically for use with the qview plot tools (AbstractPlotTool). This was formerly known as PlotToolCurve. With this class the programmer can set the cube view port that the curve is associated with along with the vertices on the viewport of which the curve gets it data. With this information, the plot curve can rename itself and paint its origin points onto cube viewports.

Author: ????-??-?? Stacy Alley

History:: 2012-01-18 Steven Lambright and Tracie Sucharski - Renamed class to CubePlotCurve. Changed functionality dramatically to support a new plotting infrastructure.

History:: 2012-01-20 Steven Lambright and Jai Rideout - Completed documentation.

History:: 2012-01-30 Steven Lambright - Fixed a bug added when the legendItem() method was removed. This method is necessary. Fixes #688.

History:: 2012-03-14 Tracie Sucharski - Added functionality for multiple viewports as a source for plots.

History:: 2014-07-02 Ian Humphrey - Added comment for executing configure dialog. References #2089.

Definition at line 53 of file CubePlotCurve.h.

Member Enumeration Documentation

◆ Units

enum Isis::PlotCurve::Units

inherited

These are all the possible units for the x or y data in a plot curve.

We want these in order to have type checking when moving curves around - it's theoretically possible to even utilize the right y axis automatically when you put mismatched plot curve y data into the same plot. All of this and more requires knowing your data's units.

Enumerator
Unknown	The data units are not yet known. Please avoid using this if at all possible.
Band	The data is a band number.
CubeDN	The data is a Cube DN value.
Elevation	The data is an elevation (in meters).
Percentage	The data is a percentage (0-100).
PixelNumber	The data is a pixel #. For example, it's the nth pixel along a line.
Meters	The data is in meters. For example, it's the nth meter along a line.
Kilometers	The data is in kilometers. For example, it's the nth kilometer along a line.
Wavelength	The data is a wavelength. This is usually associated with a band and comes from the band bin group.

Definition at line 54 of file PlotCurve.h.

Constructor & Destructor Documentation

◆ CubePlotCurve() [1/2]

Isis::CubePlotCurve::CubePlotCurve	(	Units	xUnits,
		Units	yUnits
	)

This constructs a CubePlotCurve...

a subclass of PlotCurve. This class was created specifically for use with the plot tools. With this class the programmer can set the cube view port that the curve is associated with along with the vertices on the cvp of which the curve gets it data.

Parameters

xUnits	The units that the x-axis data is in
yUnits	The units that the x-axis data is in

Definition at line 50 of file CubePlotCurve.cpp.

References m_legendItem, and m_renameAutomatically.

◆ CubePlotCurve() [2/2]

Isis::CubePlotCurve::CubePlotCurve ( const QByteArray & parentAndChildData )

Construct the plot tool curve given the past results of toByteArray(...).

This is used for copy/paste and drag/drop.

Parameters

parentAndChildData A serialized, binary representation of an instance of this class.

Definition at line 64 of file CubePlotCurve.cpp.

References Isis::PlotCurve::fromByteArray(), m_legendItem, m_pointList, m_sourceCube, and Isis::IException::Programmer.

Member Function Documentation

◆ attachMarkers()

void Isis::PlotCurve::attachMarkers ( )

inherited

After attaching this curve to a plot, due to an inheritance/implementation complication with qwt the markers will remain detached until they are recreated.

This forces the markers to be updated immediately.

Please always call this method after attaching this curve to a plot.

Definition at line 46 of file PlotCurve.cpp.

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

◆ color()

QColor Isis::PlotCurve::color ( ) const

inherited

This method returns the color of the curve.

Returns: QColor

Definition at line 56 of file PlotCurve.cpp.

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine(), paint(), Isis::PlotWindow::plotCurves(), and Isis::PlotCurve::setColor().

◆ copySource()

void Isis::CubePlotCurve::copySource ( const CubePlotCurve & other )

This copies the source data from another CubePlotCurve.

This curve will now act as if it has the same exact source data as the other curve.

Parameters

other The curve with the source (origination) data to copy.

Definition at line 258 of file CubePlotCurve.cpp.

References m_pointList, m_sourceCube, and needsRepaint().

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine().

◆ createMimeData()

QMimeData * Isis::CubePlotCurve::createMimeData ( ) const

private

This converts the plot curve into a binary, clipboard-compatible storage format (QMimeData).

The format is 'application/isis3-plot-curve'.

Returns: A mime-data representation of this class. Ownership of the return value is passed to the caller.

Definition at line 364 of file CubePlotCurve.cpp.

References toByteArray().

Referenced by mousePressEvent().

◆ enableAutoRenaming()

void Isis::CubePlotCurve::enableAutoRenaming ( bool allowed )

This enables/disables the plot curve from changing it's title when the source data changes.

This is enabled by default and typically disabled when a user manually renames a curve.

Parameters

allowed True for automatic renaming, false to preserve curve title

Definition at line 247 of file CubePlotCurve.cpp.

References m_renameAutomatically.

◆ eventFilter()

bool Isis::CubePlotCurve::eventFilter	(	QObject *	o,
		QEvent *	e
	)

This will start the drag & drop operation for these curves.

Parameters

o	The object that the event relates to. This is usually the legend item, but some children install their own event filters for other objects.
e	The event that occurred on the given object.

Returns: True if we don't want any more processing of the event

Definition at line 139 of file CubePlotCurve.cpp.

References mousePressEvent().

◆ fromByteArray()

QByteArray Isis::PlotCurve::fromByteArray ( const QByteArray & classData )

protectedinherited

Construct the plot curve given the past results of toByteArray(...).

This is used for copy/paste and drag/drop.

Returns: The unconsumed part of the byte array.

Definition at line 145 of file PlotCurve.cpp.

References Isis::PlotCurve::m_markerSymbol, Isis::IException::Programmer, Isis::PlotCurve::setColor(), Isis::PlotCurve::setData(), and Isis::PlotCurve::setPen().

Referenced by CubePlotCurve().

◆ legendItem()

QWidget * Isis::CubePlotCurve::legendItem ( ) const

virtual

This method is necessary for getting the correct (event filter altered) legend item.

Without this, drag & drop and context menus do not work.

Returns: The legend item widget associated with this curve

Definition at line 224 of file CubePlotCurve.cpp.

References m_legendItem.

Referenced by updateLegendItemWidget().

◆ markerSymbol()

QwtSymbol * Isis::PlotCurve::markerSymbol ( ) const

inherited

This method returns the shape of the markers.

Returns: QwtSymbol *

Definition at line 66 of file PlotCurve.cpp.

References Isis::PlotCurve::m_markerSymbol.

◆ mousePressEvent()

void Isis::CubePlotCurve::mousePressEvent ( QMouseEvent * event )

private

Handle various events on the legend item.

This will only be called for the legend item's events and handles drag & drop, context menus and similar actions. Basically all user interaction with legend items happen here.

Parameters

event The event which happened on the legend item.

Definition at line 425 of file CubePlotCurve.cpp.

References createMimeData(), Isis::FileName::expanded(), m_legendItem, needsRepaint(), removing(), and Isis::PlotCurve::setColor().

Referenced by eventFilter().

◆ needsRepaint

void Isis::CubePlotCurve::needsRepaint ( )

signal

This is emitted when the curve is modified in such a way that it would paint a viewport differently.

Referenced by copySource(), and mousePressEvent().

◆ paint()

void Isis::CubePlotCurve::paint	(	CubeViewport *	vp,
		QPainter *	painter
	)

Use information inside of the plot curve to paint onto a cube viewport.

This paints the originating data points, in the color of the curve, onto the viewport. This will not paint onto unrelated cube viewports.

Parameters

vp	The viewport we're going to potentially paint onto
painter	The painter to use for painting onto the viewport

Definition at line 171 of file CubePlotCurve.cpp.

References Isis::PlotCurve::color(), Isis::CubeViewport::cube(), Isis::CubeViewport::cubeToViewport(), Isis::Cube::fileName(), m_sourceCube, and sourceVertices().

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

◆ removing

void Isis::CubePlotCurve::removing ( )

signal

This is emitted just before the cube plot curve is deleted.

This is used to queue the deletes to happen at a safe time.

Referenced by mousePressEvent().

◆ setColor()

void Isis::PlotCurve::setColor ( const QColor & color )

inherited

Set the color of this curve and it's markers.

This color will override the pen's color always.

Parameters

color The color of this curve.

Definition at line 97 of file PlotCurve.cpp.

References Isis::PlotCurve::color(), and Isis::PlotCurve::setPen().

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine(), Isis::AbstractPlotTool::createCurve(), Isis::PlotCurve::fromByteArray(), and mousePressEvent().

◆ setData()

void Isis::PlotCurve::setData ( QwtSeriesData< QPointF > * data )

inherited

This method sets the data for the curve, then sets the value for the markers associated with the curve.

Parameters

data

Definition at line 109 of file PlotCurve.cpp.

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine(), and Isis::PlotCurve::fromByteArray().

◆ setMarkerSymbol()

void Isis::PlotCurve::setMarkerSymbol ( QwtSymbol::Style style )

inherited

This method sets the shape of the markers.

Parameters

style

Definition at line 120 of file PlotCurve.cpp.

References Isis::PlotCurve::m_markerSymbol.

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine().

◆ setMarkerVisible()

void Isis::PlotCurve::setMarkerVisible ( bool visible )

inherited

This method sets the visibility states of the markers at each value point.

Parameters

visible True to show markers, false to hide

Definition at line 131 of file PlotCurve.cpp.

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

◆ setPen()

void Isis::PlotCurve::setPen ( const QPen & pen )

inherited

Sets the plot pen to the passed-in pen.

Parameters

pen

Definition at line 340 of file PlotCurve.cpp.

Referenced by Isis::PlotWindowBestFitDialog::createBestFitLine(), Isis::AbstractPlotTool::createCurve(), Isis::PlotCurve::fromByteArray(), and Isis::PlotCurve::setColor().

◆ setSource()

void Isis::CubePlotCurve::setSource	(	CubeViewport *	cvp,
		QList< QPoint >	screenPoints,
		int	band = `-1`
	)

Tell this plot curve from where its data originated.

If you set a source, you must keep it up to date. Any time the data in the curve changes, you should be calling this method again.

Parameters

cvp	The viewport from which this curve's data came from
screenPoints	The pertinent points on the viewport from which this curve's data came from.
band	The band of the cube inside of said viewport from which this curve's data came from.

Definition at line 323 of file CubePlotCurve.cpp.

◆ sourceCube()

QStringList Isis::CubePlotCurve::sourceCube ( ) const

This method returns the cube view port associated with the curve.

Returns: CubeViewport*

Definition at line 235 of file CubePlotCurve.cpp.

References m_sourceCube.

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

◆ sourceVertices()

QList< QList< QPointF > > Isis::CubePlotCurve::sourceVertices ( ) const

This method returns a list of points which are the vertices of the selected area (by the rubberband) on the cvp.

Returns: QList<QPoint>

Definition at line 213 of file CubePlotCurve.cpp.

References m_pointList.

Referenced by paint().

◆ toByteArray()

QByteArray Isis::CubePlotCurve::toByteArray ( ) const

private

Serialize this plot curve into a binary byte array.

This is useful for storing the curve on the clipboard or in a drag & drop event.

Returns: This curve represented as binary data

Definition at line 378 of file CubePlotCurve.cpp.

References m_pointList, and m_sourceCube.

Referenced by createMimeData().

◆ updateLegendItemWidget

void Isis::CubePlotCurve::updateLegendItemWidget ( QWidget * legendItem )

slot

This creates a legend item and overrides events from it.

Definition at line 345 of file CubePlotCurve.cpp.

References legendItem(), and m_legendItem.

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

◆ xUnits()

PlotCurve::Units Isis::PlotCurve::xUnits ( ) const

inherited

Get the units of the x-axis double data.

Returns: The units of the x-axis data

Definition at line 76 of file PlotCurve.cpp.

Referenced by Isis::PlotWindow::canAdd(), Isis::PlotWindowBestFitDialog::createBestFitLine(), and Isis::PlotCurve::PlotCurve().

◆ yUnits()

PlotCurve::Units Isis::PlotCurve::yUnits ( ) const

inherited

Get the units of the y-axis double data.

Returns: The units of the y-axis data

Definition at line 86 of file PlotCurve.cpp.

Referenced by Isis::PlotWindow::canAdd(), Isis::PlotWindowBestFitDialog::createBestFitLine(), and Isis::PlotCurve::PlotCurve().

Member Data Documentation

◆ m_legendItem

QPointer<QWidget> Isis::CubePlotCurve::m_legendItem

private

This is the widget legend item associated with this curve.

Definition at line 99 of file CubePlotCurve.h.

Referenced by CubePlotCurve(), legendItem(), mousePressEvent(), and updateLegendItemWidget().

◆ m_markerSymbol

QwtSymbol* Isis::PlotCurve::m_markerSymbol

privateinherited

Marker's styles.

Definition at line 124 of file PlotCurve.h.

Referenced by Isis::PlotCurve::fromByteArray(), Isis::PlotCurve::markerSymbol(), Isis::PlotCurve::PlotCurve(), and Isis::PlotCurve::setMarkerSymbol().

◆ m_originalName

QString Isis::CubePlotCurve::m_originalName

private

This is the curve's name before any automatic renaming happened.

Definition at line 102 of file CubePlotCurve.h.

◆ m_pointList

QList<QList <QPointF> > Isis::CubePlotCurve::m_pointList

private

List of vertices in sample,line coordinates from the rubber band.

Definition at line 111 of file CubePlotCurve.h.

Referenced by copySource(), CubePlotCurve(), sourceVertices(), and toByteArray().

◆ m_renameAutomatically

bool Isis::CubePlotCurve::m_renameAutomatically

private

This indicates if we are allowed to modify the title of this curve when the source (origin) data changes.

Definition at line 108 of file CubePlotCurve.h.

Referenced by CubePlotCurve(), and enableAutoRenaming().

◆ m_sourceCube

QStringList Isis::CubePlotCurve::m_sourceCube

private

The cube that the data is coming from.

Definition at line 114 of file CubePlotCurve.h.

Referenced by copySource(), CubePlotCurve(), paint(), sourceCube(), and toByteArray().

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

src/qisis/objs/CubePlotCurve/CubePlotCurve.h
src/qisis/objs/CubePlotCurve/CubePlotCurve.cpp

Public Types

Public Slots

Signals

Public Member Functions

Protected Member Functions

Private Member Functions

Private Attributes

Detailed Description

Member Enumeration Documentation

◆ Units

Constructor & Destructor Documentation

◆ CubePlotCurve() [1/2]

◆ CubePlotCurve() [2/2]

Member Function Documentation

◆ attachMarkers()

◆ color()

◆ copySource()

◆ createMimeData()

◆ enableAutoRenaming()

◆ eventFilter()

◆ fromByteArray()

◆ legendItem()

◆ markerSymbol()

◆ mousePressEvent()

◆ needsRepaint

◆ paint()

◆ removing

◆ setColor()

◆ setData()

◆ setMarkerSymbol()

◆ setMarkerVisible()

◆ setPen()

◆ setSource()

◆ sourceCube()

◆ sourceVertices()

◆ toByteArray()

◆ updateLegendItemWidget

◆ xUnits()

◆ yUnits()

Member Data Documentation

◆ m_legendItem

◆ m_markerSymbol

◆ m_originalName

◆ m_pointList

◆ m_renameAutomatically

◆ m_sourceCube