Package edu.wpi.first.units

Class VoltageUnit

java.lang.Object
edu.wpi.first.units.Unit
edu.wpi.first.units.VoltageUnit
public final class VoltageUnit extends Unit
Unit of electric voltage dimension.

This is the base type for units of voltage dimension. It is also used to specify the dimension for Measure: Measure<VoltageUnit>.

Actual units (such as Units.Volts and Units.Millivolts) can be found in the Units class.

  • Method Details

    • getBaseUnit

      public VoltageUnit getBaseUnit()
      Description copied from class: Unit
      Gets the base unit of measurement that this unit is derived from. If the unit is the base unit, the unit will be returned.

      NOTE: Subclasses must override this method to provide the correct return type. Failing to do say will make unit combinations that use it break at runtime! 

      
   Unit baseUnit = new Unit(null, ...);
   baseUnit.getBaseUnit(); // returns baseUnit

   Unit derivedUnit = new Unit(baseUnit, ...);
   derivedUnit.getBaseUnit(); // returns baseUnit
      Overrides:
      getBaseUnit in class Unit
      Returns:
      the base unit

    • mult

      public PowerUnit mult(CurrentUnit current, String name, String symbol)
      Constructs a unit of power equivalent to this unit of voltage multiplied by another unit of electrical current. For example, Volts.times(Amps) will return a unit of power equivalent to one Watt; Volts.times(Milliamps) will return a unit of power equivalent to a milliwatt, and so on.
      Parameters:
      current - the current unit to multiply by
      name - the name of the resulting unit of power
      symbol - the symbol used to represent the unit of power
      Returns:
      the power unit

    • of

      public Voltage of(double magnitude)
      Description copied from class: Unit
      Creates a new immutable measurement of the given magnitude in terms of this unit. Implementations are strongly recommended to sharpen the return type to a unit-specific measurement implementation.
      Specified by:
      of in class Unit
      Parameters:
      magnitude - the magnitude of the measurement.
      Returns:
      the measurement object

    • ofBaseUnits

      public Voltage ofBaseUnits(double baseUnitMagnitude)
      Description copied from class: Unit
      Creates a new immutable measurement of the given magnitude in terms of this unit's base unit. Implementations are strongly recommended to sharpen the return type to a unit-specific measurement implementation.
      Specified by:
      ofBaseUnits in class Unit
      Parameters:
      baseUnitMagnitude - the magnitude in terms of the base unit
      Returns:
      the measurement object

    • zero

      public Voltage zero()
      Description copied from class: Unit
      Gets a measure of zero magnitude in terms of this unit. The returned object is guaranteed to be of the same type returned by Unit.of(double). Subclasses are encouraged to override this method to sharpen the return type.
      Overrides:
      zero in class Unit
      Returns:
      a zero-magnitude measure of this unit

    • one

      public Voltage one()
      Description copied from class: Unit
      Gets a measure with a magnitude of 1.0 in terms of this unit. The returned object is guaranteed to be of the same type returned by Unit.of(double). Subclasses are encouraged to override this method to sharpen the return type.
      Overrides:
      one in class Unit
      Returns:
      a measure of magnitude 1.0 in terms of this unit

    • mutable

      public MutVoltage mutable(double magnitude)
      Description copied from class: Unit
      Creates a new mutable measurement that is initialized to the given magnitude in terms of this unit. Implementations are strongly recommended to sharpen the return type to a unit-specific measurement implementation.
      Specified by:
      mutable in class Unit
      Parameters:
      magnitude - the initial magnitude of the mutable measurement
      Returns:
      the mutable measurement object

    • per

      public VelocityUnit<VoltageUnit> per(TimeUnit period)
      Description copied from class: Unit
      Combines this unit with a unit of time. This often - but not always - results in a velocity. Subclasses should sharpen the return type to be unit-specific.
      Specified by:
      per in class Unit
      Parameters:
      period - the unit of time
      Returns:
      the combined unit

    • per

      public ResistanceUnit per(CurrentUnit currentUnit)
      Combines this unit of voltage with a unit of current to form a unit of resistance.
      Parameters:
      currentUnit - the unit of current
      Returns:
      the combined resistance unit

    • per

      public <U extends Unit> PerUnit<VoltageUnit,U> per(U other)
      Creates a generic ratio unit of this voltage to a different unit type.
      Type Parameters:
      U - the type of the other unit
      Parameters:
      other - the other unit type
      Returns:
      the combined ratio type

    • convertFrom

      public double convertFrom(double magnitude, VoltageUnit otherUnit)
      Converts a measurement value in terms of another voltage unit to this unit.
      Parameters:
      magnitude - the magnitude of the measurement in terms of the other voltage unit
      otherUnit - the other voltage unit
      Returns:
      the value of the measurement in terms of this unit