Power (DJUNITS 1.02.01 API)

java.lang.Object
- java.lang.Number
- - org.djunits.value.Scalar<U>
  - - org.djunits.value.vdouble.scalar.DoubleScalar<U>
    - - org.djunits.value.vdouble.scalar.DoubleScalar.Rel<PowerUnit>
      - org.djunits.value.vdouble.scalar.Power

All Implemented Interfaces:

Serializable, Comparable<DoubleScalar.Rel<PowerUnit>>, MathFunctions<DoubleScalar<PowerUnit>>, Relative, Value<PowerUnit>, DoubleMathFunctions<DoubleScalar<PowerUnit>>
```
public class Power
extends DoubleScalar.Rel<PowerUnit>
implements Relative
```
Easy access methods for the Power DoubleScalar, which is relative by definition. An example is Speed. Instead of
DoubleScalar.Rel<PowerUnit> value = new DoubleScalar.Rel<PowerUnit>(100.0, PowerUnit.SI);
we can now write
Power value = new Power(100.0, PowerUnit.SI);
The compiler will automatically recognize which units belong to which quantity, and whether the quantity type and the unit used are compatible.
Copyright (c) 2013-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:45:14 +0200 (Sun, 04 Oct 2015) $, @version $Revision: 85 $, by $Author: averbraeck $, initial version Sep 5, 2015

Author:

Alexander Verbraeck, Peter Knoppers

See Also:

Serialized Form

Nested Class Summary
- Nested classes/interfaces inherited from class org.djunits.value.vdouble.scalar.DoubleScalar
  DoubleScalar.Abs<U extends Unit<U>>, DoubleScalar.Rel<U extends Unit<U>>

Field Summary
- Fields inherited from class org.djunits.value.vdouble.scalar.DoubleScalar.Rel
  si

Constructor Summary

Constructors
Constructor and Description

Power(double value, PowerUnit unit)
Construct Power scalar.

Power(DoubleScalar.Rel<PowerUnit> value)
Construct Power scalar.

Constructors
Constructor and Description
`Power(double value, PowerUnit unit)` Construct Power scalar.
`Power(DoubleScalar.Rel<PowerUnit> value)` Construct Power scalar.

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Power`	`abs()` Set the value(s) to their absolute value.
`Power`	`acos()` Set the value(s) to the arc cosine of the value(s); the resulting angle is in the range 0.0 through pi.
`Power`	`asin()` Set the value(s) to the arc sine of the value(s); the resulting angle is in the range -pi/2 through pi/2.
`Power`	`atan()` Set the value(s) to the arc tangent of the value(s); the resulting angle is in the range -pi/2 through pi/2.
`Power`	`cbrt()` Set the value(s) to the(ir) cube root.
`Power`	`ceil()` Set the value(s) to the smallest (closest to negative infinity) value(s) that are greater than or equal to the argument and equal to a mathematical integer.
`Power`	`cos()` Set the value(s) to the trigonometric cosine of the value(s).
`Power`	`cosh()` Set the value(s) to the hyperbolic cosine of the value(s).
`Power`	`divideBy(double divisor)` Scale the value(s) by the inverse of a factor; i.e.
`ElectricalPotential`	`divideBy(ElectricalCurrent v)` Calculate the division of Power and ElectricalCurrent, which results in a ElectricalPotential scalar.
`ElectricalCurrent`	`divideBy(ElectricalPotential v)` Calculate the division of Power and ElectricalPotential, which results in a ElectricalCurrent scalar.
`Frequency`	`divideBy(Energy v)` Calculate the division of Power and Energy, which results in a Frequency scalar.
`Speed`	`divideBy(Force v)` Calculate the division of Power and Force, which results in a Speed scalar.
`Energy`	`divideBy(Frequency v)` Calculate the division of Power and Frequency, which results in a Energy scalar.
`Dimensionless.Rel`	`divideBy(Power v)` Calculate the division of Power and Power, which results in a Dimensionless scalar.
`Force`	`divideBy(Speed v)` Calculate the division of Power and Speed, which results in a Force scalar.
`Power`	`exp()` Set the value(s) to Euler's number e raised to the power of the value(s).
`Power`	`expm1()` Set the value(s) to Euler's number e raised to the power of the value(s) minus 1 (e^x - 1).
`Power`	`floor()` Set the value(s) to the largest (closest to positive infinity) value(s) that are less than or equal to the argument and equal to a mathematical integer.
`static Power`	`interpolate(Power zero, Power one, double ratio)` Interpolate between two values.
`Power`	`inv()` Set the value(s) to the complement (1.0/x) of the value(s).
`Power`	`log()` Set the value(s) to the natural logarithm (base e) of the value(s).
`Power`	`log10()` Set the value(s) to the base 10 logarithm of the value(s).
`Power`	`log1p()` Set the value(s) to the natural logarithm of the sum of the value(s) and 1.
`Power`	`minus(Power v)` Relative scalar minus Relative scalar = Relative scalar.
`Power`	`multiplyBy(double factor)` Scale the value(s) by a factor.
`Energy`	`multiplyBy(Time.Rel v)` Calculate the multiplication of Power and Time, which results in a Energy scalar.
`Power`	`plus(Power v)` Relative scalar plus Relative scalar = Relative scalar.
`Power`	`pow(double x)` Set the value(s) to the value(s) raised to the power of the argument.
`Power`	`rint()` Set the value(s) to the value(s) that are closest in value to the argument and equal to a mathematical integer.
`Power`	`round()` Set the value(s) to the closest long to the argument with ties rounding up.
`Power`	`signum()` Set the value(s) to the signum function of the value(s); zero if the argument is zero, 1.0 if the argument is greater than zero, -1.0 if the argument is less than zero.
`Power`	`sin()` Set the value(s) to the trigonometric sine of the value(s).
`Power`	`sinh()` Set the value(s) to the hyperbolic sine of the value(s).
`Power`	`sqrt()` Set the value(s) to the correctly rounded positive square root of the value(s).
`Power`	`tan()` Set the value(s) to the trigonometric tangent of the value(s).
`Power`	`tanh()` Set the value(s) to the hyperbolic tangent of the value(s).
`Power`	`toDegrees()` Set the value(s) to approximately equivalent angle(s) measured in degrees.
`Power`	`toRadians()` Set the value(s) to approximately equivalent angle(s) measured in radians.

Methods inherited from class org.djunits.value.vdouble.scalar.DoubleScalar.Rel
compareTo, eq, ge, getSI, gt, le, lt, minus, ne, plus

Methods inherited from class org.djunits.value.vdouble.scalar.DoubleScalar
divide, divide, doubleValue, equals, floatValue, getInUnit, getInUnit, hashCode, interpolate, interpolate, intValue, longValue, minus, minus, minus, multiply, multiply, plus, plus, plus, toString, toString, toString, toString

Methods inherited from class org.djunits.value.Scalar
expressAsSIUnit, expressAsSpecifiedUnit, getUnit, isAbsolute, isRelative

Methods inherited from class java.lang.Number
byteValue, shortValue

Methods inherited from class java.lang.Object
clone, finalize, getClass, notify, notifyAll, wait, wait, wait

- Constructor Detail
  - Power
```
public Power(double value,
             PowerUnit unit)
```
    Construct Power scalar.
    
    Parameters:
    
    value - double value
    
    unit - unit for the double value
  - Power
```
public Power(DoubleScalar.Rel<PowerUnit> value)
```
    Construct Power scalar.
    
    Parameters:
    
    value - Scalar from which to construct this instance
- Method Detail
  - interpolate
```
public static Power interpolate(Power zero,
                                Power one,
                                double ratio)
```
    Interpolate between two values.
    
    Parameters:
    
    zero - the low value
    
    one - the high value
    
    ratio - the ratio between 0 and 1, inclusive
    
    Returns:
    
    a Scalar at the ratio between
  - abs
```
public final Power abs()
```
    Set the value(s) to their absolute value.
    
    Specified by:
    
    abs in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    abs in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - acos
```
public final Power acos()
```
    Set the value(s) to the arc cosine of the value(s); the resulting angle is in the range 0.0 through pi.
    
    Specified by:
    
    acos in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    acos in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - asin
```
public final Power asin()
```
    Set the value(s) to the arc sine of the value(s); the resulting angle is in the range -pi/2 through pi/2.
    
    Specified by:
    
    asin in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    asin in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - atan
```
public final Power atan()
```
    Set the value(s) to the arc tangent of the value(s); the resulting angle is in the range -pi/2 through pi/2.
    
    Specified by:
    
    atan in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    atan in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - cbrt
```
public final Power cbrt()
```
    Set the value(s) to the(ir) cube root.
    
    Specified by:
    
    cbrt in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    cbrt in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - ceil
```
public final Power ceil()
```
    Set the value(s) to the smallest (closest to negative infinity) value(s) that are greater than or equal to the argument and equal to a mathematical integer.
    
    Specified by:
    
    ceil in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    ceil in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - cos
```
public final Power cos()
```
    Set the value(s) to the trigonometric cosine of the value(s).
    
    Specified by:
    
    cos in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    cos in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - cosh
```
public final Power cosh()
```
    Set the value(s) to the hyperbolic cosine of the value(s).
    
    Specified by:
    
    cosh in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    cosh in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - exp
```
public final Power exp()
```
    Set the value(s) to Euler's number e raised to the power of the value(s).
    
    Specified by:
    
    exp in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    exp in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - expm1
```
public final Power expm1()
```
    Set the value(s) to Euler's number e raised to the power of the value(s) minus 1 (e^x - 1).
    
    Specified by:
    
    expm1 in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    expm1 in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - floor
```
public final Power floor()
```
    Set the value(s) to the largest (closest to positive infinity) value(s) that are less than or equal to the argument and equal to a mathematical integer.
    
    Specified by:
    
    floor in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    floor in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - log
```
public final Power log()
```
    Set the value(s) to the natural logarithm (base e) of the value(s).
    
    Specified by:
    
    log in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    log in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - log10
```
public final Power log10()
```
    Set the value(s) to the base 10 logarithm of the value(s).
    
    Specified by:
    
    log10 in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    log10 in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - log1p
```
public final Power log1p()
```
    Set the value(s) to the natural logarithm of the sum of the value(s) and 1.
    
    Specified by:
    
    log1p in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    log1p in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - rint
```
public final Power rint()
```
    Set the value(s) to the value(s) that are closest in value to the argument and equal to a mathematical integer.
    
    Specified by:
    
    rint in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    rint in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - round
```
public final Power round()
```
    Set the value(s) to the closest long to the argument with ties rounding up.
    
    Specified by:
    
    round in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    round in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - signum
```
public final Power signum()
```
    Set the value(s) to the signum function of the value(s); zero if the argument is zero, 1.0 if the argument is greater than zero, -1.0 if the argument is less than zero.
    
    Specified by:
    
    signum in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    signum in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - sin
```
public final Power sin()
```
    Set the value(s) to the trigonometric sine of the value(s).
    
    Specified by:
    
    sin in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    sin in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - sinh
```
public final Power sinh()
```
    Set the value(s) to the hyperbolic sine of the value(s).
    
    Specified by:
    
    sinh in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    sinh in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - sqrt
```
public final Power sqrt()
```
    Set the value(s) to the correctly rounded positive square root of the value(s).
    
    Specified by:
    
    sqrt in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    sqrt in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - tan
```
public final Power tan()
```
    Set the value(s) to the trigonometric tangent of the value(s).
    
    Specified by:
    
    tan in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    tan in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - tanh
```
public final Power tanh()
```
    Set the value(s) to the hyperbolic tangent of the value(s).
    
    Specified by:
    
    tanh in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    tanh in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - inv
```
public final Power inv()
```
    Set the value(s) to the complement (1.0/x) of the value(s).
    
    Specified by:
    
    inv in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    inv in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - toDegrees
```
public final Power toDegrees()
```
    Set the value(s) to approximately equivalent angle(s) measured in degrees.
    
    Specified by:
    
    toDegrees in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    toDegrees in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - toRadians
```
public final Power toRadians()
```
    Set the value(s) to approximately equivalent angle(s) measured in radians.
    
    Specified by:
    
    toRadians in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    toRadians in class DoubleScalar.Rel<PowerUnit>
    
    Returns:
    
    T; the modified T
  - pow
```
public final Power pow(double x)
```
    Set the value(s) to the value(s) raised to the power of the argument.
    
    Specified by:
    
    pow in interface MathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    pow in class DoubleScalar.Rel<PowerUnit>
    
    Parameters:
    
    x - double; the value to use as the power
    
    Returns:
    
    T; the modified T
  - multiplyBy
```
public final Power multiplyBy(double factor)
```
    Scale the value(s) by a factor.
    
    Specified by:
    
    multiplyBy in interface DoubleMathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    multiplyBy in class DoubleScalar.Rel<PowerUnit>
    
    Parameters:
    
    factor - double; the multiplier
    
    Returns:
    
    T; the modified T
  - divideBy
```
public final Power divideBy(double divisor)
```
    Scale the value(s) by the inverse of a factor; i.e. a divisor.
    
    Specified by:
    
    divideBy in interface DoubleMathFunctions<DoubleScalar<PowerUnit>>
    
    Overrides:
    
    divideBy in class DoubleScalar.Rel<PowerUnit>
    
    Parameters:
    
    divisor - double; the divisor
    
    Returns:
    
    T; the modified T
  - plus
```
public final Power plus(Power v)
```
    Relative scalar plus Relative scalar = Relative scalar.
    
    Parameters:
    
    v - the value to add
    
    Returns:
    
    sum of this value and v as a new object
  - minus
```
public final Power minus(Power v)
```
    Relative scalar minus Relative scalar = Relative scalar.
    
    Parameters:
    
    v - the value to subtract
    
    Returns:
    
    difference of this value and v as a new object
  - divideBy
```
public final Dimensionless.Rel divideBy(Power v)
```
    Calculate the division of Power and Power, which results in a Dimensionless scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Dimensionless scalar as a division of Power and Power
  - multiplyBy
```
public final Energy multiplyBy(Time.Rel v)
```
    Calculate the multiplication of Power and Time, which results in a Energy scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Energy scalar as a multiplication of Power and Time
  - divideBy
```
public final Energy divideBy(Frequency v)
```
    Calculate the division of Power and Frequency, which results in a Energy scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Energy scalar as a division of Power and Frequency
  - divideBy
```
public final Frequency divideBy(Energy v)
```
    Calculate the division of Power and Energy, which results in a Frequency scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Frequency scalar as a division of Power and Energy
  - divideBy
```
public final Force divideBy(Speed v)
```
    Calculate the division of Power and Speed, which results in a Force scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Force scalar as a division of Power and Speed
  - divideBy
```
public final Speed divideBy(Force v)
```
    Calculate the division of Power and Force, which results in a Speed scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    Speed scalar as a division of Power and Force
  - divideBy
```
public final ElectricalCurrent divideBy(ElectricalPotential v)
```
    Calculate the division of Power and ElectricalPotential, which results in a ElectricalCurrent scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    ElectricalCurrent scalar as a division of Power and ElectricalPotential
  - divideBy
```
public final ElectricalPotential divideBy(ElectricalCurrent v)
```
    Calculate the division of Power and ElectricalCurrent, which results in a ElectricalPotential scalar.
    
    Parameters:
    
    v - Power scalar
    
    Returns:
    
    ElectricalPotential scalar as a division of Power and ElectricalCurrent

Class Power

Nested Class Summary

Nested classes/interfaces inherited from class org.djunits.value.vdouble.scalar.DoubleScalar

Field Summary

Fields inherited from class org.djunits.value.vdouble.scalar.DoubleScalar.Rel

Constructor Summary

Method Summary

Methods inherited from class org.djunits.value.vdouble.scalar.DoubleScalar.Rel

Methods inherited from class org.djunits.value.vdouble.scalar.DoubleScalar

Methods inherited from class org.djunits.value.Scalar

Methods inherited from class java.lang.Number

Methods inherited from class java.lang.Object

Constructor Detail

Power

Power

Method Detail

interpolate

abs

acos

asin

atan

cbrt

ceil

cos

cosh

exp

expm1

floor

log

log10

log1p

rint

round

signum

sin

sinh

sqrt

tan

tanh

inv

toDegrees

toRadians

pow

multiplyBy

divideBy

plus

minus

divideBy

multiplyBy

divideBy

divideBy

divideBy

divideBy

divideBy

divideBy