Package org.openjdk.jmc.common.unit

Class CustomUnitSelector

java.lang.Object

org.openjdk.jmc.common.unit.CustomUnitSelector

All Implemented Interfaces:

LinearKindOfQuantity.LinearUnitSelector, TypedUnit.UnitSelector<LinearUnit>

public class CustomUnitSelector
extends Object
implements LinearKindOfQuantity.LinearUnitSelector

Field Summary

Fields

Modifier and Type	Field	Description
protected final LinearKindOfQuantity.LinearUnitSelector	bigSelector
protected final LinearKindOfQuantity	kindOfQuantity
protected final LinearKindOfQuantity.LinearUnitSelector	smallSelector
protected final ArrayList<ITypedQuantity<LinearUnit>>	tickList
protected final double[]	tickMultiplierArr
protected final LinearUnit[]	unitArr
protected final double[]	unitMultiplierArr

Constructor Summary

Constructors

Constructor	Description
CustomUnitSelector(LinearKindOfQuantity kindOfQuantity, LinearKindOfQuantity.LinearUnitSelector smallSelector, Collection<LinearUnit> units, LinearKindOfQuantity.LinearUnitSelector bigSelector, SortedSet<ITypedQuantity<LinearUnit>> ticks)

Method Summary

Modifier and Type	Method	Description
LinearUnit	getLargestExactUnit(ITypedQuantity<LinearUnit> quantity)	Get the largest unit, if any, in which this quantity can be expressed exactly, typically with an integer.
LinearUnit	getPreferredUnit(ITypedQuantity<LinearUnit> quantity, double minNumericalValue, double maxNumericalValue)
ITypedQuantity<LinearUnit>	snapToBestBetweenHalfAndEqual(ITypedQuantity<LinearUnit> upperLimit)

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

kindOfQuantity

protected final LinearKindOfQuantity kindOfQuantity

unitMultiplierArr

protected final double[] unitMultiplierArr

unitArr

protected final LinearUnit[] unitArr

tickMultiplierArr

protected final double[] tickMultiplierArr

tickList

protected final ArrayList<ITypedQuantity<LinearUnit>> tickList

smallSelector

protected final LinearKindOfQuantity.LinearUnitSelector smallSelector

bigSelector

protected final LinearKindOfQuantity.LinearUnitSelector bigSelector

Constructor Details

CustomUnitSelector

public CustomUnitSelector(LinearKindOfQuantity kindOfQuantity,
 LinearKindOfQuantity.LinearUnitSelector smallSelector,
 Collection<LinearUnit> units,
 LinearKindOfQuantity.LinearUnitSelector bigSelector,
 SortedSet<ITypedQuantity<LinearUnit>> ticks)

Method Details

getPreferredUnit

public LinearUnit getPreferredUnit(ITypedQuantity<LinearUnit> quantity,
 double minNumericalValue,
 double maxNumericalValue)

Specified by:

getPreferredUnit in interface TypedUnit.UnitSelector<LinearUnit>

snapToBestBetweenHalfAndEqual

public ITypedQuantity<LinearUnit> snapToBestBetweenHalfAndEqual(ITypedQuantity<LinearUnit> upperLimit)

Specified by:

snapToBestBetweenHalfAndEqual in interface LinearKindOfQuantity.LinearUnitSelector

getLargestExactUnit

public LinearUnit getLargestExactUnit(ITypedQuantity<LinearUnit> quantity)

Description copied from interface: TypedUnit.UnitSelector

Get the largest unit, if any, in which this quantity can be expressed exactly, typically with an integer. If the quantity has zero magnitude ( IQuantity.doubleValue() == 0.0), quantity.getUnit() will be returned. Thus, if you want to find out a maximum common unit for a set of quantities (not recommended), only use the non-zero quantities.

Note that this may be a fairly expensive operation, and isn't intended to be used excessively. The only valid use case is for guessing the original unit in which a quantity was expressed, after it has been stored or transmitted using a legacy mechanism with a fixed unit.

Specified by:

getLargestExactUnit in interface TypedUnit.UnitSelector<LinearUnit>

Returns:

a unit or null