org.djunits.unit

Class OffsetUnit<U extends Unit<U>>

java.lang.Object

org.djunits.unit.Unit<U>

org.djunits.unit.OffsetUnit<U>

Type Parameters:

U - the unit type

All Implemented Interfaces:

Serializable

Direct Known Subclasses:

TemperatureUnit

public abstract class OffsetUnit<U extends Unit<U>>
extends Unit<U>

The OffsetUnit provides a unit where scales can have an offset, such as the temperature scale. Internally, all units are internally stored as a standard unit with an offset and a conversion factor. This means that e.g., Kelvin is stored with offset 0.0 and conversion factor 1.0, whereas degree Celsius is stored with offset -273.15 and conversion factor 1.0. This means that if we have a Temperature, it is stored in Kelvins, and if we want to display it in degree Celsius, we have to divide by the conversion factor and subtract the offset.

Copyright (c) 2015 Delft University of Technology, PO Box 5, 2600 AA, Delft, the Netherlands. All rights reserved.
BSD-style license. See DJUNITS License.

$LastChangedDate: 2015-10-04 20:48:33 +0200 (Sun, 04 Oct 2015) $, @version $Revision: 87 $, by $Author: averbraeck $, initial version Jun 5, 2014

Author:

Alexander Verbraeck

See Also:

Serialized Form

Constructor Summary

Constructors

Constructor and Description
OffsetUnit(String nameOrNameKey, String abbreviationOrAbbreviationKey, UnitSystem unitSystem, boolean standardUnit) Build a standard unit.
OffsetUnit(String nameOrNameKey, String abbreviationOrAbbreviationKey, UnitSystem unitSystem, U referenceUnit, double conversionFactorToReferenceUnit, double offsetToStandardUnit, boolean standardUnit) Build an offset unit with a conversion factor and offset to another unit.

Method Summary

Modifier and Type	Method and Description
double	getOffsetToStandardUnit()

Methods inherited from class org.djunits.unit.Unit

equals, getAbbreviation, getAbbreviationKey, getAllUnitsOfThisType, getConversionFactorToStandardUnit, getName, getNameKey, getSICoefficients, getSICoefficientsString, getStandardUnit, getUnits, getUnitSystem, hashCode, isLocalizable, lookupOrCreateSIUnitWithSICoefficients, lookupOrCreateUnitWithSICoefficients, lookupUnitWithSICoefficients, toString

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Constructor Detail

OffsetUnit

public OffsetUnit(String nameOrNameKey,
                  String abbreviationOrAbbreviationKey,
                  UnitSystem unitSystem,
                  boolean standardUnit)

Build a standard unit.

Parameters:

nameOrNameKey - if standardUnit: the key to the locale file for the long name of the unit, otherwise the name itself

abbreviationOrAbbreviationKey - if standardUnit: the key to the locale file for the abbreviation of the unit, otherwise the abbreviation itself

unitSystem - the unit system, e.g. SI or Imperial

standardUnit - indicates whether it is a standard unit with a definition in the locale, or a user-defined unit

OffsetUnit

public OffsetUnit(String nameOrNameKey,
                  String abbreviationOrAbbreviationKey,
                  UnitSystem unitSystem,
                  U referenceUnit,
                  double conversionFactorToReferenceUnit,
                  double offsetToStandardUnit,
                  boolean standardUnit)

Build an offset unit with a conversion factor and offset to another unit.

Parameters:

nameOrNameKey - if standardUnit: the key to the locale file for the long name of the unit, otherwise the name itself

abbreviationOrAbbreviationKey - if standardUnit: the key to the locale file for the abbreviation of the unit, otherwise the abbreviation itself

unitSystem - the unit system, e.g. SI or Imperial

referenceUnit - the unit to convert to

conversionFactorToReferenceUnit - multiply a value in this unit by the factor to convert to the given reference unit

offsetToStandardUnit - the offset to add to convert to the standard (e.g., SI) unit

standardUnit - indicates whether it is a standard unit with a definition in the locale, or a user-defined unit

Method Detail

getOffsetToStandardUnit

public final double getOffsetToStandardUnit()

Returns:

offset to the standard unit. E.g., -273.15 to go from degrees Celsius to Kelvin