Area (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<AreaUnit>
      - org.djunits.value.vdouble.scalar.Area

All Implemented Interfaces:

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

Area(double value, AreaUnit unit)
Construct Area scalar.

Area(DoubleScalar.Rel<AreaUnit> value)
Construct Area scalar.

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

Method Summary

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

Class Area

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

Area

Area

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

multiplyBy

multiplyBy

multiplyBy

multiplyBy