Vespucci  1.0.0
QCPRange Class Reference

Represents the range an axis is encompassing. More...

#include <qcustomplot.h>

Public Member Functions

 QCPRange ()
 
 QCPRange (double lower, double upper)
 
bool operator== (const QCPRange &other) const
 
bool operator!= (const QCPRange &other) const
 
QCPRangeoperator+= (const double &value)
 
QCPRangeoperator-= (const double &value)
 
QCPRangeoperator*= (const double &value)
 
QCPRangeoperator/= (const double &value)
 
double size () const
 
double center () const
 
void normalize ()
 
void expand (const QCPRange &otherRange)
 
QCPRange expanded (const QCPRange &otherRange) const
 
QCPRange sanitizedForLogScale () const
 
QCPRange sanitizedForLinScale () const
 
bool contains (double value) const
 

Static Public Member Functions

static bool validRange (double lower, double upper)
 
static bool validRange (const QCPRange &range)
 

Public Attributes

double lower
 
double upper
 

Static Public Attributes

static const double minRange = 1e-280
 
static const double maxRange = 1e250
 

Friends

const QCPRange operator+ (const QCPRange &, double)
 
const QCPRange operator+ (double, const QCPRange &)
 
const QCPRange operator- (const QCPRange &range, double value)
 
const QCPRange operator* (const QCPRange &range, double value)
 
const QCPRange operator* (double value, const QCPRange &range)
 
const QCPRange operator/ (const QCPRange &range, double value)
 

Detailed Description

Represents the range an axis is encompassing.

contains a lower and upper double value and provides convenience input, output and modification functions.

See also
QCPAxis::setRange

Definition at line 481 of file qcustomplot.h.

Constructor & Destructor Documentation

QCPRange::QCPRange ( )

Constructs a range with lower and upper set to zero.

Definition at line 1314 of file qcustomplot.cpp.

QCPRange::QCPRange ( double  lower,
double  upper 
)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Constructs a range with the specified lower and upper values.

Definition at line 1323 of file qcustomplot.cpp.

Member Function Documentation

double QCPRange::center ( ) const

Returns the center of the range, i.e. (upper+lower)*0.5

Definition at line 1341 of file qcustomplot.cpp.

bool QCPRange::contains ( double  value) const

Returns true when value lies within or exactly on the borders of the range.

Definition at line 1457 of file qcustomplot.cpp.

void QCPRange::expand ( const QCPRange otherRange)

Expands this range such that otherRange is contained in the new range. It is assumed that both this range and otherRange are normalized (see normalize).

If otherRange is already inside the current range, this function does nothing.

See also
expanded

Definition at line 1364 of file qcustomplot.cpp.

QCPRange QCPRange::expanded ( const QCPRange otherRange) const

Returns an expanded range that contains this and otherRange. It is assumed that both this range and otherRange are normalized (see normalize).

See also
expand

Definition at line 1379 of file qcustomplot.cpp.

void QCPRange::normalize ( )

Makes sure lower is numerically smaller than upper. If this is not the case, the values are swapped.

Definition at line 1350 of file qcustomplot.cpp.

bool QCPRange::operator!= ( const QCPRange other) const
inline

Definition at line 490 of file qcustomplot.h.

QCPRange & QCPRange::operator*= ( const double &  value)
inline

Multiplies both boundaries of the range by value.

Definition at line 494 of file qcustomplot.h.

QCPRange & QCPRange::operator+= ( const double &  value)
inline

Adds value to both boundaries of the range.

Definition at line 492 of file qcustomplot.h.

QCPRange & QCPRange::operator-= ( const double &  value)
inline

Subtracts value from both boundaries of the range.

Definition at line 493 of file qcustomplot.h.

QCPRange & QCPRange::operator/= ( const double &  value)
inline

Divides both boundaries of the range by value.

Definition at line 495 of file qcustomplot.h.

bool QCPRange::operator== ( const QCPRange other) const
inline

Definition at line 489 of file qcustomplot.h.

QCPRange QCPRange::sanitizedForLinScale ( ) const

Returns a sanitized version of the range. Sanitized means for linear scales, that lower will always be numerically smaller (or equal) to upper.

Definition at line 1447 of file qcustomplot.cpp.

QCPRange QCPRange::sanitizedForLogScale ( ) const

Returns a sanitized version of the range. Sanitized means for logarithmic scales, that the range won't span the positive and negative sign domain, i.e. contain zero. Further lower will always be numerically smaller (or equal) to upper.

If the original range does span positive and negative sign domains or contains zero, the returned range will try to approximate the original range as good as possible. If the positive interval of the original range is wider than the negative interval, the returned range will only contain the positive interval, with lower bound set to rangeFac or rangeFac *upper, whichever is closer to zero. Same procedure is used if the negative interval is wider than the positive interval, this time by changing the upper bound.

Definition at line 1398 of file qcustomplot.cpp.

double QCPRange::size ( ) const

Returns the size of the range, i.e. upper-lower

Definition at line 1333 of file qcustomplot.cpp.

bool QCPRange::validRange ( double  lower,
double  upper 
)
static

Checks, whether the specified range is within valid bounds, which are defined as QCPRange::maxRange and QCPRange::minRange. A valid range means:

  • range bounds within -maxRange and maxRange
  • range size above minRange
  • range size below maxRange

Definition at line 1470 of file qcustomplot.cpp.

bool QCPRange::validRange ( const QCPRange range)
static

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. Checks, whether the specified range is within valid bounds, which are defined as QCPRange::maxRange and QCPRange::minRange. A valid range means:

  • range bounds within -maxRange and maxRange
  • range size above minRange
  • range size below maxRange

Definition at line 1494 of file qcustomplot.cpp.

Friends And Related Function Documentation

const QCPRange operator* ( const QCPRange range,
double  value 
)
friend

Multiplies both boundaries of the range by value.

Definition at line 577 of file qcustomplot.h.

const QCPRange operator* ( double  value,
const QCPRange range 
)
friend

Multiplies both boundaries of the range by value.

Definition at line 587 of file qcustomplot.h.

const QCPRange operator+ ( const QCPRange range,
double  value 
)
friend

Adds value to both boundaries of the range.

Definition at line 547 of file qcustomplot.h.

const QCPRange operator+ ( double  value,
const QCPRange range 
)
friend

Adds value to both boundaries of the range.

Definition at line 557 of file qcustomplot.h.

const QCPRange operator- ( const QCPRange range,
double  value 
)
friend

Subtracts value from both boundaries of the range.

Definition at line 567 of file qcustomplot.h.

const QCPRange operator/ ( const QCPRange range,
double  value 
)
friend

Divides both boundaries of the range by value.

Definition at line 597 of file qcustomplot.h.

Member Data Documentation

double QCPRange::lower

Definition at line 484 of file qcustomplot.h.

const double QCPRange::maxRange = 1e250
static

Maximum values (negative and positive) the range will accept in range-changing functions. Larger absolute values would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a maximum magnitude of roughly 1e308. Since the number of planck-volumes in the entire visible universe is only ~1e183, this should be enough.

See also
validRange, minRange

Definition at line 515 of file qcustomplot.h.

const double QCPRange::minRange = 1e-280
static

Minimum range size (upper - lower) the range changing functions will accept. Smaller intervals would cause errors due to the 11-bit exponent of double precision numbers, corresponding to a minimum magnitude of roughly 1e-308.

See also
validRange, maxRange

Definition at line 514 of file qcustomplot.h.

double QCPRange::upper

Definition at line 484 of file qcustomplot.h.


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