Package javax.measure.converter

Class AddConverter

java.lang.Object
javax.measure.converter.UnitConverter
javax.measure.converter.AddConverter
All Implemented Interfaces:
Serializable
public final class AddConverter extends UnitConverter

This class represents a converter adding a constant offset (approximated as a double) to numeric values.

Instances of this class are immutable.

See Also:

  • Constructor Details

    • AddConverter

      public AddConverter(double offset)
      Creates an add converter with the specified offset.
      Parameters:
      offset - the offset value.
      Throws:
      IllegalArgumentException - if offset is zero (or close to zero).

  • Method Details

    • getOffset

      public double getOffset()
      Returns the offset value for this add converter.
      Returns:
      the offset value.

    • inverse

      public UnitConverter inverse()
      Description copied from class: UnitConverter
      Returns the inverse of this converter. If x is a valid value, then x == inverse().convert(convert(x)) to within the accuracy of computer arithmetic.
      Specified by:
      inverse in class UnitConverter
      Returns:
      the inverse of this converter.

    • convert

      public double convert(double amount)
      Description copied from class: UnitConverter
      Converts a double value.
      Specified by:
      convert in class UnitConverter
      Parameters:
      amount - the numeric value to convert.
      Returns:
      the converted numeric value.

    • isLinear

      public boolean isLinear()
      Description copied from class: UnitConverter
      Indicates if this converter is linear. A converter is linear if convert(u + v) == convert(u) + convert(v) and convert(r * u) == r * convert(u). For linear converters the following property always hold:[code] y1 = c1.convert(x1); y2 = c2.convert(x2); then y1*y2 = c1.concatenate(c2).convert(x1*x2)[/code]
      Specified by:
      isLinear in class UnitConverter
      Returns:
      true if this converter is linear; false otherwise.

    • concatenate

      public UnitConverter concatenate(UnitConverter converter)
      Description copied from class: UnitConverter
      Concatenates this converter with another converter. The resulting converter is equivalent to first converting by the specified converter, and then converting by this converter.

      Note: Implementations must ensure that the UnitConverter.IDENTITY instance is returned if the resulting converter is an identity converter.

      Overrides:
      concatenate in class UnitConverter
      Parameters:
      converter - the other converter.
      Returns:
      the concatenation of this converter with the other converter.