Energy (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<EnergyUnit>
      - org.djunits.value.vdouble.scalar.Energy

All Implemented Interfaces:

Serializable, Comparable<DoubleScalar.Rel<EnergyUnit>>, MathFunctions<DoubleScalar<EnergyUnit>>, Relative, Value<EnergyUnit>, DoubleMathFunctions<DoubleScalar<EnergyUnit>>
```
public class Energy
extends DoubleScalar.Rel<EnergyUnit>
implements Relative
```
Easy access methods for the Energy DoubleScalar, which is relative by definition. An example is Speed. Instead of
DoubleScalar.Rel<EnergyUnit> value = new DoubleScalar.Rel<EnergyUnit>(100.0, EnergyUnit.SI);
we can now write
Energy value = new Energy(100.0, EnergyUnit.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

Energy(double value, EnergyUnit unit)
Construct Energy scalar.

Energy(DoubleScalar.Rel<EnergyUnit> value)
Construct Energy scalar.

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

Method Summary

All Methods Static Methods Instance Methods Concrete Methods
Modifier and Type	Method and Description
`Energy`	`abs()` Set the value(s) to their absolute value.
`Energy`	`acos()` Set the value(s) to the arc cosine of the value(s); the resulting angle is in the range 0.0 through pi.
`Energy`	`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.
`Energy`	`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.
`Energy`	`cbrt()` Set the value(s) to the(ir) cube root.
`Energy`	`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.
`Energy`	`cos()` Set the value(s) to the trigonometric cosine of the value(s).
`Energy`	`cosh()` Set the value(s) to the hyperbolic cosine of the value(s).
`Energy`	`divideBy(double divisor)` Scale the value(s) by the inverse of a factor; i.e.
`Dimensionless.Rel`	`divideBy(Energy v)` Calculate the division of Energy and Energy, which results in a Dimensionless scalar.
`Length.Rel`	`divideBy(Force v)` Calculate the division of Energy and Force, which results in a Length scalar.
`Force`	`divideBy(Length.Rel v)` Calculate the division of Energy and Length, which results in a Force scalar.
`Time.Rel`	`divideBy(Power v)` Calculate the division of Energy and Power, which results in a Time scalar.
`Power`	`divideBy(Time.Rel v)` Calculate the division of Energy and Time, which results in a Power scalar.
`Pressure`	`divideBy(Volume v)` Calculate the division of Energy and Volume, which results in a Pressure scalar.
`Energy`	`exp()` Set the value(s) to Euler's number e raised to the power of the value(s).
`Energy`	`expm1()` Set the value(s) to Euler's number e raised to the power of the value(s) minus 1 (e^x - 1).
`Energy`	`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 Energy`	`interpolate(Energy zero, Energy one, double ratio)` Interpolate between two values.
`Energy`	`inv()` Set the value(s) to the complement (1.0/x) of the value(s).
`Energy`	`log()` Set the value(s) to the natural logarithm (base e) of the value(s).
`Energy`	`log10()` Set the value(s) to the base 10 logarithm of the value(s).
`Energy`	`log1p()` Set the value(s) to the natural logarithm of the sum of the value(s) and 1.
`Energy`	`minus(Energy v)` Relative scalar minus Relative scalar = Relative scalar.
`Energy`	`multiplyBy(double factor)` Scale the value(s) by a factor.
`Power`	`multiplyBy(Frequency v)` Calculate the multiplication of Energy and Frequency, which results in a Power scalar.
`Force`	`multiplyBy(LinearDensity v)` Calculate the multiplication of Energy and LinearDensity, which results in a Force scalar.
`Money`	`multiplyBy(MoneyPerEnergy v)` Calculate the multiplication of Energy and MoneyPerEnergy, which results in a Money scalar.
`Energy`	`plus(Energy v)` Relative scalar plus Relative scalar = Relative scalar.
`Energy`	`pow(double x)` Set the value(s) to the value(s) raised to the power of the argument.
`Energy`	`rint()` Set the value(s) to the value(s) that are closest in value to the argument and equal to a mathematical integer.
`Energy`	`round()` Set the value(s) to the closest long to the argument with ties rounding up.
`Energy`	`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.
`Energy`	`sin()` Set the value(s) to the trigonometric sine of the value(s).
`Energy`	`sinh()` Set the value(s) to the hyperbolic sine of the value(s).
`Energy`	`sqrt()` Set the value(s) to the correctly rounded positive square root of the value(s).
`Energy`	`tan()` Set the value(s) to the trigonometric tangent of the value(s).
`Energy`	`tanh()` Set the value(s) to the hyperbolic tangent of the value(s).
`Energy`	`toDegrees()` Set the value(s) to approximately equivalent angle(s) measured in degrees.
`Energy`	`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
  - Energy
```
public Energy(double value,
              EnergyUnit unit)
```
    Construct Energy scalar.
    
    Parameters:
    
    value - double value
    
    unit - unit for the double value
  - Energy
```
public Energy(DoubleScalar.Rel<EnergyUnit> value)
```
    Construct Energy scalar.
    
    Parameters:
    
    value - Scalar from which to construct this instance
- Method Detail
  - interpolate
```
public static Energy interpolate(Energy zero,
                                 Energy 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 Energy abs()
```
    Set the value(s) to their absolute value.
    
    Specified by:
    
    abs in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    abs in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - acos
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    acos in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - asin
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    asin in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - atan
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    atan in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - cbrt
```
public final Energy cbrt()
```
    Set the value(s) to the(ir) cube root.
    
    Specified by:
    
    cbrt in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    cbrt in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - ceil
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    ceil in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - cos
```
public final Energy cos()
```
    Set the value(s) to the trigonometric cosine of the value(s).
    
    Specified by:
    
    cos in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    cos in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - cosh
```
public final Energy cosh()
```
    Set the value(s) to the hyperbolic cosine of the value(s).
    
    Specified by:
    
    cosh in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    cosh in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - exp
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    exp in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - expm1
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    expm1 in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - floor
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    floor in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - log
```
public final Energy log()
```
    Set the value(s) to the natural logarithm (base e) of the value(s).
    
    Specified by:
    
    log in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    log in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - log10
```
public final Energy log10()
```
    Set the value(s) to the base 10 logarithm of the value(s).
    
    Specified by:
    
    log10 in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    log10 in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - log1p
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    log1p in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - rint
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    rint in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - round
```
public final Energy round()
```
    Set the value(s) to the closest long to the argument with ties rounding up.
    
    Specified by:
    
    round in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    round in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - signum
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    signum in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - sin
```
public final Energy sin()
```
    Set the value(s) to the trigonometric sine of the value(s).
    
    Specified by:
    
    sin in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    sin in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - sinh
```
public final Energy sinh()
```
    Set the value(s) to the hyperbolic sine of the value(s).
    
    Specified by:
    
    sinh in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    sinh in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - sqrt
```
public final Energy sqrt()
```
    Set the value(s) to the correctly rounded positive square root of the value(s).
    
    Specified by:
    
    sqrt in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    sqrt in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - tan
```
public final Energy tan()
```
    Set the value(s) to the trigonometric tangent of the value(s).
    
    Specified by:
    
    tan in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    tan in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - tanh
```
public final Energy tanh()
```
    Set the value(s) to the hyperbolic tangent of the value(s).
    
    Specified by:
    
    tanh in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    tanh in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - inv
```
public final Energy inv()
```
    Set the value(s) to the complement (1.0/x) of the value(s).
    
    Specified by:
    
    inv in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    inv in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - toDegrees
```
public final Energy toDegrees()
```
    Set the value(s) to approximately equivalent angle(s) measured in degrees.
    
    Specified by:
    
    toDegrees in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    toDegrees in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - toRadians
```
public final Energy toRadians()
```
    Set the value(s) to approximately equivalent angle(s) measured in radians.
    
    Specified by:
    
    toRadians in interface MathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    toRadians in class DoubleScalar.Rel<EnergyUnit>
    
    Returns:
    
    T; the modified T
  - pow
```
public final Energy 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<EnergyUnit>>
    
    Overrides:
    
    pow in class DoubleScalar.Rel<EnergyUnit>
    
    Parameters:
    
    x - double; the value to use as the power
    
    Returns:
    
    T; the modified T
  - multiplyBy
```
public final Energy multiplyBy(double factor)
```
    Scale the value(s) by a factor.
    
    Specified by:
    
    multiplyBy in interface DoubleMathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    multiplyBy in class DoubleScalar.Rel<EnergyUnit>
    
    Parameters:
    
    factor - double; the multiplier
    
    Returns:
    
    T; the modified T
  - divideBy
```
public final Energy divideBy(double divisor)
```
    Scale the value(s) by the inverse of a factor; i.e. a divisor.
    
    Specified by:
    
    divideBy in interface DoubleMathFunctions<DoubleScalar<EnergyUnit>>
    
    Overrides:
    
    divideBy in class DoubleScalar.Rel<EnergyUnit>
    
    Parameters:
    
    divisor - double; the divisor
    
    Returns:
    
    T; the modified T
  - plus
```
public final Energy plus(Energy 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 Energy minus(Energy 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(Energy v)
```
    Calculate the division of Energy and Energy, which results in a Dimensionless scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Dimensionless scalar as a division of Energy and Energy
  - divideBy
```
public final Length.Rel divideBy(Force v)
```
    Calculate the division of Energy and Force, which results in a Length scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Length scalar as a division of Energy and Force
  - divideBy
```
public final Force divideBy(Length.Rel v)
```
    Calculate the division of Energy and Length, which results in a Force scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Force scalar as a division of Energy and Length
  - multiplyBy
```
public final Force multiplyBy(LinearDensity v)
```
    Calculate the multiplication of Energy and LinearDensity, which results in a Force scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Force scalar as a multiplication of Energy and LinearDensity
  - divideBy
```
public final Power divideBy(Time.Rel v)
```
    Calculate the division of Energy and Time, which results in a Power scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Power scalar as a division of Energy and Time
  - divideBy
```
public final Time.Rel divideBy(Power v)
```
    Calculate the division of Energy and Power, which results in a Time scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Time scalar as a division of Energy and Power
  - divideBy
```
public final Pressure divideBy(Volume v)
```
    Calculate the division of Energy and Volume, which results in a Pressure scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Pressure scalar as a division of Energy and Volume
  - multiplyBy
```
public final Power multiplyBy(Frequency v)
```
    Calculate the multiplication of Energy and Frequency, which results in a Power scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Power scalar as a multiplication of Energy and Frequency
  - multiplyBy
```
public final Money multiplyBy(MoneyPerEnergy v)
```
    Calculate the multiplication of Energy and MoneyPerEnergy, which results in a Money scalar.
    
    Parameters:
    
    v - Energy scalar
    
    Returns:
    
    Money scalar as a multiplication of Energy and MoneyPerEnergy

Class Energy

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

Energy

Energy

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

divideBy

divideBy

multiplyBy

divideBy

divideBy

divideBy

multiplyBy

multiplyBy