JKQTPXYScatterGraph Class Reference

This implements xy scatter plots. This also alows to draw symbols at the data points. More...

#include <jkqtpscatter.h>

Inheritance diagram for JKQTPXYScatterGraph:

Collaboration diagram for JKQTPXYScatterGraph:

Public Member Functions
	JKQTPXYScatterGraph (JKQTBasePlotter *parent=nullptr)
	class constructor
	JKQTPXYScatterGraph (JKQTPlotter *parent)
	class constructor
virtual void	draw (JKQTPEnhancedPainter &painter) override
	plots the graph to the plotter object specified as parent
virtual void	drawKeyMarker (JKQTPEnhancedPainter &painter, const QRectF &rect) override
	plots a key marker inside the specified rectangle rect
virtual QColor	getKeyLabelColor () const override
	returns the color to be used for the key label
void	setColor (QColor c)
	set color of line and symbol
Public Member Functions inherited from JKQTPXYGraph
	JKQTPXYGraph (JKQTBasePlotter *parent=nullptr)
	class constructor
DataSortOrder	getDataSortOrder () const
	if !=Unsorted, the data is sorted before plotting
virtual int	getKeyColumn () const
	returns the column used as "key" for the current graph (typically this call getXColumn(), but for horizontal graphs like filled curves or barcharts it may call getYColumn() )
virtual int	getValueColumn () const
	returns the column used as "value" for the current graph (typically this call getXColumn(), but for horizontal graphs like filled curves or barcharts it may call getYColumn() )
int	getXColumn () const
	the column that contains the x-component of the datapoints
virtual bool	getXMinMax (double &minx, double &maxx, double &smallestGreaterZero) override
	get the maximum and minimum x-value of the graph
int	getYColumn () const
	the column that contains the y-component of the datapoints
virtual bool	getYMinMax (double &miny, double &maxy, double &smallestGreaterZero) override
	get the maximum and minimum y-value of the graph
virtual double	hitTest (const QPointF &posSystem, QPointF *closestSpotSystem=nullptr, QString *label=nullptr, HitTestMode mode=HitTestXY) const override
	Implmentation of JKQTPPlotElement::hitTest(), which searches through all graph points defined by xColumn and yColumn and returns a general x/y-label, also taking into account possibly known errors to the graphs (if it is derived from JKQTPXGraphErrorData and/or JKQTPYGraphErrorData.
virtual bool	usesColumn (int column) const override
	returns true if the given column is used by the graph
Public Member Functions inherited from JKQTPGraph
	JKQTPGraph (JKQTBasePlotter *parent=nullptr)
	class constructor
virtual	~JKQTPGraph ()=default
	default wirtual destructor
Public Member Functions inherited from JKQTPPlotElement
	JKQTPPlotElement (JKQTBasePlotter *parent=nullptr)
	class constructor
virtual	~JKQTPPlotElement ()=default
	default wirtual destructor
QPointF	backTransform (const QPointF &x) const
	tool routine that back-transforms a QPointF according to the parent's transformation rules (pixels --> plot coordinate)
QPointF	backTransform (double x, double y) const
	tool routine that back-transforms a QPointF according to the parent's transformation rules (pixels --> plot coordinate)
double	backtransformX (double x) const
	tool routine that backtransforms an x-coordinate (pixels --> plot coordinate) for this plot element, uses the axis referenced in xAxisRef
double	backtransformY (double y) const
	tool routine that backtransforms a y-coordinate (pixels --> plot coordinate) for this plot element, uses the axis referenced in yAxisRef
virtual void	drawOutside (JKQTPEnhancedPainter &painter, QRect leftSpace, QRect rightSpace, QRect topSpace, QRect bottomSpace)
	plots outside the actual plot field of view (e.g. color bars, scale bars, ...)
QImage	generateKeyMarker (QSize size=QSize(16, 16))
	returns an image with a key marker inside
virtual void	getOutsideSize (JKQTPEnhancedPainter &painter, int &leftSpace, int &rightSpace, int &topSpace, int &bottomSpace)
	if the graph plots outside the actual plot field of view (e.g. color bars, scale bars, ...)
JKQTBasePlotter *	getParent ()
	returns the parent painter class
const JKQTBasePlotter *	getParent () const
	returns the parent painter class
QString	getTitle () const
	returns the the title of the plot
const JKQTPCoordinateAxis *	getXAxis () const
	returns the actual x-Axis-object from the parent plotter, referenced in xAxisRef
JKQTPCoordinateAxisRef	getXAxisRef () const
	indicates which coordinate axis to use for coordinate transforms in x-direction
const JKQTPCoordinateAxis *	getYAxis () const
	returns the actual y-Axis-object from the parent plotter, referenced in yAxisRef
JKQTPCoordinateAxisRef	getYAxisRef () const
	indicates which coordinate axis to use for coordinate transforms in y-direction
bool	isHighlighted () const
	returns whether the graph is shown in a highlighted style in the plot
bool	isVisible () const
	returns whether the graph is visible in the plot
void	setAxes (JKQTPCoordinateAxisRef ref)
	set the coordinate axes to use for this plot element
virtual void	setParent (JKQTBasePlotter *parent)
	sets the parent painter class
virtual void	setParent (JKQTPlotter *parent)
	sets the parent painter class
void	setXAxis (JKQTPCoordinateAxisRef ref)
	indicates which coordinate axis to use for coordinate transforms in x-direction
void	setYAxis (JKQTPCoordinateAxisRef ref)
	indicates which coordinate axis to use for coordinate transforms in y-direction
QPointF	transform (const QPointF &x) const
	tool routine that transforms a QPointF according to the parent's transformation rules (plot coordinate --> pixels)
QPolygonF	transform (const QPolygonF &x) const
	tool routine that transforms a QPolygonF according to the parent's transformation rules (plot coordinate --> pixels)
QPointF	transform (double x, double y) const
	tool routine that transforms a QPointF according to the parent's transformation rules (plot coordinate --> pixels)
QPainterPath	transformToLinePath (const QPolygonF &x) const
	tool routine that transforms a QPolygonF according to the parent's transformation rules and returns a (non-closed) path consisting of lines (plot coordinate --> pixels)
QVector< double >	transformX (const QVector< double > &x) const
	transform all x-coordinates in a vector x
double	transformX (double x) const
	tool routine that transforms an x-coordinate (plot coordinate --> pixels) for this plot element, uses the axis referenced in xAxisRef
QVector< double >	transformY (const QVector< double > &x) const
	transform all y-coordinates in a vector x
double	transformY (double y) const
	tool routine that transforms a y-coordinate (plot coordinate --> pixels) for this plot element, uses the axis referenced in yAxisRef
Public Member Functions inherited from JKQTPGraphSymbolStyleMixin
	JKQTPGraphSymbolStyleMixin ()
	class constructor
virtual	~JKQTPGraphSymbolStyleMixin ()
QColor	getSymbolColor () const
	set the color of the graph symbols
QColor	getSymbolFillColor () const
	set the color of filling of the graph symbols
QString	getSymbolFontName () const
	get the font to be used for character symbols JKQTPCharacterSymbol+QChar('').unicode()
double	getSymbolLineWidth () const
	get the line width of the graph symbol outline (in pt)
double	getSymbolSize () const
	get the size (=diameter in pt) of the graph symbol (in pt)
JKQTPGraphSymbols	getSymbolType () const
	get the type of the graph symbol
void	initSymbolStyle (JKQTBasePlotter *parent, int &parentPlotStyle, JKQTPPlotStyleType styletype=JKQTPPlotStyleType::Default)
	initiaize the symbol style (from the parent plotter)
void	setSymbolAlpha (double alpha)
	set alpha-value of symbol outline and filling
void	setSymbolColor (const QColor &__value)
	set the color of the graph symbols
void	setSymbolColor (const QColor &__value, double alpha)
	set the color of the graph symbols
void	setSymbolFillColor (const QColor &__value)
	set the color of filling of the graph symbols
void	setSymbolFillColor (const QColor &__value, double alpha)
	set the color of filling of the graph symbols
void	setSymbolFontName (const QString &__value)
	set the font to be used for character symbols JKQTPCharacterSymbol+QChar('').unicode()
void	setSymbolLineWidth (double __value)
	set the line width of the graph symbol outline (in pt)
void	setSymbolSize (double __value)
	set the size (=diameter in pt) of the graph symbol (in pt)
void	setSymbolType (JKQTPGraphSymbols __value)
	set the type of the graph symbol

Additional Inherited Members
Public Types inherited from JKQTPXYGraph
enum	DataSortOrder {   Unsorted =0 ,   SortedX =1 ,   SortedY =2 }
	specifies how to sort the data in a JKQTPXYGraph before drawing More...
Public Types inherited from JKQTPPlotElement
enum	HitTestMode {   HitTestXY ,   HitTestXOnly ,   HitTestYOnly }
	modes of operation for the function hitTest() More...
Public Slots inherited from JKQTPXYGraph
void	setDataSortOrder (DataSortOrder __value)
	if !=Unsorted, the data is sorted before plotting
void	setDataSortOrder (int __value)
	if !=Unsorted, the data is sorted before plotting
virtual void	setKeyColumn (int __value)
	sets the column used as "key" for the current graph (typically this call setXColumn(), but for horizontal graphs like filled curves or barcharts it may call setYColumn() )
virtual void	setValueColumn (int __value)
	sets the column used as "value" for the current graph (typically this call setXColumn(), but for horizontal graphs like filled curves or barcharts it may call setYColumn() )
void	setXColumn (int __value)
	the column that contains the x-component of the datapoints
void	setXColumn (size_t __value)
	the column that contains the x-component of the datapoints
void	setXYColumns (int xCol, int yCol)
	sets xColumn and yColumn at the same time
void	setXYColumns (QPair< int, int > xyColPair)
	sets xColumn and yColumn at the same time
void	setXYColumns (QPair< size_t, size_t > xyColPair)
	sets xColumn and yColumn at the same time
void	setXYColumns (size_t xCol, size_t yCol)
	sets xColumn and yColumn at the same time
void	setYColumn (int __value)
	the column that contains the y-component of the datapoints
void	setYColumn (size_t __value)
	the column that contains the y-component of the datapoints
Public Slots inherited from JKQTPPlotElement
void	setHighlighted (bool __value)
	sets whether the graph is drawn in a highlighted style in the plot
virtual void	setTitle (const QString &__value)
	sets the title of the plot (for display in key!).
void	setVisible (bool __value)
	sets whether the graph is visible in the plot
Protected Member Functions inherited from JKQTPXYGraph
int	getDataIndex (int i) const
	returns the index of the i-th datapoint (where i is an index into the SORTED datapoints)
virtual bool	getIndexRange (int &imin, int &imax) const
	determines the range of row indexes available in the data columns of this graph
virtual void	intSortData ()
	sorts data according to the specified criterion in sortData ... The result is stored as a index-map in sorted Indices
Protected Member Functions inherited from JKQTPGraph
virtual void	drawErrorsAfter (JKQTPEnhancedPainter &)
	this function is used to plot error inidcators after plotting the graphs.
virtual void	drawErrorsBefore (JKQTPEnhancedPainter &)
	this function is used to plot error inidcators before plotting the graphs.
bool	getDataMinMax (int column, double &minx, double &maxx, double &smallestGreaterZero)
	get the maximum and minimum value of the given column
Protected Member Functions inherited from JKQTPPlotElement
void	addHitTestData (const HitTestLocation &loc)
	clear the internal datastore for hitTest()
void	addHitTestData (const QPointF &pos_, const QString &label_)
	clear the internal datastore for hitTest()
void	addHitTestData (const QPointF &pos_, int index_, const QString &label_)
	clear the internal datastore for hitTest()
void	addHitTestData (const QPointF &pos_, int index_=-1, const JKQTPDatastore *datastore=nullptr)
	clear the internal datastore for hitTest(), this variant uses formatHitTestDefaultLabel() to auto-generate the label
void	addHitTestData (double x_, double y_, const QString &label_)
	add a new point on the graph to the internal datastore for hitTest()
void	addHitTestData (double x_, double y_, int index_, const QString &label_)
	clear the internal datastore for hitTest()
void	addHitTestData (double x_, double y_, int index_=-1, const JKQTPDatastore *datastore=nullptr)
	add a new point on the graph to the internal datastore for hitTest(), this variant uses formatHitTestDefaultLabel() to auto-generate the label
void	clearHitTestData ()
	clear the internal datastore for hitTest()
virtual QString	formatHitTestDefaultLabel (double x, double y, int index=-1, const JKQTPDatastore *datastore=nullptr) const
	tool-function for hitTest(), which formats a default label, taking into account the x- and y-position (both provided) and optionally the errors of these positions.
void	reserveHitTestData (int points)
	reserve list entries for up to points graph points in the internal datastore for hitTest()
QString	xFloatToString (double v, int past_comma=-1) const
	converts a x-value v into a string, taking into account the type of x-axis
QString	yFloatToString (double v, int past_comma=-1) const
	converts a x-value v into a string, taking into account the type of x-axis
Protected Member Functions inherited from JKQTPGraphSymbolStyleMixin
double	getKeySymbolLineWidthPx (JKQTPEnhancedPainter &painter, const QRectF &keyRect, const JKQTBasePlotter *parent, double maxSymbolSizeFracton=0.9) const
	returns the symbol linewidth for drawing symbols in a key entry with keyRect for the symbol, using painter and parent . maxSymbolSizeFracton specifies the maximum fraction of keyRect to be used for the symbol.
double	getKeySymbolSizePx (JKQTPEnhancedPainter &painter, const QRectF &keyRect, const JKQTBasePlotter *parent, double maxSymbolSizeFracton=0.9) const
	returns the symbol size for drawing symbols in a key entry with keyRect for the symbol, using painter and parent . maxSymbolSizeFracton specifies the maximum fraction of keyRect to be used for the symbol.
QBrush	getSymbolBrush (JKQTPEnhancedPainter &painter, JKQTBasePlotter *parent) const
	constructs a QPen from the line styling properties
QFont	getSymbolFont () const
	generate a QFont for darwing symbols
QPen	getSymbolPen (JKQTPEnhancedPainter &painter, JKQTBasePlotter *parent) const
	constructs a QPen from the line styling properties
void	plotStyledSymbol (JKQTBasePlotter *parent, JKQTPEnhancedPainter &painter, double x, double y) const
	plot a symbol at location x,y (in painter coordinates), using the current style
void	plotStyledSymbol (JKQTBasePlotter *parent, JKQTPEnhancedPainter &painter, double x, double y, double symbolSize) const
	plot a symbol at location x,y (in painter coordinates), using the current style
void	plotStyledSymbol (JKQTBasePlotter *parent, JKQTPEnhancedPainter &painter, double x, double y, JKQTPGraphSymbols type) const
	plot a symbol at location x,y (in painter coordinates), using the current style
void	plotStyledSymbol (JKQTBasePlotter *parent, JKQTPEnhancedPainter &painter, double x, double y, QColor color, QColor fillColor) const
	plot a symbol at location x,y (in painter coordinates), using the current style
Protected Attributes inherited from JKQTPXYGraph
QVector< int >	sortedIndices
	this array contains the order of indices, in which to access the data in the data columns
Protected Attributes inherited from JKQTPPlotElement
QVector< HitTestLocation >	m_hitTestData
	dataset with graph-points and associated data from the function hitTest()
JKQTBasePlotter *	parent
	the plotter object this object belongs to
int	parentPlotStyle
	internal storage for the used parent plot style
Properties inherited from JKQTPXYGraph
DataSortOrder	sortData
	if !=Unsorted, the data is sorted before plotting
int	xColumn
	the column that contains the x-component of the datapoints
int	yColumn
	the column that contains the y-component of the datapoints
Properties inherited from JKQTPPlotElement
bool	highlighted
	indicates whether the graph is shown in a "highlghted" in the plot
QString	title
	title of the plot (for display in key!). If no title is supplied, no key entry is drawn.
bool	visible
	indicates whether the graph is visible in the plot
JKQTPCoordinateAxisRef	xAxisRef
	indicates which coordinate axis to use for coordinate transforms in x-direction
JKQTPCoordinateAxisRef	yAxisRef
	indicates which coordinate axis to use for coordinate transforms in y-direction
Properties inherited from JKQTPGraphSymbolStyleMixin
QColor	symbolColor
QColor	symbolFillColor
QString	symbolFontName
double	symbolLineWidth
double	symbolSize
JKQTPGraphSymbols	symbolType

Detailed Description

This implements xy scatter plots. This also alows to draw symbols at the data points.

Note

This classes can (and does by default) apply a line-compression strategy that improves plotting speed but reduces accuracy a bit. See JKQTPGraphLinesCompressionMixin for details.

See also

JKQTPXYScatterErrorGraph for a version with error indicators and JKQTPXYParametrizedScatterGraph for a more feature-rich version that allows to also change the color/size of the symbols from data

Constructor & Destructor Documentation

JKQTPXYScatterGraph() [1/2]

JKQTPXYScatterGraph::JKQTPXYScatterGraph ( JKQTBasePlotter *  parent = nullptr )

explicit

class constructor

JKQTPXYScatterGraph() [2/2]

JKQTPXYScatterGraph::JKQTPXYScatterGraph

(

JKQTPlotter *

parent

)

class constructor

Member Function Documentation

draw()

virtual void JKQTPXYScatterGraph::draw ( JKQTPEnhancedPainter &  painter )

overridevirtual

plots the graph to the plotter object specified as parent

Implements JKQTPPlotElement.

drawKeyMarker()

virtual void JKQTPXYScatterGraph::drawKeyMarker ( JKQTPEnhancedPainter &  painter, const QRectF &  rect  )

overridevirtual

plots a key marker inside the specified rectangle rect

Implements JKQTPPlotElement.

getKeyLabelColor()

virtual QColor JKQTPXYScatterGraph::getKeyLabelColor ( ) const

overridevirtual

returns the color to be used for the key label

Implements JKQTPPlotElement.

setColor()

void JKQTPXYScatterGraph::setColor

(

QColor

c

)

set color of line and symbol

---

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

• jkqtpscatter.h