This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Class for a range of physical values. More...

Inheritance diagram for PhysicalValueRange:

Public Member Functions
override object	Clone ()
	Clones the current object. More...

override bool	Equals (object otherObject, EqualityIntent equalityIntent)
	Determines whether the specified Object is equal to this instance. More...

PhysicalValueRange	OverlappingRange (PhysicalValueRange range)
	Method that returns the overlap of this and a given PhysicalValueRange. More...

	PhysicalValueRange (double value1, double value2, PhysicalProperty property)
	Constructor with the most important parameters More...

	PhysicalValueRange (double value1, string name1, bool value1isElement, double value2, string name2, bool value2isElement, PhysicalProperty property)
	Constructor with all parameters More...

	PhysicalValueRange (PhysicalValue value1, bool value1isElement, PhysicalValue value2, bool value2isElement)
	Constructor with physical value parameters and inclusion information More...

	PhysicalValueRange (PhysicalValue value1, PhysicalValue value2)
	Constructor with physical value parameters More...

	PhysicalValueRange (PhysicalValueRange range)
	Copy constructor More...

bool	RangeContainsDoubleValue (double value, bool permissiveCheck)
	Method that checks whether a given double value is contained by this range. More...

bool	RangeContainsDoubleValue (double value, double epsilon)
	Method that checks whether a given double value is contained by this range. More...

bool	RangeContainsRange (PhysicalValueRange range)
	Method that checks whether a given PhysicalValueRange is contained (completely) by this, using the Globals.Epsilon value. More...

bool	RangeContainsRange (PhysicalValueRange range, double epsilon)
	Method that checks whether a given PhysicalValueRange is contained (completely) by this, using a given epsilon value. More...

bool	RangesOverlap (PhysicalValueRange range)
	Method that checks whether a given PhysicalValueRange overlaps with this. More...

AxisNumberFormat	SuggestAxisFormat ()
	Suggest an axis format for this. More...

override string	ToString ()
	Overridden ToString function. More...

Static Public Member Functions
static PhysicalValueRange	GetOrderedRange (PhysicalValueRange valueRange)
	Gets the input range whereas it is ensured that value 1 is not larger than value 2. More...

static bool	operator!= (PhysicalValueRange value1, PhysicalValueRange value2)
	Compares two PhysicalValueRange for inequality. More...

static bool	operator== (PhysicalValueRange range1, PhysicalValueRange range2)
	Compares two PhysicalValueRange for equality. More...

static PhysicalValueRange	SwapValues (PhysicalValueRange valueRangeToSwap)
	Method that returns a new physical value range with swapped values. More...

Properties
double	Center `[get]`
	Gets the center value of the range.

string	Name1 `[get, set]`
	Meaning of value1.

string	Name2 `[get, set]`
	Meaning of value2.

PhysicalProperty	PhysicalProperty `[get, set]`
	The unit of the physical value.

PhysicalValue	PhysicalValue1 `[get]`
	The value of the first physical value.

PhysicalValue	PhysicalValue2 `[get]`
	The value of the second physical value.

double	SignedValueRange `[get]`
	Gets the difference between Value2 and Value1

double	Value1 `[get, set]`
	First numerical value

bool	Value1IsElementOfRange `[get, set]`
	Determines if Value1 is an element of the PhysicalValueRange

double	Value2 `[get, set]`
	Second numerical value

bool	Value2IsElementOfRange `[get, set]`
	Determines if Value2 is an element of the PhysicalValueRange

Detailed Description

This class is subject to change. Programs using this class may require changes with a new version of VirtualLab.
Class for a range of physical values.

Constructor & Destructor Documentation

◆ PhysicalValueRange() [1/5]

PhysicalValueRange	(	double	value1,
		double	value2,
		PhysicalProperty	property
	)

Constructor with the most important parameters

Parameters

value1	First numerical value
value2	Second numerical value
property	The unit of the physical value.

◆ PhysicalValueRange() [2/5]

PhysicalValueRange	(	double	value1,
		string	name1,
		bool	value1isElement,
		double	value2,
		string	name2,
		bool	value2isElement,
		PhysicalProperty	property
	)

Constructor with all parameters

Parameters

value1	First numerical value
name1	Meaning of value1.
value1isElement	Determines if Value1 is an element of the PhysicalValueRange
value2	Second numerical value
name2	Meaning of value2.
value2isElement	Determines if Value2 is an element of the PhysicalValueRange
property	The unit of the physical value.

◆ PhysicalValueRange() [3/5]

PhysicalValueRange	(	PhysicalValue	value1,
		PhysicalValue	value2
	)

Constructor with physical value parameters

Parameters

value1	First physical value
value2	Second physical value

◆ PhysicalValueRange() [4/5]

PhysicalValueRange	(	PhysicalValue	value1,
		bool	value1isElement,
		PhysicalValue	value2,
		bool	value2isElement
	)

Constructor with physical value parameters and inclusion information

Parameters

value1	First physical value
value1isElement	Determines if Value1 is an element of the PhysicalValueRange
value2	Second physical value
value2isElement	Determines if Value2 is an element of the PhysicalValueRange

◆ PhysicalValueRange() [5/5]

PhysicalValueRange ( PhysicalValueRange range )

Copy constructor

Parameters

range Physical value range to copy

Member Function Documentation

◆ Clone()

override object Clone ( )

Clones the current object.

Returns: Deep copy of this object.

◆ Equals()

override bool Equals	(	object	otherObject,
		EqualityIntent	equalityIntent
	)

Determines whether the specified Object is equal to this instance.

Parameters

otherObject	The Object to compare with this instance.
equalityIntent	Defines what kind of equality you want to check when comparing two objects, for example all values or just physical equality.

Returns: true if the specified Object is equal to this instance; otherwise, false.

◆ GetOrderedRange()

static PhysicalValueRange GetOrderedRange ( PhysicalValueRange valueRange )

static

Gets the input range whereas it is ensured that value 1 is not larger than value 2.

Parameters

valueRange The value range.

Returns: The value range with swapped values if value 1 of the input range is larger than its value 2. Otherwise a copy of the original value range.

◆ operator!=()

static bool operator!=	(	PhysicalValueRange	value1,
		PhysicalValueRange	value2
	)

static

Compares two PhysicalValueRange for inequality.

Parameters

value1	First PhysicalValueRange object to compare.
value2	Second PhysicalValueRange object to compare.

Returns: Returns true if the two objects are unequal.

◆ operator==()

static bool operator==	(	PhysicalValueRange	range1,
		PhysicalValueRange	range2
	)

static

Compares two PhysicalValueRange for equality.

Parameters

range1	First PhysicalValueRange object to compare.
range2	Second PhysicalValueRange object to compare.

Returns: Returns true if the two objects are equal.

◆ OverlappingRange()

PhysicalValueRange OverlappingRange ( PhysicalValueRange range )

Method that returns the overlap of this and a given PhysicalValueRange.

Parameters

range Range with which to calculate the overlap with this instance.

Returns: The range overlap. The physical properties are determined by this. In case of no overlap, null is returned.

Exceptions

ArgumentNullException

◆ RangeContainsDoubleValue() [1/2]

bool RangeContainsDoubleValue	(	double	value,
		bool	permissiveCheck
	)

Method that checks whether a given double value is contained by this range.

Parameters

value	Value to check for lying inside the range
permissiveCheck	If TRUE, the check will allow the value to be in a small epsilon outside the range.

Returns: TRUE if double value is contained by this range, otherwise FALSE

◆ RangeContainsDoubleValue() [2/2]

bool RangeContainsDoubleValue	(	double	value,
		double	epsilon
	)

Method that checks whether a given double value is contained by this range.

Parameters

value	Value to check for lying inside the range
epsilon	The check will allow the value to lie in a small epsilon outside the range.

Returns: TRUE if double value is contained by this range, otherwise FALSE

◆ RangeContainsRange() [1/2]

bool RangeContainsRange ( PhysicalValueRange range )

Method that checks whether a given PhysicalValueRange is contained (completely) by this, using the Globals.Epsilon value.

Parameters

range Range to be checked if it lies inside this.

Returns: true if range lies inside this.

◆ RangeContainsRange() [2/2]

bool RangeContainsRange	(	PhysicalValueRange	range,
		double	epsilon
	)

Method that checks whether a given PhysicalValueRange is contained (completely) by this, using a given epsilon value.

Parameters

range	Range to be checked if it lies inside this.
epsilon	Epsilon (= relative deviation) to be used for comparison.

Returns: true if range lies inside this.

◆ RangesOverlap()

bool RangesOverlap ( PhysicalValueRange range )

Method that checks whether a given PhysicalValueRange overlaps with this.

Parameters

range

Returns

◆ SuggestAxisFormat()

AxisNumberFormat SuggestAxisFormat ( )

Suggest an axis format for this.

Returns: The suggest axis number format (scientific, standard, or engineering).

◆ SwapValues()

static PhysicalValueRange SwapValues ( PhysicalValueRange valueRangeToSwap )

static

Method that returns a new physical value range with swapped values.

Parameters

valueRangeToSwap Value range whose values are to be swapped.

Returns: Value range with swapped values.

◆ ToString()

override string ToString ( )

Overridden ToString function.

Returns: The formatted value.

Public Member Functions

Static Public Member Functions

Properties

Detailed Description

Constructor & Destructor Documentation

◆ PhysicalValueRange() [1/5]

◆ PhysicalValueRange() [2/5]

◆ PhysicalValueRange() [3/5]

◆ PhysicalValueRange() [4/5]

◆ PhysicalValueRange() [5/5]

Member Function Documentation

◆ Clone()

◆ Equals()

◆ GetOrderedRange()

◆ operator!=()

◆ operator==()

◆ OverlappingRange()

◆ RangeContainsDoubleValue() [1/2]

◆ RangeContainsDoubleValue() [2/2]

◆ RangeContainsRange() [1/2]

◆ RangeContainsRange() [2/2]

◆ RangesOverlap()

◆ SuggestAxisFormat()

◆ SwapValues()

◆ ToString()