Maths (mathz 0.0.4 API)

java.lang.Object
- mikera.util.Maths

```
public final class Maths
extends Object
```
Helpful maths functions Focus on using floats rather than doubles for speed

Author:

Mike

Field Summary

Fields
Modifier and Type	Field and Description
`static double`	`E` mathematical constant e
`static double`	`HALF_PI`
`static double`	`PI` Mathematical constant Pi = 3.1415926...
`static double`	`QUARTER_PI`
`static double`	`ROOT_THREE`
`static double`	`ROOT_TWO`
`static double`	`TAU` Mathematical constant Tau = 2 * Pi
`static double`	`TWO_PI`

Constructor Summary

Constructors
Constructor and Description

Maths()

Constructors
Constructor and Description
`Maths()`

Method Summary

Methods
Modifier and Type	Method and Description
`static double`	`bound(double v, double min, double max)` Bound a value within a given range
`static float`	`bound(float v, float min, float max)` Bound a value within a given range
`static int`	`bound(int v, int min, int max)` Bound a value within a given range
`static int`	`clampToInteger(double value, int min, int max)` Clamp a double value to an integer range
`static int`	`clampToInteger(float value, int min, int max)` Clamp a float value to an integer range
`static double`	`frac(double a)` Return the (always non-negative) fractional part of a number
`static float`	`frac(float a)` Return the (always non-negative) fractional part of a number
`static float`	`inverseSigmoid(float a)`
`static double`	`max(double a, double b, double c)` Return the maximum of three values
`static float`	`max(float a, float b)` Return the maximum of two numbers
`static float`	`max(float a, float b, float c)` Return the maximum of three values
`static float`	`max(float a, float b, float c, float d)` Return the maximum of four values
`static int`	`max(int a, int b)` Return the maximum of two numbers
`static int`	`max(int a, int b, int c)` Return the maximum of three numbers
`static float`	`middle(float a, float b, float c)` Return the middle value of 3 numbers Can use faster "bound" method if first and last parameters are in order
`static int`	`middle(int a, int b, int c)` Return the middle value of 3 numbers Can use faster "bound" method if first and last parameters are in order
`static double`	`min(double a, double b, double c)` Return the minimum of three values
`static float`	`min(float a, float b)` Return the minimum of two numbers
`static float`	`min(float a, float b, float c)` Return the minimum of three values
`static float`	`min(float a, float b, float c, float d)` Return the minimum of four values
`static int`	`min(int a, int b)` Return the minimum of two numbers
`static int`	`min(int a, int b, int c)` Return the minimum of three numbers
`static double`	`mod(double num, double div)` Double mod function with fractional divisor
`static int`	`mod(int number, int divisor)` Integer modulus function
`static boolean`	`notNearZero(double d)` Tests whether a value is near zero, to a default tolerance level
`static long`	`quantize(long increase, long boundary, long base)` Detects the number of times that boundary is passed when adding increase to base
`static int`	`roundDown(double a)` Rounds down (integer floor) of a double value
`static int`	`roundDown(float a)` Round down to next smallest integer (towards negative infinity)
`static int`	`roundUp(double d)` Round up to next integer
`static int`	`roundUp(float d)` Round up to next integer
`static int`	`roundUp(Number d)` Round up to next integer
`static double`	`sigmoid(double a)`
`static float`	`sigmoid(float a)`
`static float`	`sigmoidDerivative(float a)`
`static int`	`sign(double a)` Return the sign of a double value
`static int`	`sign(float a)` Return the sign of a float value
`static int`	`sign(int a)` Return the sign of an int value
`static int`	`sign(long a)` Return the sign of a long value
`static int`	`sign2(int a)` Mike's fast integer sign algorithm
`static double`	`softMaximum(double x, double y)` Soft maximum function
`static double`	`softplus(double a)`
`static double`	`sqrt(double a)`
`static float`	`sqrt(float a)`
`static int`	`square(byte b)` Return the square of a number
`static double`	`square(double x)` Return the square of a number
`static float`	`square(float x)` Return the square of a number
`static int`	`square(int x)` Return the square of a number
`static double`	`tanh(double a)`
`static float`	`tanh(float a)`
`static float`	`tanhDerivative(float a)`
`static double`	`tanhScaled(double a)`
`static double`	`tanhScaledDerivative(double a)`
`static double`	`triangleWave(double a)` Triangle wave with wavelength 1.0, and range 0.0 - 1.0

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

Field Detail
- ROOT_TWO
```
public static final double ROOT_TWO
```
- ROOT_THREE
```
public static final double ROOT_THREE
```
- E
```
public static final double E
```
  mathematical constant e
  
  See Also:
  Constant Field Values
- PI
```
public static final double PI
```
  Mathematical constant Pi = 3.1415926...
  
  See Also:
  Constant Field Values
- TWO_PI
```
public static final double TWO_PI
```
  See Also:
  Constant Field Values
- TAU
```
public static final double TAU
```
  Mathematical constant Tau = 2 * Pi
  
  See Also:
  Constant Field Values
- HALF_PI
```
public static final double HALF_PI
```
  See Also:
  Constant Field Values
- QUARTER_PI
```
public static final double QUARTER_PI
```
  See Also:
  Constant Field Values

Constructor Detail
- Maths
```
public Maths()
```

Method Detail

sqrt
```
public static float sqrt(float a)
```

sqrt
```
public static double sqrt(double a)
```

clampToInteger

public static int clampToInteger(double value,
                 int min,
                 int max)

Clamp a double value to an integer range

clampToInteger

public static int clampToInteger(float value,
                 int min,
                 int max)

Clamp a float value to an integer range

middle
```
public static int middle(int a,
         int b,
         int c)
```
Return the middle value of 3 numbers Can use faster "bound" method if first and last parameters are in order

middle
```
public static float middle(float a,
           float b,
           float c)
```
Return the middle value of 3 numbers Can use faster "bound" method if first and last parameters are in order

sign
```
public static int sign(double a)
```
Return the sign of a double value

sign
```
public static int sign(float a)
```
Return the sign of a float value

sign
```
public static final int sign(int a)
```
Return the sign of an int value

sign2
```
public static final int sign2(int a)
```
Mike's fast integer sign algorithm

Parameters:
a -

Returns:
Sign of the given number (-1, 0 or 1)

sign
```
public static int sign(long a)
```
Return the sign of a long value

mod
```
public static int mod(int number,
      int divisor)
```
Integer modulus function

Parameters:
n - number
d - divisor

Returns:

quantize
```
public static long quantize(long increase,
            long boundary,
            long base)
```
Detects the number of times that boundary is passed when adding increase to base

Parameters:
increase -
boundary -
base -

Returns:

min

public static double min(double a,
         double b,
         double c)

Return the minimum of three values

max

public static double max(double a,
         double b,
         double c)

Return the maximum of three values

min

public static float min(float a,
        float b,
        float c)

Return the minimum of three values

max

public static float max(float a,
        float b,
        float c)

Return the maximum of three values

min

public static final float min(float a,
        float b,
        float c,
        float d)

Return the minimum of four values

max

public static final float max(float a,
        float b,
        float c,
        float d)

Return the maximum of four values

min

public static int min(int a,
      int b)

Return the minimum of two numbers

max

public static int max(int a,
      int b)

Return the maximum of two numbers

min

public static float min(float a,
        float b)

Return the minimum of two numbers

max

public static float max(float a,
        float b)

Return the maximum of two numbers

min

public static int min(int a,
      int b,
      int c)

Return the minimum of three numbers

max

public static int max(int a,
      int b,
      int c)

Return the maximum of three numbers

sigmoid
```
public static float sigmoid(float a)
```

sigmoid

public static double sigmoid(double a)

softplus

public static double softplus(double a)

tanh
```
public static float tanh(float a)
```

tanh
```
public static double tanh(double a)
```

tanhScaled

public static double tanhScaled(double a)

tanhScaledDerivative

public static double tanhScaledDerivative(double a)

inverseSigmoid

public static float inverseSigmoid(float a)

sigmoidDerivative

public static float sigmoidDerivative(float a)

tanhDerivative

public static float tanhDerivative(float a)

frac
```
public static float frac(float a)
```
Return the (always non-negative) fractional part of a number

frac
```
public static double frac(double a)
```
Return the (always non-negative) fractional part of a number

square
```
public static int square(byte b)
```
Return the square of a number

square
```
public static int square(int x)
```
Return the square of a number

square
```
public static float square(float x)
```
Return the square of a number

square

public static double square(double x)

Return the square of a number

roundUp
```
public static int roundUp(double d)
```
Round up to next integer

roundUp
```
public static int roundUp(Number d)
```
Round up to next integer

roundUp
```
public static int roundUp(float d)
```
Round up to next integer

roundDown
```
public static int roundDown(double a)
```
Rounds down (integer floor) of a double value

roundDown
```
public static int roundDown(float a)
```
Round down to next smallest integer (towards negative infinity)

softMaximum

public static double softMaximum(double x,
                 double y)

Soft maximum function

bound

public static final double bound(double v,
           double min,
           double max)

Bound a value within a given range

bound

public static final float bound(float v,
          float min,
          float max)

Bound a value within a given range

bound

public static final int bound(int v,
        int min,
        int max)

Bound a value within a given range

notNearZero
```
public static boolean notNearZero(double d)
```
Tests whether a value is near zero, to a default tolerance level

mod

public static double mod(double num,
         double div)

Double mod function with fractional divisor

triangleWave
```
public static double triangleWave(double a)
```
Triangle wave with wavelength 1.0, and range 0.0 - 1.0

Class Maths

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ROOT_TWO

ROOT_THREE

E

PI

TWO_PI

TAU

HALF_PI

QUARTER_PI

Constructor Detail

Maths

Method Detail

sqrt

sqrt

clampToInteger

clampToInteger

middle

middle

sign

sign

sign

sign2

sign

mod

quantize

min

max

min

max

min

max

min

max

min

max

min

max

sigmoid

sigmoid

softplus

tanh

tanh

tanhScaled

tanhScaledDerivative

inverseSigmoid

sigmoidDerivative

tanhDerivative

frac

frac

square

square

square

square

roundUp

roundUp

roundUp

roundDown

roundDown

softMaximum

bound

bound

bound

notNearZero

mod

triangleWave