#include <basetraceplotwidget.h>

Inheritance diagram for pappso::BaseTracePlotWidget:

Public Member Functions
	BaseTracePlotWidget (QWidget *parent=0)

	BaseTracePlotWidget (QWidget *parent, const QString &x_axis_label, const QString &y_axis_label)

virtual	~BaseTracePlotWidget ()
	Destruct `this` BaseTracePlotWidget instance. More...

virtual void	setGraphData (int graph_index, const std::vector< double > &keys, const std::vector< double > &values)

virtual void	setGraphData (QCPGraph *graph_p, const std::vector< double > &keys, const std::vector< double > &values)

virtual void	clearGraphData (int graph_index)

virtual void	axisDoubleClickHandler (QCPAxis axis, QCPAxis::SelectablePart part, QMouseEvent event) override

virtual void	axisRescale () override
	RANGE-related functions. More...

virtual void	axisReframe () override

virtual void	axisZoom () override

virtual void	axisPan () override

virtual QCPGraph *	addTrace (const pappso::Trace &trace, const QColor &color)

virtual bool	findIntegrationLowerRangeForKey (int index, double key, QCPRange &range)
	Find a minimal integration range starting at an existing data point. More...

std::vector< double >	getValuesX (int index) const

std::vector< double >	getValuesY (int index) const

QCPRange	getValueRangeOnKeyRange (QCPAbstractPlottable *plottable_p, bool &ok)

QCPRange	getValueRangeOnKeyRange (int index, bool &ok)

double	getYatX (double x, QCPGraph *graph_p)

double	getYatX (double x, int index=0)

pappso::Trace	toTrace (int index) const

pappso::Trace	toTrace (const QCPGraph *graph_p) const

pappso::Trace	toTrace (const QCPRange &x_axis_range, int index) const

pappso::Trace	toTrace (const QCPRange &x_axis_range, const QCPGraph *graph_p) const

Public Member Functions inherited from pappso::BasePlotWidget
	BasePlotWidget (QWidget *parent)

	BasePlotWidget (QWidget *parent, const QString &x_axis_label, const QString &y_axis_label)

virtual	~BasePlotWidget ()
	Destruct `this` BasePlotWidget instance. More...

virtual bool	setupWidget ()

virtual void	setPen (const QPen &pen)

virtual const QPen &	getPen () const

virtual void	setPlottingColor (QCPAbstractPlottable *plottable_p, const QColor &new_color)

virtual void	setPlottingColor (int index, const QColor &new_color)

virtual QColor	getPlottingColor (QCPAbstractPlottable *plottable_p) const

virtual QColor	getPlottingColor (int index=0) const

virtual void	setAxisLabelX (const QString &label)

virtual void	setAxisLabelY (const QString &label)

virtual void	resetAxesRangeHistory ()

virtual void	updateAxesRangeHistory ()
	Create new axis range history items and append them to the history. More...

virtual void	restorePreviousAxesRangeHistory ()
	Go up one history element in the axis history. More...

virtual void	restoreAxesRangeHistory (std::size_t index)
	Get the axis histories at index `index` and update the plot ranges. More...

virtual void	keyPressEvent (QKeyEvent *event)
	KEYBOARD-related EVENTS. More...

virtual void	keyReleaseEvent (QKeyEvent *event)
	Handle specific key codes and trigger respective actions. More...

virtual void	spaceKeyReleaseEvent (QKeyEvent *event)

virtual void	directionKeyPressEvent (QKeyEvent *event)

virtual void	directionKeyReleaseEvent (QKeyEvent *event)

virtual void	mousePseudoButtonKeyPressEvent (QKeyEvent *event)

virtual void	mousePseudoButtonKeyReleaseEvent (QKeyEvent *event)

virtual void	mousePressHandler (QMouseEvent *event)
	KEYBOARD-related EVENTS. More...

virtual void	mouseReleaseHandler (QMouseEvent *event)

virtual void	mouseReleaseHandlerLeftButton ()

virtual void	mouseReleaseHandlerRightButton ()

virtual void	mouseMoveHandler (QMouseEvent *event)

virtual void	mouseMoveHandlerNotDraggingCursor ()

virtual void	mouseMoveHandlerDraggingCursor ()

virtual void	mouseMoveHandlerLeftButtonDraggingCursor ()

virtual void	mouseMoveHandlerRightButtonDraggingCursor ()

bool	isClickOntoXAxis (const QPointF &mousePoint)

bool	isClickOntoYAxis (const QPointF &mousePoint)

int	dragDirection ()
	MOUSE-related EVENTS. More...

virtual void	moveMouseCursorGraphCoordToGlobal (QPointF plot_coordinates)

virtual void	moveMouseCursorPixelCoordToGlobal (QPointF local_coordinates)

virtual void	horizontalMoveMouseCursorCountPixels (int pixel_count)

virtual QPointF	horizontalGetGraphCoordNewPointCountPixels (int pixel_count)

virtual void	verticalMoveMouseCursorCountPixels (int pixel_count)

virtual QPointF	verticalGetGraphCoordNewPointCountPixels (int pixel_count)

virtual QCPRange	getRangeX (bool &found_range, int index) const
	MOUSE MOVEMENTS mouse/keyboard-triggered. More...

virtual QCPRange	getRangeY (bool &found_range, int index) const

QCPRange	getRange (PlotAxis axis, RangeType range_type, bool &found_range) const

virtual QCPRange	getInnermostRangeX (bool &found_range) const

virtual QCPRange	getOutermostRangeX (bool &found_range) const

virtual QCPRange	getInnermostRangeY (bool &found_range) const

virtual QCPRange	getOutermostRangeY (bool &found_range) const

void	yMinMaxOnXAxisCurrentRange (double &min, double &max, QCPAbstractPlottable *plottable_p=nullptr)

void	yMinMaxOnXAxisCurrentRange (double &min, double &max, int index)

virtual void	replotWithAxesRanges (QCPRange xAxisRange, QCPRange yAxisRange, PlotAxis whichAxis)

virtual void	replotWithAxisRangeX (double lower, double upper)

virtual void	replotWithAxisRangeY (double lower, double upper)

virtual void	hideAllPlotItems ()
	PLOTTING / REPLOTTING functions. More...

virtual void	showTracers ()
	Show the traces (vertical and horizontal). More...

virtual void	hideTracers ()
	Hide the traces (vertical and horizontal). More...

virtual void	drawRectangleAndPrepareZoom ()

virtual void	prepareXDeltaLineAndMeasure ()

virtual void	drawXDeltaLineAndMeasure ()

virtual void	drawXDeltaLineForIntegration ()

virtual void	calculateDragDeltas ()

virtual void	calculateDragDeltasAndUnSortedRegionCorners ()

virtual bool	isProperSelectionRectangle ()

virtual void	setFocus ()
	PLOT ITEMS : TRACER TEXT ITEMS... More...

virtual void	redrawPlotBackground (QWidget *focusedPlotWidget)
	Redraw the background of the `focusedPlotWidget` plot widget. More...

virtual void	updateContextRanges ()

virtual const BasePlotContext &	getContext () const

Additional Inherited Members
Signals inherited from pappso::BasePlotWidget
void	setFocusSignal ()

void	lastCursorHoveredPointSignal (const QPointF &pointf)

void	plotRangesChangedSignal (const BasePlotContext &context)

void	xAxisMeasurementSignal (const BasePlotContext &context, bool with_delta)

void	keyPressEventSignal (const BasePlotContext &context)

void	keyReleaseEventSignal (const BasePlotContext &context)

void	mouseReleaseEventSignal (const BasePlotContext &context)

void	plottableSelectionChangedSignal (QCPAbstractPlottable *plottable_p, bool selected)

void	integrationRequestedSignal (const BasePlotContext &context)

void	plottableDestructionRequestedSignal (BasePlotWidget base_plot_widget_p, QCPAbstractPlottable plottable_p, const BasePlotContext &context)

Protected Attributes inherited from pappso::BasePlotWidget
QString	m_name = "NOT_SET"
	Name of the plot widget. More...

QString	m_desc = "NOT_SET"
	Description of the plot widget. More...

QString	m_fileName
	The name of the data file from which the mass data were read. More...

QString	m_axisLabelX

QString	m_axisLabelY

BasePlotContext	m_context

int	m_leftMousePseudoButtonKey = Qt::Key_Less

int	m_rightMousePseudoButtonKey = Qt::Key_Greater

QCPItemRect *	mp_zoomRectItem = nullptr
	Rectangle defining the borders of zoomed-in/out data. More...

QCPItemLine *	mp_selectLineItem = nullptr
	Line that is printed when the user selects a range. More...

QCPItemText *	mp_xDeltaTextItem = nullptr
	Text describing the x-axis delta value during a drag operation. More...

bool	m_shouldTracersBeVisible = true
	Tells if the tracers should be visible. More...

QCPItemLine *	mp_hPosTracerItem
	Horizontal position tracer. More...

QCPItemLine *	mp_vPosTracerItem
	Vertical position tracer. More...

QCPItemLine *	mp_vStartTracerItem
	Vertical selection start tracer (typically in green). More...

QCPItemLine *	mp_vEndTracerItem
	Vertical selection end tracer (typically in red). More...

std::size_t	m_lastAxisRangeHistoryIndex = 0
	Index of the last axis range history item. More...

std::vector< QCPRange * >	m_xAxisRangeHistory
	List of x axis ranges occurring during the panning zooming actions. More...

std::vector< QCPRange * >	m_yAxisRangeHistory
	List of y axis ranges occurring during the panning zooming actions. More...

int	m_mouseMoveHandlerSkipAmount = 10
	How many mouse move events must be skipped *‍/. More...

int	m_mouseMoveHandlerSkipCount = 0
	Counter to handle the "fat data" mouse move event handling. More...

QColor	m_unfocusedColor = QColor("lightgray")
	Color used for the background of unfocused plot. More...

QBrush	m_unfocusedBrush = QBrush(m_unfocusedColor)
	Color used for the background of unfocused plot. More...

QColor	m_focusedColor = QColor(Qt::transparent)
	Color used for the background of focused plot. More...

QBrush	m_focusedBrush = QBrush(m_focusedColor)
	Color used for the background of focused plot. More...

QPen	m_pen
	Pen used to draw the graph and textual elements in the plot widget. More...

Detailed Description

Definition at line 59 of file basetraceplotwidget.h.

Constructor & Destructor Documentation

◆ BaseTracePlotWidget() [1/2]

pappso::BaseTracePlotWidget::BaseTracePlotWidget ( QWidget * parent = 0 )

explicit

Definition at line 43 of file basetraceplotwidget.cpp.

   : BasePlotWidget(parent)
 {
 }

◆ BaseTracePlotWidget() [2/2]

pappso::BaseTracePlotWidget::BaseTracePlotWidget	(	QWidget *	parent,
		const QString &	x_axis_label,
		const QString &	y_axis_label
	)

explicit

Definition at line 49 of file basetraceplotwidget.cpp.

   : BasePlotWidget(parent, x_axis_label, y_axis_label)
 {
 }

◆ ~BaseTracePlotWidget()

pappso::BaseTracePlotWidget::~BaseTracePlotWidget ( )

virtual

Destruct this BaseTracePlotWidget instance.

The destruction involves clearing the history, deleting all the axis range history items for x and y axes.

Definition at line 64 of file basetraceplotwidget.cpp.

65 {

66 }

Member Function Documentation

◆ addTrace()

QCPGraph * pappso::BaseTracePlotWidget::addTrace	(	const pappso::Trace &	trace,
		const QColor &	color
	)

virtual

Definition at line 119 of file basetraceplotwidget.cpp.

 {
   // qDebug();
  
   if(!color.isValid())
     throw PappsoException(
       QString("The color to be used for the plot graph is invalid."));
  
   // This seems to be unpleasant.
   // setFocus();
  
   QCPGraph *graph_p = addGraph();
  
   graph_p->setData(QVector<double>::fromStdVector(trace.xToVector()),
                    QVector<double>::fromStdVector(trace.yToVector()));
  
   QPen pen = graph()->pen();
   pen.setColor(color);
   graph()->setPen(pen);
  
   // Connect the signal of selection change so that we can re-emit it for the
   // widget that is using *this widget.
  
   connect(graph_p,
           static_cast<void (QCPAbstractPlottable::*)(bool)>(
             &QCPAbstractPlottable::selectionChanged),
           [this, graph_p]() {
             emit plottableSelectionChangedSignal(graph_p, graph_p->selected());
           });
  
   // Rescaling the axes is actually unpleasant if there are more than one
   // graph in the plot widget and that we are adding one. So only, rescale if
   // the number of graphs is == 1, that is we are adding the first one.
  
   if(graphCount() == 1)
     {
       rescaleAxes();
       resetAxesRangeHistory();
     }
  
   replot();
  
   return graph_p;
 }

References pappso::BasePlotWidget::plottableSelectionChangedSignal(), pappso::BasePlotWidget::resetAxesRangeHistory(), pappso::Trace::xToVector(), and pappso::Trace::yToVector().

◆ axisDoubleClickHandler()

void pappso::BaseTracePlotWidget::axisDoubleClickHandler	(	QCPAxis *	axis,
		QCPAxis::SelectablePart	part,
		QMouseEvent *	event
	)

overridevirtual

Reimplemented from pappso::BasePlotWidget.

Definition at line 413 of file basetraceplotwidget.cpp.

 {
  
   m_context.keyboardModifiers = QGuiApplication::queryKeyboardModifiers();
  
   if(m_context.keyboardModifiers & Qt::ControlModifier)
     {
  
       // If the Ctrl modifiers is active, then both axes are to be reset. Also
       // the histories are reset also.
  
       rescaleAxes();
       resetAxesRangeHistory();
     }
   else
     {
       // Only the axis passed as parameter is to be rescaled.
       // Reset the range of that axis to the max view possible, but for the y
       // axis check if the Shift keyboard key is pressed. If so the full scale
       // should be calculated only on the data in the current x range.
  
       if(axis->orientation() == Qt::Vertical)
         {
           if(m_context.keyboardModifiers & Qt::ShiftModifier)
             {
  
               // In this case, we want to make a rescale of the Y axis such
               // that it displays full scale the data in the current X axis
               // range only.
  
               bool ok = false;
  
               QCPRange value_range = getValueRangeOnKeyRange(nullptr, ok);
  
               yAxis->setRange(value_range);
             }
           else
             axis->rescale();
         }
       else
         axis->rescale();
  
       updateAxesRangeHistory();
  
       event->accept();
     }
  
   // The double-click event does not cancel the mouse press event. That is, if
   // left-double-clicking, at the end of the operation the button still
   // "pressed". We need to remove manually the button from the pressed buttons
   // context member.
  
   m_context.pressedMouseButtons ^= event->button();
  
   updateContextRanges();
  
   emit plotRangesChangedSignal(m_context);
  
   replot();
 }

References getValueRangeOnKeyRange(), pappso::BasePlotContext::keyboardModifiers, pappso::BasePlotWidget::m_context, pappso::BasePlotWidget::plotRangesChangedSignal(), pappso::BasePlotContext::pressedMouseButtons, pappso::BasePlotWidget::resetAxesRangeHistory(), pappso::BasePlotWidget::updateAxesRangeHistory(), and pappso::BasePlotWidget::updateContextRanges().

◆ axisPan()

void pappso::BaseTracePlotWidget::axisPan ( )

overridevirtual

Reimplemented from pappso::BasePlotWidget.

Definition at line 680 of file basetraceplotwidget.cpp.

 {
   if(m_context.wasClickOnXAxis)
     {
       xAxis->setRange(m_context.xRange.lower - m_context.xDelta,
                       m_context.xRange.upper - m_context.xDelta);
  
       // If the shift modifier key is pressed, then the user want the y axis
       // to be full scale.
       if(m_context.keyboardModifiers & Qt::ShiftModifier)
         {
  
           bool ok = false;
  
           QCPRange value_range = getValueRangeOnKeyRange(nullptr, ok);
  
           yAxis->setRange(value_range);
         }
       // else nothing to do we do not change the y axis scale.
     }
  
   if(m_context.wasClickOnYAxis)
     {
       yAxis->setRange(m_context.yRange.lower - m_context.yDelta,
                       m_context.yRange.upper - m_context.yDelta);
     }
  
   updateContextRanges();
  
   // We cannot store the new ranges in the history, because the pan operation
   // involved a huge quantity of micro-movements elicited upon each mouse move
   // cursor event so we would have a huge history.
   // updateAxesRangeHistory();
  
   // Now that the contex has the right range values, we can emit the
   // signal that will be used by this plot widget users, typically to
   // abide by the x/y range lock required by the user.
  
   emit plotRangesChangedSignal(m_context);
  
   replot();
 }

References getValueRangeOnKeyRange(), pappso::BasePlotContext::keyboardModifiers, pappso::BasePlotWidget::m_context, pappso::BasePlotWidget::plotRangesChangedSignal(), pappso::BasePlotWidget::updateContextRanges(), pappso::BasePlotContext::wasClickOnXAxis, pappso::BasePlotContext::wasClickOnYAxis, pappso::BasePlotContext::xDelta, pappso::BasePlotContext::xRange, pappso::BasePlotContext::yDelta, and pappso::BasePlotContext::yRange.

◆ axisReframe()

void pappso::BaseTracePlotWidget::axisReframe ( )

overridevirtual

Reimplemented from pappso::BasePlotWidget.

Definition at line 598 of file basetraceplotwidget.cpp.

 {
  
   // double sorted_start_drag_point_x =
   // std::min(m_context.startDragPoint.x(), m_context.currentDragPoint.x());
  
   // xAxis->setRange(sorted_start_drag_point_x,
   // sorted_start_drag_point_x + fabs(m_context.xDelta));
  
   xAxis->setRange(
     QCPRange(m_context.xRegionRangeStart, m_context.xRegionRangeEnd));
  
   // Note that the y axis should be rescaled from current lower value to new
   // upper value matching the y-axis position of the cursor when the mouse
   // button was released.
  
   yAxis->setRange(
     xAxis->range().lower,
     std::max<double>(m_context.yRegionRangeStart, m_context.yRegionRangeEnd));
  
   // qDebug() << "xaxis:" << xAxis->range().lower << "-" <<
   // xAxis->range().upper
   //<< "yaxis:" << yAxis->range().lower << "-" << yAxis->range().upper;
  
   // If the shift modifier key is pressed, then the user want the y axis
   // to be full scale.
   if(m_context.keyboardModifiers & Qt::ShiftModifier)
     {
  
       bool ok = false;
  
       QCPRange value_range = getValueRangeOnKeyRange(nullptr, ok);
  
       yAxis->setRange(value_range);
     }
   // else do nothing, let the y axis range as is.
  
   updateContextRanges();
  
   updateAxesRangeHistory();
   emit plotRangesChangedSignal(m_context);
  
   replot();
 }

References getValueRangeOnKeyRange(), pappso::BasePlotContext::keyboardModifiers, pappso::BasePlotWidget::m_context, pappso::BasePlotWidget::plotRangesChangedSignal(), pappso::BasePlotWidget::updateAxesRangeHistory(), pappso::BasePlotWidget::updateContextRanges(), pappso::BasePlotContext::xRegionRangeEnd, pappso::BasePlotContext::xRegionRangeStart, pappso::BasePlotContext::yRegionRangeEnd, and pappso::BasePlotContext::yRegionRangeStart.

◆ axisRescale()

void pappso::BaseTracePlotWidget::axisRescale ( )

overridevirtual

RANGE-related functions.

PLOTTING / REPLOTTING functions

Reimplemented from pappso::BasePlotWidget.

Definition at line 478 of file basetraceplotwidget.cpp.

 {
   double xLower = xAxis->range().lower;
   double xUpper = xAxis->range().upper;
  
   // Get the current y lower/upper range.
   double yLower = yAxis->range().lower;
   double yUpper = yAxis->range().upper;
  
   // This function is called only when the user has clicked on the x/y axis or
   // when the user has dragged the left mouse button with the Ctrl key
   // modifier. The m_context.wasClickOnXAxis is then simulated in the mouse
   // move handler. So we need to test which axis was clicked-on.
  
   if(m_context.wasClickOnXAxis)
     {
  
       // We are changing the range of the X axis.
  
       // What is the x delta ?
       double xDelta =
         m_context.currentDragPoint.x() - m_context.startDragPoint.x();
  
       // If xDelta is < 0, the  we were dragging from right to left, we are
       // compressing the view on the x axis, by adding new data to the right
       // hand size of the graph. So we add xDelta to the upper bound of the
       // range. Otherwise we are uncompressing the view on the x axis and
       // remove the xDelta from the upper bound of the range. This is why we
       // have the
       // '-'
       // and not '+' below;
  
       // qDebug() << "Setting xaxis:" << xLower << "--" << xUpper - xDelta;
  
       xAxis->setRange(xLower, xUpper - xDelta);
  
  
       // Old version
       // if(xDelta < 0)
       //{
       //// The dragging operation was from right to left, we are enlarging
       //// the range (thus, we are unzooming the view, since the widget
       //// always has the same size).
  
       // xAxis->setRange(xLower, xUpper + fabs(xDelta));
       //}
       // else
       //{
       //// The dragging operation was from left to right, we are reducing
       //// the range (thus, we are zooming the view, since the widget
       //// always has the same size).
  
       // xAxis->setRange(xLower, xUpper - fabs(xDelta));
       //}
  
       // We may either leave the scale of the Y axis as is (default) or
       // the user may want an automatic scale of the Y axis such that the
       // data displayed in the new X axis range are full scale on the Y
       // axis. For this, the Shift modifier key should be pressed.
  
       if(m_context.keyboardModifiers & Qt::ShiftModifier)
         {
  
           // In this case, we want to make a rescale of the Y axis such that
           // it displays full scale the data in the current X axis range only.
  
           bool ok = false;
  
           QCPRange value_range = getValueRangeOnKeyRange(nullptr, ok);
  
           yAxis->setRange(value_range);
         }
       // else, do leave the Y axis range unchanged.
     }
   // End of
   // if(m_context.wasClickOnXAxis)
   else // that is, if(m_context.wasClickOnYAxis)
     {
       // We are changing the range of the Y axis.
  
       // What is the y delta ?
       double yDelta =
         m_context.currentDragPoint.y() - m_context.startDragPoint.y();
  
       // See above for an explanation of the computation.
  
       yAxis->setRange(yLower, yUpper - yDelta);
  
       // Old version
       // if(yDelta < 0)
       //{
       //// The dragging operation was from top to bottom, we are enlarging
       //// the range (thus, we are unzooming the view, since the widget
       //// always has the same size).
  
       // yAxis->setRange(yLower, yUpper + fabs(yDelta));
       //}
       // else
       //{
       //// The dragging operation was from bottom to top, we are reducing
       //// the range (thus, we are zooming the view, since the widget
       //// always has the same size).
  
       // yAxis->setRange(yLower, yUpper - fabs(yDelta));
       //}
     }
   // End of
   // else // that is, if(m_context.wasClickOnYAxis)
  
   // Update the context with the current axes ranges
  
   updateContextRanges();
  
   emit plotRangesChangedSignal(m_context);
  
   replot();
 }

References pappso::BasePlotContext::currentDragPoint, getValueRangeOnKeyRange(), pappso::BasePlotContext::keyboardModifiers, pappso::BasePlotWidget::m_context, pappso::BasePlotWidget::plotRangesChangedSignal(), pappso::BasePlotContext::startDragPoint, pappso::BasePlotWidget::updateContextRanges(), and pappso::BasePlotContext::wasClickOnXAxis.

◆ axisZoom()

void pappso::BaseTracePlotWidget::axisZoom ( )

overridevirtual

Reimplemented from pappso::BasePlotWidget.

Definition at line 645 of file basetraceplotwidget.cpp.

 {
  
   // Use the m_context.xRegionRangeStart/End values, but we need to sort the
   // values before using them, because now we want to really have the lower x
   // value. Simply craft a QCPRange that will swap the values if lower is not
   // < than upper QCustomPlot calls this normalization).
  
   xAxis->setRange(
     QCPRange(m_context.xRegionRangeStart, m_context.xRegionRangeEnd));
  
   // If the shift modifier key is pressed, then the user want the y axis
   // to be full scale.
   if(m_context.keyboardModifiers & Qt::ShiftModifier)
     {
  
       bool ok = false;
  
       QCPRange value_range = getValueRangeOnKeyRange(nullptr, ok);
  
       yAxis->setRange(value_range);
     }
   else
     yAxis->setRange(
       QCPRange(m_context.yRegionRangeStart, m_context.yRegionRangeEnd));
  
   updateContextRanges();
  
   updateAxesRangeHistory();
   emit plotRangesChangedSignal(m_context);
  
   replot();
 }

References getValueRangeOnKeyRange(), pappso::BasePlotContext::keyboardModifiers, pappso::BasePlotWidget::m_context, pappso::BasePlotWidget::plotRangesChangedSignal(), pappso::BasePlotWidget::updateAxesRangeHistory(), pappso::BasePlotWidget::updateContextRanges(), pappso::BasePlotContext::xRegionRangeEnd, pappso::BasePlotContext::xRegionRangeStart, pappso::BasePlotContext::yRegionRangeEnd, and pappso::BasePlotContext::yRegionRangeStart.

◆ clearGraphData()

void pappso::BaseTracePlotWidget::clearGraphData ( int graph_index )

virtual

Definition at line 103 of file basetraceplotwidget.cpp.

 {
   QCPGraph *graph_p = graph(graph_index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   graph_p->data().clear();
  
   rescaleAxes();
   resetAxesRangeHistory();
   replot();
 }

References pappso::BasePlotWidget::resetAxesRangeHistory().

◆ findIntegrationLowerRangeForKey()

bool pappso::BaseTracePlotWidget::findIntegrationLowerRangeForKey	(	int	index,
		double	key,
		QCPRange &	range
	)

virtual

Find a minimal integration range starting at an existing data point.

If the user clicks onto a plot at a location that is not a true data point, get a data range that begins at the preceding data point and that ends at the clicked location point.

Definition at line 174 of file basetraceplotwidget.cpp.

 {
  
   // Given a key double value, we want to know what is the range that will
   // frame correctly the key double value if that key value is not exactly
   // the one of a point of the trace.
  
   // First of all get the keys of the graph.
  
   QCPGraph *theGraph = graph(index);
  
   if(theGraph == nullptr)
     qFatal(
       "Fatal error at %s@%d -- %s(). "
       "Programming error."
       "Program aborted.",
       __FILE__,
       __LINE__,
       __FUNCTION__);
  
  
   // QCPGraphDataContainer is a typedef QCPDataContainer<QCPGraphData> and
   // QCPDataContainer< DataType > is a Class Template. So in this context,
   // DataType is QCPGraphData.
   // QCPGraphData is the data point, that is the (key,value) pair.
   QSharedPointer<QCPGraphDataContainer> graph_data_container_p =
     theGraph->data();
  
   QCPDataRange dataRange = graph_data_container_p->dataRange();
  
   if(!dataRange.isValid())
     return false;
  
   if(!dataRange.size())
     return false;
  
   if(dataRange.size() > 1)
     {
       double firstKey = graph_data_container_p->at(dataRange.begin())->key;
       double lastKey  = graph_data_container_p->at(dataRange.end())->key;
  
       // There is one check to be done: the user might erroneously set the mouse
       // cursor beyond the last point of the graph. If that is the case, then
       // upper key needs to be that very point. All we need to do is return the
       // lower key, that is the pre-last key of the keys list. No need to
       // iterate in the keys list.
  
       if(key > lastKey)
         {
           // No need to search for the key in the keys, just get the lower key
           // immediately, that is, the key that is one slot left the last key.
           range.lower = graph_data_container_p->at(dataRange.end() - 2)->key;
           range.upper = graph_data_container_p->at(dataRange.end() - 1)->key;
  
           return true;
         }
  
       // Likewise, if the cursor is set left of the first plot point, then that
       // will be the lower range point. All we need is to provide the upper
       // range point as the second point of the plot.
  
       if(key < firstKey)
         {
           range.lower = firstKey;
           range.upper = graph_data_container_p->at(dataRange.begin() + 1)->key;
  
           return true;
         }
  
       // Finally the generic case where the user point to any point *in* the
       // graph.
  
       range.lower =
         graph_data_container_p->findBegin(key, /*expandedRange*/ true)->key;
       range.upper =
         std::prev(graph_data_container_p->findEnd(key, /*expandedRange*/ true))
           ->key;
  
       return true;
     }
  
   return false;
 }

◆ getValueRangeOnKeyRange() [1/2]

QCPRange pappso::BaseTracePlotWidget::getValueRangeOnKeyRange	(	int	index,
		bool &	ok
	)

Definition at line 367 of file basetraceplotwidget.cpp.

 {
  
   // The X axis range is set. But we want to find for that X axis range the
   // min and max Y values. This function is useful when the user asks that
   // while changing the X axis range, the trace be always in full scale on the
   // Y axis.
  
   QCPAbstractPlottable *plottable_p = plottable(index);
  
   if(plottable_p == nullptr)
     qFatal("Programming error.");
  
   return getValueRangeOnKeyRange(plottable_p, ok);
 }

References getValueRangeOnKeyRange().

◆ getValueRangeOnKeyRange() [2/2]

QCPRange pappso::BaseTracePlotWidget::getValueRangeOnKeyRange	(	QCPAbstractPlottable *	plottable_p,
		bool &	ok
	)

Definition at line 310 of file basetraceplotwidget.cpp.

 {
  
   // The X axis range is set. But we want to find for that X axis range the
   // min and max Y values. This function is useful when the user asks that
   // while changing the X axis range, the trace be always in full scale on the
   // Y axis.
  
   QCPRange key_range(xAxis->range().lower, xAxis->range().upper);
  
   if(plottable_p != nullptr)
     {
  
       return plottable_p->getValueRange(ok, QCP::SignDomain::sdBoth, key_range);
     }
   else
     {
  
       // How many graphs are currently plotted in this plot widget ?
       int graph_count = graphCount();
  
       // Iterate in each graph and get the y max value. Then compare with the
       // largest one and update if necessary. Store the pointer to the graph
       // that has a larger y value. At the end of the iteration, it will be
       // the winner.
  
       double temp_min_value = std::numeric_limits<double>::max();
       double temp_max_value = std::numeric_limits<double>::min();
  
       bool found_range = false;
  
       for(int iter = 0; iter < graph_count; ++iter)
         {
           QCPGraph *plottable_p = graph(iter);
  
           QCPRange value_range =
             plottable_p->getValueRange(ok, QCP::SignDomain::sdBoth, key_range);
  
           if(ok)
             found_range = true;
  
           if(value_range.lower < temp_min_value)
             temp_min_value = value_range.lower;
           if(value_range.upper > temp_max_value)
             temp_max_value = value_range.upper;
         }
  
       // At this point return the range.
  
       ok = found_range;
       return QCPRange(temp_min_value, temp_max_value);
     }
 }

Referenced by axisDoubleClickHandler(), axisPan(), axisReframe(), axisRescale(), axisZoom(), and getValueRangeOnKeyRange().

◆ getValuesX()

std::vector< double > pappso::BaseTracePlotWidget::getValuesX ( int index ) const

Definition at line 262 of file basetraceplotwidget.cpp.

 {
   std::vector<double> keys;
  
   QCPGraph *graph_p = graph(graph_index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   QSharedPointer<QCPGraphDataContainer> graph_data_container_p =
     graph_p->data();
  
   // Iterate in the keys
   auto beginIt = graph_data_container_p->begin();
   auto endIt   = graph_data_container_p->end();
  
   for(auto iter = beginIt; iter != endIt; ++iter)
     keys.push_back(iter->key);
  
   return keys;
 }

◆ getValuesY()

std::vector< double > pappso::BaseTracePlotWidget::getValuesY ( int index ) const

Definition at line 286 of file basetraceplotwidget.cpp.

 {
   std::vector<double> values;
  
   QCPGraph *graph_p = graph(graph_index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   QSharedPointer<QCPGraphDataContainer> graph_data_container_p =
     graph_p->data();
  
   // Iterate in the values
   auto beginIt = graph_data_container_p->begin();
   auto endIt   = graph_data_container_p->end();
  
   for(auto iter = beginIt; iter != endIt; ++iter)
     values.push_back(iter->key);
  
   return values;
 }

◆ getYatX() [1/2]

double pappso::BaseTracePlotWidget::getYatX	(	double	x,
		int	index = `0`
	)

Definition at line 401 of file basetraceplotwidget.cpp.

 {
   QCPGraph *graph_p = graph(index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   return getYatX(x, graph_p);
 }

References getYatX(), and pappso::x.

◆ getYatX() [2/2]

double pappso::BaseTracePlotWidget::getYatX	(	double	x,
		QCPGraph *	graph_p
	)

Definition at line 385 of file basetraceplotwidget.cpp.

 {
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   QCPItemTracer tracer(this);
   tracer.setGraph(graph_p);
   tracer.setInterpolating(true);
   tracer.setGraphKey(x);
   tracer.updatePosition();
  
   return tracer.position->value();
 }

References pappso::x.

Referenced by getYatX().

◆ setGraphData() [1/2]

void pappso::BaseTracePlotWidget::setGraphData	(	int	graph_index,
		const std::vector< double > &	keys,
		const std::vector< double > &	values
	)

virtual

Definition at line 70 of file basetraceplotwidget.cpp.

 {
   QCPGraph *graph_p = graph(graph_index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   return setGraphData(graph_p, keys, values);
 }

◆ setGraphData() [2/2]

void pappso::BaseTracePlotWidget::setGraphData	(	QCPGraph *	graph_p,
		const std::vector< double > &	keys,
		const std::vector< double > &	values
	)

virtual

Definition at line 84 of file basetraceplotwidget.cpp.

 {
   if(graph_p == nullptr)
     qFatal("Pointer cannot be nullptr.");
  
   graph_p->setData(QVector<double>::fromStdVector(keys),
                    QVector<double>::fromStdVector(values));
  
   graph_p->setPen(m_pen);
  
   rescaleAxes();
   resetAxesRangeHistory();
   replot();
 }

References pappso::BasePlotWidget::m_pen, and pappso::BasePlotWidget::resetAxesRangeHistory().

◆ toTrace() [1/4]

pappso::Trace pappso::BaseTracePlotWidget::toTrace ( const QCPGraph * graph_p ) const

Definition at line 734 of file basetraceplotwidget.cpp.

 {
   if(graph_p == nullptr)
     qFatal("Programming error. Pointer cannot be nullptr.");
  
   pappso::Trace trace;
  
   QSharedPointer<QCPGraphDataContainer> graph_data_container_p =
     graph_p->data();
  
   // Iterate in the keys
   auto beginIt = graph_data_container_p->begin();
   auto endIt   = graph_data_container_p->end();
  
   for(auto iter = beginIt; iter != endIt; ++iter)
     trace.push_back(pappso::DataPoint(iter->key, iter->value));
  
   return trace;
 }

◆ toTrace() [2/4]

pappso::Trace pappso::BaseTracePlotWidget::toTrace	(	const QCPRange &	x_axis_range,
		const QCPGraph *	graph_p
	)		const

Definition at line 768 of file basetraceplotwidget.cpp.

 {
  
   // Make a Trace with the data in the range.
   Trace data_trace;
  
   QSharedPointer<QCPGraphDataContainer> graph_data_container_sp;
  
   graph_data_container_sp = graph_p->data();
  
   // Grab the iterator to the start to the x axis range
   auto beginIt = graph_data_container_sp->findBegin(x_axis_range.lower,
                                                     /*expandedRange*/ true);
   // Grab the iterator to the end of the axis range
   auto endIt = graph_data_container_sp->findEnd(x_axis_range.upper,
                                                 /*expandedRange*/ true);
  
   for(auto iter = beginIt; iter != endIt; ++iter)
     data_trace.push_back(DataPoint(iter->key, iter->value));
  
   return data_trace;
 }

◆ toTrace() [3/4]

pappso::Trace pappso::BaseTracePlotWidget::toTrace	(	const QCPRange &	x_axis_range,
		int	index
	)		const

Definition at line 756 of file basetraceplotwidget.cpp.

 {
   QCPGraph *graph_p = graph(index);
  
   if(graph_p == nullptr)
     qFatal("Programming error.");
  
   return toTrace(x_axis_range, graph_p);
 }

References toTrace().

◆ toTrace() [4/4]

pappso::Trace pappso::BaseTracePlotWidget::toTrace ( int index ) const

Definition at line 725 of file basetraceplotwidget.cpp.

 {
   QCPGraph *graph_p = graph(index);
  
   return toTrace(graph_p);
 }

Referenced by toTrace().

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

pappsomspp/widget/plotwidget/basetraceplotwidget.h
pappsomspp/widget/plotwidget/basetraceplotwidget.cpp

Public Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ BaseTracePlotWidget() [1/2]

◆ BaseTracePlotWidget() [2/2]

◆ ~BaseTracePlotWidget()

Member Function Documentation

◆ addTrace()

◆ axisDoubleClickHandler()

◆ axisPan()

◆ axisReframe()

◆ axisRescale()

◆ axisZoom()

◆ clearGraphData()

◆ findIntegrationLowerRangeForKey()

◆ getValueRangeOnKeyRange() [1/2]

◆ getValueRangeOnKeyRange() [2/2]

◆ getValuesX()

◆ getValuesY()

◆ getYatX() [1/2]

◆ getYatX() [2/2]

◆ setGraphData() [1/2]

◆ setGraphData() [2/2]

◆ toTrace() [1/4]

◆ toTrace() [2/4]

◆ toTrace() [3/4]

◆ toTrace() [4/4]