# math

## math() Function

Introduced in version 1.4.0.5
This is NOT a single MapTool function but a collection of math functions in MapTool. Important Note: Most of these functions return a floating-point number (e.g.: `3.0`).

### Usage

```Numbers:
[r:val = math.pi()]
[r:val = math.e()]

Trigonomotry:
[r:val = math.acos(degrees)]
[r:val = math.asin(degrees)]
[r:val = math.atan(degrees)]
[r:val = math.atan2(degrees)]
[r:val = math.cos(degrees)]
[r:val = math.cos_r(num)]
[r:val = math.sin(degrees)]
[r:val = math.sin_r(num)]
[r:val = math.tan(degrees)]
[r:val = math.tan_r(num)]
[r:val = math.toDegrees(num)]

Power and root:
[r:val = math.sqrt(num)]
[r:val = math.squareroot(num)]
[r:val = math.cbrt(num)]
[r:val = math.cuberoot(num)]
[r:val = math.pow(num1,num2)]

Logarithmic
[r:val = math.log(num)] (this is the log to base e)
[r:val = math.log10(num)]

Pythagorean:
[r:val = math.hypot(num1, num2)]
[r:val = math.hypotenuse(num1, num2)]

Simple operations
[r:val = math.abs(num)]
[r:val = math.ceil(num)]
[r:val = math.floor(num)]
[r:val = math.isEven(num)]
[r:val = math.isInt(num)]
[r:val = math.isOdd(num)]
[r:val = math.max(num1, num2, num2, etc.)]
[r:val = math.min(num1, num2, num2, etc.)]
[r:val = math.mod(dividend, divisor)]```

### Examples

#### abs

`[r:val =  math.abs(-3)]`

Returns: 3.0

#### mod

Returns the result of the modulo operation between the two numbers, which represents the remainder after a division operation.

`[r: math.mod(14,6)]`

Returns 2

`[r: math.mod(10,5)]`

Returns 0

`[r: math.mod(-13,4)`

Returns -1

#### pow

`[r:val =  math.pow(2,3)]`
Returns: 8.0