org.jfree.data
Class Range
- Serializable
extends java.lang.Object
implements Serializable
Represents an immutable range of values.
Range(double lower, double upper) - Creates a new range.
|
static Range | combine(Range range1, Range range2) - Creates a new range by combining two existing ranges.
|
double | constrain(double value) - Returns the value within the range that is closest to the specified
value.
|
boolean | contains(double value) - Returns
true if the range contains the specified value and
false otherwise.
|
boolean | equals(Object obj) - Tests this object for equality with an arbitrary object.
|
static Range | expand(Range range, double lowerMargin, double upperMargin) - Creates a new range by adding margins to an existing range.
|
static Range | expandToInclude(Range range, double value) - Returns a range that includes all the values in the specified
range AND the specified value .
|
double | getCentralValue() - Returns the central value for the range.
|
double | getLength() - Returns the length of the range.
|
double | getLowerBound() - Returns the lower bound for the range.
|
double | getUpperBound() - Returns the upper bound for the range.
|
int | hashCode() - Returns a hash code.
|
boolean | intersects(double b0, double b1) - Returns
true if the range intersects with the specified
range, and false otherwise.
|
static Range | shift(Range base, double delta) - Shifts the range by the specified amount.
|
static Range | shift(Range base, double delta, boolean allowZeroCrossing) - Shifts the range by the specified amount.
|
String | toString() - Returns a string representation of this Range.
|
Range
public Range(double lower,
double upper)
Creates a new range.
lower
- the lower bound (must be <= upper bound).upper
- the upper bound (must be >= lower bound).
combine
public static Range combine(Range range1,
Range range2)
Creates a new range by combining two existing ranges.
Note that:
- either range can be
null
, in which case the other
range is returned; - if both ranges are
null
the return value is
null
.
range1
- the first range (null
permitted).range2
- the second range (null
permitted).
- A new range (possibly
null
).
constrain
public double constrain(double value)
Returns the value within the range that is closest to the specified
value.
contains
public boolean contains(double value)
Returns true
if the range contains the specified value and
false
otherwise.
value
- the value to lookup.
true
if the range contains the specified value.
equals
public boolean equals(Object obj)
Tests this object for equality with an arbitrary object.
obj
- the object to test against (null
permitted).
expand
public static Range expand(Range range,
double lowerMargin,
double upperMargin)
Creates a new range by adding margins to an existing range.
range
- the range (null
not permitted).lowerMargin
- the lower margin (expressed as a percentage of the
range length).upperMargin
- the upper margin (expressed as a percentage of the
range length).
expandToInclude
public static Range expandToInclude(Range range,
double value)
Returns a range that includes all the values in the specified
range
AND the specified value
.
range
- the range (null
permitted).value
- the value that must be included.
getCentralValue
public double getCentralValue()
Returns the central value for the range.
getLength
public double getLength()
Returns the length of the range.
getLowerBound
public double getLowerBound()
Returns the lower bound for the range.
getUpperBound
public double getUpperBound()
Returns the upper bound for the range.
hashCode
public int hashCode()
Returns a hash code.
intersects
public boolean intersects(double b0,
double b1)
Returns true
if the range intersects with the specified
range, and false
otherwise.
b0
- the lower bound (should be <= b1).b1
- the upper bound (should be >= b0).
shift
public static Range shift(Range base,
double delta)
Shifts the range by the specified amount.
base
- the base range.delta
- the shift amount.
shift
public static Range shift(Range base,
double delta,
boolean allowZeroCrossing)
Shifts the range by the specified amount.
base
- the base range.delta
- the shift amount.allowZeroCrossing
- a flag that determines whether or not the
bounds of the range are allowed to cross
zero after adjustment.
toString
public String toString()
Returns a string representation of this Range.
- A String "Range[lower,upper]" where lower=lower range and
upper=upper range.