Funciones
Todas las funciones de tyrus:math operan en f64 salvo indicación contraria y se emiten como llamadas nativas directas.
Básicas y signos
| Función | Firma | Descripción |
|---|---|---|
abs | (x: f64) => f64 | Valor absoluto |
sign | (x: f64) => f64 | Signo (1, -1 o 0) |
sqrt | (x: f64) => f64 | Raíz cuadrada |
cbrt | (x: f64) => f64 | Raíz cúbica |
Redondeo
| Función | Firma | Descripción |
|---|---|---|
floor | (x: f64) => f64 | Redondea hacia abajo |
ceil | (x: f64) => f64 | Redondea hacia arriba |
trunc | (x: f64) => f64 | Trunca hacia cero |
round | (x: f64) => f64 | Redondea al entero más cercano |
roundTo | (x: f64, decimals: i32) => f64 | Redondea a N decimales |
Trigonometría
| Función | Firma | Descripción |
|---|---|---|
sin | (x: f64) => f64 | Seno |
cos | (x: f64) => f64 | Coseno |
tan | (x: f64) => f64 | Tangente |
asin | (x: f64) => f64 | Arco seno |
acos | (x: f64) => f64 | Arco coseno |
atan | (x: f64) => f64 | Arco tangente |
atan2 | (y: f64, x: f64) => f64 | Arco tangente de y/x |
degToRad | (degrees: f64) => f64 | Convierte grados a radianes |
radToDeg | (radians: f64) => f64 | Convierte radianes a grados |
Hiperbólicas
| Función | Firma | Descripción |
|---|---|---|
sinh | (x: f64) => f64 | Seno hiperbólico |
cosh | (x: f64) => f64 | Coseno hiperbólico |
tanh | (x: f64) => f64 | Tangente hiperbólica |
Exponenciales y logaritmos
| Función | Firma | Descripción |
|---|---|---|
exp | (x: f64) => f64 | e^x |
log | (x: f64) => f64 | Logaritmo natural |
log10 | (x: f64) => f64 | Logaritmo base 10 |
log2 | (x: f64) => f64 | Logaritmo base 2 |
pow | (base: f64, exp: f64) => f64 | Potencia |
Selección y bajo nivel
| Función | Firma | Descripción |
|---|---|---|
max | (a: f64, b: f64) => f64 | Máximo |
min | (a: f64, b: f64) => f64 | Mínimo |
clamp | (value: f64, min: f64, max: f64) => f64 | Limita valor al intervalo |
clampMin | (value: f64, min: f64) => f64 | Garantiza valor mínimo |
clampMax | (value: f64, max: f64) => f64 | Garantiza valor máximo |
imul | (a: i32, b: i32) => i32 | Multiplicación C-style 32-bit |
clz32 | (x: i32) => i32 | Cuenta bits cero a la izquierda en entero 32-bit |
Utilidades avanzadas
| Función | Firma | Descripción |
|---|---|---|
approxEqual | (a: f64, b: f64, tolerance?: f64) => boolean | Compara floats dentro de la tolerancia |
lerp | (start: f64, end: f64, amount: f64) => f64 | Interpolación lineal |
inverseLerp | (start: f64, end: f64, value: f64) => f64 | Interpolación lineal inversa |
remap | (value: f64, inMin: f64, inMax: f64, outMin: f64, outMax: f64) => f64 | Remapea valor entre escalas |
smoothstep | (edge0: f64, edge1: f64, x: f64) => f64 | Interpolación suave de Hermite |
gcd | (a: u32, b: u32) => u32 | Máximo divisor común |
lcm | (a: u32, b: u32) => u32 | Mínimo múltiplo común |
randomRange | (min: f64, max: f64) => f64 | Float aleatorio en el intervalo semiabierto |
Estadística y combinatoria
| Función | Firma | Descripción |
|---|---|---|
mean | (values: f64[]) => f64 | Media aritmética; 0.0 para array vacía |
median | (values: f64[]) => f64 | Mediana; 0.0 para array vacía |
mode | (values: f64[]) => f64 | Valor más frecuente; 0.0 para array vacía |
variance | (values: f64[]) => f64 | Varianza poblacional; 0.0 para array vacía |
stdDev | (values: f64[]) => f64 | Desviación estándar poblacional; 0.0 para array vacía |
percentile | (p: f64, values: f64[]) => f64 | Percentil p (0-100) con interpolación lineal; 0.0 para array vacía |
factorial | (n: u128) => u128 | n! |
permutation | (n: u128, k: u128) => u128 | n! / (n - k)! |
combination | (n: u128, k: u128) => u128 | n! / (k! * (n - k)!) |
Teoría de números
| Función | Firma | Descripción |
|---|---|---|
isPrime | (n: u64) => boolean | true si n es primo |
nextPrime | (n: u64) => u64 | Menor primo estrictamente mayor que n |
primeFactors | (n: u64) => u64[] | Factores primos de n |
fibonacci | (n: u64) => u64 | n-ésimo número de Fibonacci |
Geometría y utilidades numéricas
| Función | Firma | Descripción |
|---|---|---|
hypot | (x: f64, y: f64) => f64 | Norma Euclidiana sqrt(x^2 + y^2) |
toPolar | (x: f64, y: f64) => [f64, f64] | Convierte Cartesianas a polares (r, theta) |
toCartesian | (r: f64, theta: f64) => [f64, f64] | Convierte polares a Cartesianas (x, y) |
copysign | (x: f64, y: f64) => f64 | Copia signo de y a x |
fmod | (x: f64, y: f64) => f64 | Resto en punto flotante de x / y |
logBase | (x: f64, base: f64) => f64 | Logaritmo de x en la base dada |
powi | (x: f64, exp: i32) => f64 | x elevado a la potencia entera exp |
