math

The math module provides mathematical functions and constants.

Import

import math
import { sqrt, sin, cos, pi } from math

Constants

@math#PI           @// 3.14159265358979
@math#E            @// 2.71828182845905
@math#TAU          @// 6.28318530717959
@math#PHI          @// 1.61803398874989
@math#LN2          @// 0.693147180559945
@math#LN10         @// 2.30258509299405
@math#SQRT2        @// 1.41421356237310
@math#EPSILON      @// Smallest positive Float
@math#MAX_FLOAT    @// Maximum Float value
@math#MIN_FLOAT    @// Minimum Float value
@math#MAX_INT      @// Maximum Int value
@math#MIN_INT      @// Minimum Int value

Basic Operations

abs

Absolute value:

@math#abs(-5)       @// 5
@math#abs(-3.14)    @// 3.14

min

Minimum of two values:

@math#min(10, 20)   @// 10
@math#min(3.14, 2.71) @// 2.71

max

Maximum of two values:

@math#max(10, 20)   @// 20

clamp

Clamp value between min and max:

@math#clamp(150, 0, 100)  @// 100
@math#clamp(-10, 0, 100)  @// 0
@math#clamp(50, 0, 100)   @// 50

sign

Sign of a number:

@math#sign(-5)   @// -1
@math#sign(0)    @// 0
@math#sign(5)    @// 1

Power Functions

sqrt

Square root:

@math#sqrt(144)   @// 12.0
@math#sqrt(2)     @// 1.41421356237310

cbrt

Cube root:

@math#cbrt(27)    @// 3.0

pow

Power function:

@math#pow(2, 10)   @// 1024.0
@math#pow(27, 1/3) @// 3.0

exp

Exponential function (e^x):

@math#exp(1)    @// 2.71828182845905
@math#exp(0)    @// 1.0

pow10

Power of 10:

@math#pow10(3)  @// 1000.0

Logarithmic Functions

ln

Natural logarithm:

@math#ln(@math#E)  @// 1.0

log2

Base-2 logarithm:

@math#log2(1024)  @// 10.0

log10

Base-10 logarithm:

@math#log10(1000)  @// 3.0

log

Logarithm with arbitrary base:

@math#log(8, 2)  @// 3.0

Trigonometric Functions

sin

Sine (radians):

@math#sin(0)              @// 0.0
@math#sin(@math#PI / 2)   @// 1.0

cos

Cosine (radians):

@math#cos(0)     @// 1.0
@math#cos(@math#PI)  @// -1.0

tan

Tangent (radians):

@math#tan(0)  @// 0.0

asin

Arc sine:

@math#asin(1)  @// 1.57079632679490 (PI/2)

acos

Arc cosine:

@math#acos(1)  @// 0.0

atan

Arc tangent:

@math#atan(1)  @// 0.78539816339745 (PI/4)

atan2

Two-argument arc tangent:

@math#atan2(1, 1)  @// 0.78539816339745 (PI/4)

Hyperbolic Functions

sinh

Hyperbolic sine:

@math#sinh(0)  @// 0.0

cosh

Hyperbolic cosine:

@math#cosh(0)  @// 1.0

tanh

Hyperbolic tangent:

@math#tanh(0)  @// 0.0

Angle Conversion

to_radians

Degrees to radians:

@math#to_radians(180)  @// 3.14159265358979

to_degrees

Radians to degrees:

@math#to_degrees(@math#PI)  @// 180.0

Rounding Functions

floor

Round down:

@math#floor(3.7)  @// 3.0
@math#floor(-3.2) @// -4.0

ceil

Round up:

@math#ceil(3.2)   @// 4.0
@math#ceil(-3.7)  @// -3.0

round

Round to nearest:

@math#round(3.5)  @// 4.0
@math#round(3.4)  @// 3.0

truncate

Remove fractional part:

@math#truncate(3.7)   @// 3.0
@math#truncate(-3.7)  @// -3.0

fract

Fractional part:

@math#fract(3.7)   @// 0.7
@math#fract(-3.7)  @// -0.7

Comparison

is_nan

Check for NaN:

@math#is_nan(@math#sqrt(-1))  @// true

is_infinite

Check for infinity:

@math#is_infinite(1.0 / 0.0)  @// true

is_finite

Check for finite number:

@math#is_finite(42.0)  @// true

Interpolation

lerp

Linear interpolation:

@math#lerp(0, 100, 0.5)  @// 50.0
@math#lerp(0, 100, 0.0)  @// 0.0
@math#lerp(0, 100, 1.0)  @// 100.0

inverse_lerp

Inverse linear interpolation:

@math#inverse_lerp(0, 100, 50)  @// 0.5

smoothstep

Smooth Hermite interpolation:

@math#smoothstep(0, 100, 50)  @// 0.5

Random Numbers

random

Random float between 0 and 1:

@math#random()  @// e.g., 0.753213

random_range

Random number in range:

@math#random_range(1, 100)  @// Random Int between 1 and 100
@math#random_range(0.0, 1.0)  @// Random Float

random_int

Random integer:

@math#random_int(1, 6)  @// Dice roll

random_float

Random float:

@math#random_float(0.0, 1.0)

random_bool

Random boolean:

@math#random_bool()  @// true or false

random_pick

Pick random element from array:

@math#random_pick([1, 2, 3, 4, 5])

shuffle

Shuffle array randomly:

@shuffled = @math#shuffle([1, 2, 3, 4, 5])

set_seed

Set random seed for reproducibility:

@math#set_seed(42)

Statistics

mean

Arithmetic mean:

@math#mean([1, 2, 3, 4, 5])  @// 3.0

median

Median value:

@math#median([1, 2, 3, 4, 5])  @// 3.0

mode

Most frequent value:

@math#mode([1, 2, 2, 3, 3, 3])  @// 3

variance

Population variance:

@math#variance([1, 2, 3, 4, 5])  @// 2.0

std_dev

Standard deviation:

@math#std_dev([1, 2, 3, 4, 5])  @// 1.41421356237310

Number Theory

gcd

Greatest common divisor:

@math#gcd(12, 8)  @// 4

lcm

Least common multiple:

@math#lcm(12, 8)  @// 24

factorial

Factorial:

@math#factorial(5)  @// 120

fibonacci

Fibonacci number:

@math#fibonacci(10)  @// 55

is_prime

Prime check:

@math#is_prime(17)  @// true
@math#is_prime(15)  @// false

next_prime

Next prime number:

@math#next_prime(14)  @// 17