Constructor Detail

• DefaultUnitService

  public DefaultUnitService()

Method Detail

• value

  public double value(double inputValue,
                      String inputUnit,
                      String outputUnit)

  Description copied from interface: UnitService
  Returns a value after conversion between two compatible types of units. Each unit can be a compound unit string. For instance "inch" or "kg*m/s" or "pounds/inch^2", "km/hour**2", etc. Returns the number of output unit values represented by the number of input values of input type. Returns Double.NaN if the unit types are incompatible.

  Specified by:

  value in interface UnitService

  Parameters:

  inputValue - The double representing the number of input units.

  inputUnit - The string representing the input unit.

  outputUnit - The string representing the output unit.

  Returns:

  The value in output units after converting the inputValue from input units.

• defineUnit

  public void defineUnit(String unitName,
                         String baseUnit,
                         double scale)

  Description copied from interface: UnitService
  Defines a unit conversion that can be referred to via the value() method. Note that baseUnit is not necessarily a name. It could be a compound unit string like "m/s^2" etc. Imagine we define a unit called "fliggs" that is 14.2 m/s^2.

  Specified by:

  defineUnit in interface UnitService

  Parameters:

  unitName - The name of the unit being defined e.g. "fliggs".

  baseUnit - The unit the defined unit is based upon e.g. "m/s^2".

  scale - The ratio of defined units to base units e.g. 14.2.

• defineUnit

  public void defineUnit(String unitName,
                         String baseUnit,
                         double scale,
                         double offset)

  Description copied from interface: UnitService
  Defines a unit conversion that can be referred to via the value() method. Note that baseUnit is not necessarily a name. It could be a compound unit string like "m/s^2" etc. Imagine we define a unit called "fliggs" that is 14.2 m/s^2 offset by 3.3 from baseUnit. An example of an offset is the 32 used in conversion between celsius and fahrenheit.

  Specified by:

  defineUnit in interface UnitService

  Parameters:

  unitName - The name of the unit being defined e.g. "fliggs".

  baseUnit - The unit the defined unit is based upon e.g. "m/s^2".

  scale - The ratio of defined units to base units e.g. 14.2.

  offset - The offset of defined units to base units e.g. 3.3.

• defineUnit

  public void defineUnit(String unitName,
                         String baseUnit,
                         Calibrator calibrator)

  Description copied from interface: UnitService
  Defines a unit conversion that can be referred to via the value() method. Note that baseUnit is not necessarily a name. It could be a compound unit string like "m/s^2" etc. Imagine we define a unit called "fliggs" that has a nonlinear conversion from baseUnit. One supplies a Calibrator that handles conversion. The Calibrator allows any kind of conversion between units including nonlinear ones (i.e. can support log units).

  Specified by:

  defineUnit in interface UnitService

  Parameters:

  unitName - The name of the unit being defined e.g. "fliggs".

  baseUnit - The unit the defined unit is based upon e.g. "m/s^2".

  calibrator - The Calibrator the maps between the two unit spaces.