Files
another-boids-in-rust/vendor/pxfm/src/exponents/exp10m1f.rs

142 lines
5.0 KiB
Rust

/*
* // Copyright (c) Radzivon Bartoshyk 7/2025. All rights reserved.
* //
* // Redistribution and use in source and binary forms, with or without modification,
* // are permitted provided that the following conditions are met:
* //
* // 1. Redistributions of source code must retain the above copyright notice, this
* // list of conditions and the following disclaimer.
* //
* // 2. Redistributions in binary form must reproduce the above copyright notice,
* // this list of conditions and the following disclaimer in the documentation
* // and/or other materials provided with the distribution.
* //
* // 3. Neither the name of the copyright holder nor the names of its
* // contributors may be used to endorse or promote products derived from
* // this software without specific prior written permission.
* //
* // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
* // AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
* // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
* // DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
* // FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
* // DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
* // SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
* // CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
* // OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
* // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
*/
use crate::common::f_fmla;
use crate::exponents::exp10f::EXP10F_COEFFS;
use crate::polyeval::f_polyeval3;
#[cold]
fn exp10m1f_small(x: f32) -> f32 {
let dx = x as f64;
let dx_sq = dx * dx;
let c0 = dx * f64::from_bits(EXP10F_COEFFS[0]);
let c1 = f_fmla(
dx,
f64::from_bits(EXP10F_COEFFS[2]),
f64::from_bits(EXP10F_COEFFS[1]),
);
let c2 = f_fmla(
dx,
f64::from_bits(EXP10F_COEFFS[4]),
f64::from_bits(EXP10F_COEFFS[3]),
);
// 10^dx - 1 ~ (1 + COEFFS[0] * dx + ... + COEFFS[4] * dx^5) - 1
// = COEFFS[0] * dx + ... + COEFFS[4] * dx^5
f_polyeval3(dx_sq, c0, c1, c2) as f32
}
/// Computes 10^x - 1
///
/// Max ULP 0.5
#[inline]
pub fn f_exp10m1f(x: f32) -> f32 {
let x_u = x.to_bits();
let x_abs = x_u & 0x7fff_ffffu32;
// When x >= log10(2^128), or x is nan
if x.is_sign_positive() && x_u >= 0x421a_209bu32 {
// x >= log10(2^128) and 10^x - 1 rounds to +inf, or x is +inf or nan
return x + f32::INFINITY;
}
if x_abs <= 0x3b9a_209bu32 {
// |x| <= 0.004703594
return exp10m1f_small(x);
}
// When x <= log10(2^-25), or x is nan
if x_u >= 0xc0f0d2f1 {
// exp10m1(-inf) = -1
if x.is_infinite() {
return -1.0;
}
// exp10m1(nan) = nan
if x.is_nan() {
return x;
}
if x_u == 0xc0f0d2f1 {
return f32::from_bits(0xbf7fffff); // -1.0f + 0x1.0p-24f
}
return -1.0;
}
// Exact outputs when x = 1, 2, ..., 10.
// Quick check mask: 0x800f'ffffU = ~(bits of 1.0f | ... | bits of 10.0f)
if x_u & 0x800f_ffffu32 == 0 {
match x_u {
0x3f800000u32 => return 9.0, // x = 1.0f
0x40000000u32 => return 99.0, // x = 2.0f
0x40400000u32 => return 999.0, // x = 3.0f
0x40800000u32 => return 9_999.0, // x = 4.0f
0x40a00000u32 => return 99_999.0, // x = 5.0f
0x40c00000u32 => return 999_999.0, // x = 6.0f
0x40e00000u32 => return 9_999_999.0, // x = 7.0f
0x41000000u32 => return 99_999_999.0, // x = 8.0f
0x41100000u32 => return 999_999_999.0, // x = 9.0f
0x41200000u32 => return 9_999_999_999.0, // x = 10.0f
_ => {}
}
}
// Range reduction: 10^x = 2^(mid + hi) * 10^lo
// rr = (2^(mid + hi), lo)
let rr = crate::exponents::exp10f::exp_b_range_reduc(x);
// The low part is approximated by a degree-5 minimax polynomial.
// 10^lo ~ 1 + COEFFS[0] * lo + ... + COEFFS[4] * lo^5
let lo_sq = rr.lo * rr.lo;
let c0 = f_fmla(rr.lo, f64::from_bits(EXP10F_COEFFS[0]), 1.0);
let c1 = f_fmla(
rr.lo,
f64::from_bits(EXP10F_COEFFS[2]),
f64::from_bits(EXP10F_COEFFS[1]),
);
let c2 = f_fmla(
rr.lo,
f64::from_bits(EXP10F_COEFFS[4]),
f64::from_bits(EXP10F_COEFFS[3]),
);
let exp10_lo = f_polyeval3(lo_sq, c0, c1, c2);
// 10^x - 1 = 2^(mid + hi) * 10^lo - 1
// ~ mh * exp10_lo - 1
f_fmla(exp10_lo, rr.hi, -1.0) as f32
}
#[cfg(test)]
mod tests {
use super::*;
#[test]
fn test_exp10m1f() {
assert_eq!(f_exp10m1f(0.0), 0.0);
assert_eq!(f_exp10m1f(1.0), 9.0);
assert_eq!(f_exp10m1f(1.5), 30.622776);
}
}