IDataSeries.h
102 lines
| 3.5 KiB
| text/x-c
|
CLexer
|
r125 | #ifndef SCIQLOP_IDATASERIES_H | ||
#define SCIQLOP_IDATASERIES_H | ||||
|
r308 | #include <Common/MetaTypes.h> | ||
|
r597 | #include <Data/DataSeriesIterator.h> | ||
r539 | #include <Data/SqpRange.h> | |||
|
r864 | #include <Data/Unit.h> | ||
|
r125 | |||
#include <memory> | ||||
r233 | #include <QString> | |||
|
r125 | template <int Dim> | ||
class ArrayData; | ||||
/** | ||||
* @brief The IDataSeries aims to declare a data series. | ||||
* | ||||
* A data series is an entity that contains at least : | ||||
* - one dataset representing the x-axis | ||||
* - one dataset representing the values | ||||
* | ||||
* Each dataset is represented by an ArrayData, and is associated with a unit. | ||||
* | ||||
* An ArrayData can be unidimensional or two-dimensional, depending on the implementation of the | ||||
* IDataSeries. The x-axis dataset is always unidimensional. | ||||
* | ||||
* @sa ArrayData | ||||
*/ | ||||
class IDataSeries { | ||||
public: | ||||
virtual ~IDataSeries() noexcept = default; | ||||
/// Returns the x-axis dataset | ||||
virtual std::shared_ptr<ArrayData<1> > xAxisData() = 0; | ||||
|
r310 | /// Returns the x-axis dataset (as const) | ||
virtual const std::shared_ptr<ArrayData<1> > xAxisData() const = 0; | ||||
|
r177 | virtual Unit xAxisUnit() const = 0; | ||
|
r125 | |||
|
r962 | /// @return the y-axis unit, if axis is defined, default unit otherwise | ||
virtual Unit yAxisUnit() const = 0; | ||||
|
r177 | virtual Unit valuesUnit() const = 0; | ||
r233 | ||||
virtual void merge(IDataSeries *dataSeries) = 0; | ||||
|
r676 | /// Removes from data series all entries whose value on the x-axis is not between min and max | ||
virtual void purge(double min, double max) = 0; | ||||
|
r554 | /// @todo Review the name and signature of this method | ||
virtual std::shared_ptr<IDataSeries> subDataSeries(const SqpRange &range) = 0; | ||||
|
r310 | |||
virtual std::unique_ptr<IDataSeries> clone() const = 0; | ||||
|
r717 | |||
/// @return the total number of points contained in the data series | ||||
virtual int nbPoints() const = 0; | ||||
|
r962 | /// @return the bounds of the y-axis axis (if defined) | ||
virtual std::pair<double, double> yBounds() const = 0; | ||||
|
r597 | // ///////// // | ||
// Iterators // | ||||
// ///////// // | ||||
virtual DataSeriesIterator cbegin() const = 0; | ||||
virtual DataSeriesIterator cend() const = 0; | ||||
|
r673 | virtual DataSeriesIterator begin() = 0; | ||
virtual DataSeriesIterator end() = 0; | ||||
|
r597 | |||
|
r599 | /// @return the iterator to the first entry of the data series whose x-axis data is greater than | ||
/// or equal to the value passed in parameter, or the end iterator if there is no matching value | ||||
|
r604 | virtual DataSeriesIterator minXAxisData(double minXAxisData) const = 0; | ||
|
r599 | |||
|
r600 | /// @return the iterator to the last entry of the data series whose x-axis data is less than or | ||
/// equal to the value passed in parameter, or the end iterator if there is no matching value | ||||
|
r604 | virtual DataSeriesIterator maxXAxisData(double maxXAxisData) const = 0; | ||
|
r600 | |||
|
r605 | /// @return the iterators pointing to the range of data whose x-axis values are between min and | ||
/// max passed in parameters | ||||
virtual std::pair<DataSeriesIterator, DataSeriesIterator> | ||||
xAxisRange(double minXAxisData, double maxXAxisData) const = 0; | ||||
|
r597 | |||
|
r608 | /// @return two iterators pointing to the data that have respectively the min and the max value | ||
/// data of a data series' range. The search is performed for a given x-axis range. | ||||
/// @sa xAxisRange() | ||||
virtual std::pair<DataSeriesIterator, DataSeriesIterator> | ||||
valuesBounds(double minXAxisData, double maxXAxisData) const = 0; | ||||
|
r597 | // /////// // | ||
// Mutexes // | ||||
// /////// // | ||||
r364 | virtual void lockRead() = 0; | |||
virtual void lockWrite() = 0; | ||||
virtual void unlock() = 0; | ||||
|
r125 | }; | ||
r233 | // Required for using shared_ptr in signals/slots | |||
|
r308 | SCIQLOP_REGISTER_META_TYPE(IDATASERIES_PTR_REGISTRY, std::shared_ptr<IDataSeries>) | ||
r233 | ||||
|
r125 | #endif // SCIQLOP_IDATASERIES_H | ||