1 /* 2 * Double-precision vector 2^x function. 3 * 4 * Copyright (c) 2019-2024, Arm Limited. 5 * SPDX-License-Identifier: MIT OR Apache-2.0 WITH LLVM-exception 6 */ 7 8 #include "v_math.h" 9 #include "v_poly_f64.h" 10 #include "test_sig.h" 11 #include "test_defs.h" 12 13 #define N (1 << V_EXP_TABLE_BITS) 14 #define IndexMask (N - 1) 15 #define BigBound 1022.0 16 #define UOFlowBound 1280.0 17 #define TinyBound 0x2000000000000000 /* asuint64(0x1p-511). */ 18 19 static const struct data 20 { 21 float64x2_t poly[4]; 22 float64x2_t shift, scale_big_bound, scale_uoflow_bound; 23 } data = { 24 /* Coefficients are computed using Remez algorithm with 25 minimisation of the absolute error. */ 26 .poly = { V2 (0x1.62e42fefa3686p-1), V2 (0x1.ebfbdff82c241p-3), 27 V2 (0x1.c6b09b16de99ap-5), V2 (0x1.3b2abf5571ad8p-7) }, 28 .shift = V2 (0x1.8p52 / N), 29 .scale_big_bound = V2 (BigBound), 30 .scale_uoflow_bound = V2 (UOFlowBound), 31 }; 32 33 static inline uint64x2_t 34 lookup_sbits (uint64x2_t i) 35 { 36 return (uint64x2_t){ __v_exp_data[i[0] & IndexMask], 37 __v_exp_data[i[1] & IndexMask] }; 38 } 39 40 #if WANT_SIMD_EXCEPT 41 42 # define Thres 0x2080000000000000 /* asuint64(512.0) - TinyBound. */ 43 44 /* Call scalar exp2 as a fallback. */ 45 static float64x2_t VPCS_ATTR NOINLINE 46 special_case (float64x2_t x, float64x2_t y, uint64x2_t is_special) 47 { 48 return v_call_f64 (exp2, x, y, is_special); 49 } 50 51 #else 52 53 # define SpecialOffset 0x6000000000000000 /* 0x1p513. */ 54 /* SpecialBias1 + SpecialBias1 = asuint(1.0). */ 55 # define SpecialBias1 0x7000000000000000 /* 0x1p769. */ 56 # define SpecialBias2 0x3010000000000000 /* 0x1p-254. */ 57 58 static inline float64x2_t VPCS_ATTR 59 special_case (float64x2_t s, float64x2_t y, float64x2_t n, 60 const struct data *d) 61 { 62 /* 2^(n/N) may overflow, break it up into s1*s2. */ 63 uint64x2_t b = vandq_u64 (vclezq_f64 (n), v_u64 (SpecialOffset)); 64 float64x2_t s1 = vreinterpretq_f64_u64 (vsubq_u64 (v_u64 (SpecialBias1), b)); 65 float64x2_t s2 = vreinterpretq_f64_u64 (vaddq_u64 ( 66 vsubq_u64 (vreinterpretq_u64_f64 (s), v_u64 (SpecialBias2)), b)); 67 uint64x2_t cmp = vcagtq_f64 (n, d->scale_uoflow_bound); 68 float64x2_t r1 = vmulq_f64 (s1, s1); 69 float64x2_t r0 = vmulq_f64 (vfmaq_f64 (s2, s2, y), s1); 70 return vbslq_f64 (cmp, r1, r0); 71 } 72 73 #endif 74 75 /* Fast vector implementation of exp2. 76 Maximum measured error is 1.65 ulp. 77 _ZGVnN2v_exp2(-0x1.4c264ab5b559bp-6) got 0x1.f8db0d4df721fp-1 78 want 0x1.f8db0d4df721dp-1. */ 79 VPCS_ATTR 80 float64x2_t V_NAME_D1 (exp2) (float64x2_t x) 81 { 82 const struct data *d = ptr_barrier (&data); 83 uint64x2_t cmp; 84 #if WANT_SIMD_EXCEPT 85 uint64x2_t ia = vreinterpretq_u64_f64 (vabsq_f64 (x)); 86 cmp = vcgeq_u64 (vsubq_u64 (ia, v_u64 (TinyBound)), v_u64 (Thres)); 87 /* Mask special lanes and retain a copy of x for passing to special-case 88 handler. */ 89 float64x2_t xc = x; 90 x = v_zerofy_f64 (x, cmp); 91 #else 92 cmp = vcagtq_f64 (x, d->scale_big_bound); 93 #endif 94 95 /* n = round(x/N). */ 96 float64x2_t z = vaddq_f64 (d->shift, x); 97 uint64x2_t u = vreinterpretq_u64_f64 (z); 98 float64x2_t n = vsubq_f64 (z, d->shift); 99 100 /* r = x - n/N. */ 101 float64x2_t r = vsubq_f64 (x, n); 102 103 /* s = 2^(n/N). */ 104 uint64x2_t e = vshlq_n_u64 (u, 52 - V_EXP_TABLE_BITS); 105 u = lookup_sbits (u); 106 float64x2_t s = vreinterpretq_f64_u64 (vaddq_u64 (u, e)); 107 108 /* y ~ exp2(r) - 1. */ 109 float64x2_t r2 = vmulq_f64 (r, r); 110 float64x2_t y = v_pairwise_poly_3_f64 (r, r2, d->poly); 111 y = vmulq_f64 (r, y); 112 113 if (unlikely (v_any_u64 (cmp))) 114 #if !WANT_SIMD_EXCEPT 115 return special_case (s, y, n, d); 116 #else 117 return special_case (xc, vfmaq_f64 (s, s, y), cmp); 118 #endif 119 return vfmaq_f64 (s, s, y); 120 } 121 122 TEST_SIG (V, D, 1, exp2, -9.9, 9.9) 123 TEST_ULP (V_NAME_D1 (exp2), 1.15) 124 TEST_DISABLE_FENV_IF_NOT (V_NAME_D1 (exp2), WANT_SIMD_EXCEPT) 125 TEST_SYM_INTERVAL (V_NAME_D1 (exp2), 0, TinyBound, 5000) 126 TEST_SYM_INTERVAL (V_NAME_D1 (exp2), TinyBound, BigBound, 10000) 127 TEST_SYM_INTERVAL (V_NAME_D1 (exp2), BigBound, UOFlowBound, 5000) 128 TEST_SYM_INTERVAL (V_NAME_D1 (exp2), UOFlowBound, inf, 10000) 129