pub const WGSL_LAGUERRE_GENERALIZED_F64: &str =
include_str!("../shaders/math/laguerre_generalized_f64.wgsl");
#[must_use]
pub fn laguerre(n: usize, alpha: f64, x: f64) -> f64 {
match n {
0 => 1.0,
1 => 1.0 + alpha - x,
_ => {
let mut l_prev2 = 1.0; let mut l_prev1 = 1.0 + alpha - x;
for k in 2..=n {
let k_f = k as f64;
let l_curr = (2.0f64.mul_add(k_f, -1.0) + alpha - x)
.mul_add(l_prev1, -((k_f - 1.0 + alpha) * l_prev2))
/ k_f;
l_prev2 = l_prev1;
l_prev1 = l_curr;
}
l_prev1
}
}
}
#[must_use]
pub fn laguerre_simple(n: usize, x: f64) -> f64 {
laguerre(n, 0.0, x)
}
#[must_use]
pub fn laguerre_all(n_max: usize, alpha: f64, x: f64) -> Vec<f64> {
let mut result = Vec::with_capacity(n_max + 1);
result.push(1.0);
if n_max == 0 {
return result;
}
result.push(1.0 + alpha - x);
for k in 2..=n_max {
let k_f = k as f64;
let l_curr = (2.0f64.mul_add(k_f, -1.0) + alpha - x)
.mul_add(result[k - 1], -((k_f - 1.0 + alpha) * result[k - 2]))
/ k_f;
result.push(l_curr);
}
result
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_laguerre_degree_0() {
assert_eq!(laguerre(0, 0.0, 0.0), 1.0);
assert_eq!(laguerre(0, 0.0, 5.0), 1.0);
assert_eq!(laguerre(0, 2.0, 100.0), 1.0);
}
#[test]
fn test_laguerre_degree_1() {
assert!((laguerre(1, 0.0, 0.0) - 1.0).abs() < 1e-14);
assert!((laguerre(1, 0.0, 1.0) - 0.0).abs() < 1e-14);
assert!((laguerre(1, 0.0, 3.0) - (-2.0)).abs() < 1e-14);
assert!((laguerre(1, 2.0, 1.0) - 2.0).abs() < 1e-14); }
#[test]
fn test_laguerre_degree_2() {
for x in [0.0_f64, 0.5, 1.0, 2.0, 5.0] {
let expected = f64::midpoint(x.mul_add(x, -(4.0 * x)), 2.0);
assert!(
(laguerre(2, 0.0, x) - expected).abs() < 1e-12,
"L_2(0, {}) = {} expected {}",
x,
laguerre(2, 0.0, x),
expected
);
}
}
#[test]
fn test_laguerre_degree_3() {
for x in [0.0_f64, 1.0, 2.0, 3.0] {
let expected = (18.0f64.mul_add(-x, (9.0 * x).mul_add(x, -x.powi(3))) + 6.0) / 6.0;
assert!(
(laguerre(3, 0.0, x) - expected).abs() < 1e-11,
"L_3(0, {}) = {} expected {}",
x,
laguerre(3, 0.0, x),
expected
);
}
}
#[test]
fn test_laguerre_generalized() {
assert!((laguerre(1, 1.0, 0.0) - 2.0).abs() < 1e-14);
assert!((laguerre(1, 1.0, 2.0) - 0.0).abs() < 1e-14);
for x in [0.0_f64, 1.0, 3.0] {
let expected = f64::midpoint(x.mul_add(x, -(6.0 * x)), 6.0);
assert!(
(laguerre(2, 1.0, x) - expected).abs() < 1e-12,
"L_2(1, {}) = {} expected {}",
x,
laguerre(2, 1.0, x),
expected
);
}
}
#[test]
fn test_laguerre_at_zero() {
assert!((laguerre(0, 0.0, 0.0) - 1.0).abs() < 1e-14);
assert!((laguerre(1, 0.0, 0.0) - 1.0).abs() < 1e-14);
assert!((laguerre(2, 0.0, 0.0) - 1.0).abs() < 1e-12);
assert!((laguerre(5, 0.0, 0.0) - 1.0).abs() < 1e-10);
}
#[test]
fn test_laguerre_simple() {
assert!((laguerre_simple(0, 1.0) - 1.0).abs() < 1e-14);
assert!((laguerre_simple(1, 1.0) - 0.0).abs() < 1e-14);
assert!((laguerre_simple(2, 1.0) - (-0.5)).abs() < 1e-14);
}
#[test]
fn test_laguerre_all_basic() {
let values = laguerre_all(3, 0.0, 1.0);
assert_eq!(values.len(), 4);
assert!((values[0] - 1.0).abs() < 1e-14); assert!((values[1] - 0.0).abs() < 1e-14); assert!((values[2] - (-0.5)).abs() < 1e-14); }
#[test]
fn test_laguerre_all_degree_0() {
let values = laguerre_all(0, 0.0, 5.0);
assert_eq!(values.len(), 1);
assert_eq!(values[0], 1.0);
}
#[test]
fn test_laguerre_all_consistency() {
let alpha = 1.5;
let x = 2.7;
let all = laguerre_all(10, alpha, x);
for (n, &val) in all.iter().enumerate() {
let individual = laguerre(n, alpha, x);
assert!(
(val - individual).abs() < 1e-10,
"Mismatch at n={n}: all={val}, individual={individual}"
);
}
}
#[test]
fn test_laguerre_higher_degree() {
let val = laguerre(20, 0.0, 5.0);
assert!(val.is_finite());
assert!(val.abs() < 1e10);
}
#[test]
fn test_laguerre_negative_x() {
let val = laguerre(3, 0.0, -1.0);
assert!(val.is_finite());
let expected = 34.0 / 6.0;
assert!(
(val - expected).abs() < 1e-11,
"L_3(0, -1) = {val} expected {expected}"
);
}
}