compiler_builtins/math/libm_math/
j0.rs

1/* origin: FreeBSD /usr/src/lib/msun/src/e_j0.c */
2/*
3 * ====================================================
4 * Copyright (C) 1993 by Sun Microsystems, Inc. All rights reserved.
5 *
6 * Developed at SunSoft, a Sun Microsystems, Inc. business.
7 * Permission to use, copy, modify, and distribute this
8 * software is freely granted, provided that this notice
9 * is preserved.
10 * ====================================================
11 */
12/* j0(x), y0(x)
13 * Bessel function of the first and second kinds of order zero.
14 * Method -- j0(x):
15 *      1. For tiny x, we use j0(x) = 1 - x^2/4 + x^4/64 - ...
16 *      2. Reduce x to |x| since j0(x)=j0(-x),  and
17 *         for x in (0,2)
18 *              j0(x) = 1-z/4+ z^2*R0/S0,  where z = x*x;
19 *         (precision:  |j0-1+z/4-z^2R0/S0 |<2**-63.67 )
20 *         for x in (2,inf)
21 *              j0(x) = sqrt(2/(pi*x))*(p0(x)*cos(x0)-q0(x)*sin(x0))
22 *         where x0 = x-pi/4. It is better to compute sin(x0),cos(x0)
23 *         as follow:
24 *              cos(x0) = cos(x)cos(pi/4)+sin(x)sin(pi/4)
25 *                      = 1/sqrt(2) * (cos(x) + sin(x))
26 *              sin(x0) = sin(x)cos(pi/4)-cos(x)sin(pi/4)
27 *                      = 1/sqrt(2) * (sin(x) - cos(x))
28 *         (To avoid cancellation, use
29 *              sin(x) +- cos(x) = -cos(2x)/(sin(x) -+ cos(x))
30 *          to compute the worse one.)
31 *
32 *      3 Special cases
33 *              j0(nan)= nan
34 *              j0(0) = 1
35 *              j0(inf) = 0
36 *
37 * Method -- y0(x):
38 *      1. For x<2.
39 *         Since
40 *              y0(x) = 2/pi*(j0(x)*(ln(x/2)+Euler) + x^2/4 - ...)
41 *         therefore y0(x)-2/pi*j0(x)*ln(x) is an even function.
42 *         We use the following function to approximate y0,
43 *              y0(x) = U(z)/V(z) + (2/pi)*(j0(x)*ln(x)), z= x^2
44 *         where
45 *              U(z) = u00 + u01*z + ... + u06*z^6
46 *              V(z) = 1  + v01*z + ... + v04*z^4
47 *         with absolute approximation error bounded by 2**-72.
48 *         Note: For tiny x, U/V = u0 and j0(x)~1, hence
49 *              y0(tiny) = u0 + (2/pi)*ln(tiny), (choose tiny<2**-27)
50 *      2. For x>=2.
51 *              y0(x) = sqrt(2/(pi*x))*(p0(x)*cos(x0)+q0(x)*sin(x0))
52 *         where x0 = x-pi/4. It is better to compute sin(x0),cos(x0)
53 *         by the method mentioned above.
54 *      3. Special cases: y0(0)=-inf, y0(x<0)=NaN, y0(inf)=0.
55 */
56
57use super::{cos, fabs, get_high_word, get_low_word, log, sin, sqrt};
58const INVSQRTPI: f64 = 5.64189583547756279280e-01; /* 0x3FE20DD7, 0x50429B6D */
59const TPI: f64 = 6.36619772367581382433e-01; /* 0x3FE45F30, 0x6DC9C883 */
60
61/* common method when |x|>=2 */
62fn common(ix: u32, x: f64, y0: bool) -> f64 {
63    let s: f64;
64    let mut c: f64;
65    let mut ss: f64;
66    let mut cc: f64;
67    let z: f64;
68
69    /*
70     * j0(x) = sqrt(2/(pi*x))*(p0(x)*cos(x-pi/4)-q0(x)*sin(x-pi/4))
71     * y0(x) = sqrt(2/(pi*x))*(p0(x)*sin(x-pi/4)+q0(x)*cos(x-pi/4))
72     *
73     * sin(x-pi/4) = (sin(x) - cos(x))/sqrt(2)
74     * cos(x-pi/4) = (sin(x) + cos(x))/sqrt(2)
75     * sin(x) +- cos(x) = -cos(2x)/(sin(x) -+ cos(x))
76     */
77    s = sin(x);
78    c = cos(x);
79    if y0 {
80        c = -c;
81    }
82    cc = s + c;
83    /* avoid overflow in 2*x, big ulp error when x>=0x1p1023 */
84    if ix < 0x7fe00000 {
85        ss = s - c;
86        z = -cos(2.0 * x);
87        if s * c < 0.0 {
88            cc = z / ss;
89        } else {
90            ss = z / cc;
91        }
92        if ix < 0x48000000 {
93            if y0 {
94                ss = -ss;
95            }
96            cc = pzero(x) * cc - qzero(x) * ss;
97        }
98    }
99    return INVSQRTPI * cc / sqrt(x);
100}
101
102/* R0/S0 on [0, 2.00] */
103const R02: f64 = 1.56249999999999947958e-02; /* 0x3F8FFFFF, 0xFFFFFFFD */
104const R03: f64 = -1.89979294238854721751e-04; /* 0xBF28E6A5, 0xB61AC6E9 */
105const R04: f64 = 1.82954049532700665670e-06; /* 0x3EBEB1D1, 0x0C503919 */
106const R05: f64 = -4.61832688532103189199e-09; /* 0xBE33D5E7, 0x73D63FCE */
107const S01: f64 = 1.56191029464890010492e-02; /* 0x3F8FFCE8, 0x82C8C2A4 */
108const S02: f64 = 1.16926784663337450260e-04; /* 0x3F1EA6D2, 0xDD57DBF4 */
109const S03: f64 = 5.13546550207318111446e-07; /* 0x3EA13B54, 0xCE84D5A9 */
110const S04: f64 = 1.16614003333790000205e-09; /* 0x3E1408BC, 0xF4745D8F */
111
112/// Zeroth order of the [Bessel function](https://en.wikipedia.org/wiki/Bessel_function) of the first kind (f64).
113#[cfg_attr(all(test, assert_no_panic), no_panic::no_panic)]
114pub fn j0(mut x: f64) -> f64 {
115    let z: f64;
116    let r: f64;
117    let s: f64;
118    let mut ix: u32;
119
120    ix = get_high_word(x);
121    ix &= 0x7fffffff;
122
123    /* j0(+-inf)=0, j0(nan)=nan */
124    if ix >= 0x7ff00000 {
125        return 1.0 / (x * x);
126    }
127    x = fabs(x);
128
129    if ix >= 0x40000000 {
130        /* |x| >= 2 */
131        /* large ulp error near zeros: 2.4, 5.52, 8.6537,.. */
132        return common(ix, x, false);
133    }
134
135    /* 1 - x*x/4 + x*x*R(x^2)/S(x^2) */
136    if ix >= 0x3f200000 {
137        /* |x| >= 2**-13 */
138        /* up to 4ulp error close to 2 */
139        z = x * x;
140        r = z * (R02 + z * (R03 + z * (R04 + z * R05)));
141        s = 1.0 + z * (S01 + z * (S02 + z * (S03 + z * S04)));
142        return (1.0 + x / 2.0) * (1.0 - x / 2.0) + z * (r / s);
143    }
144
145    /* 1 - x*x/4 */
146    /* prevent underflow */
147    /* inexact should be raised when x!=0, this is not done correctly */
148    if ix >= 0x38000000 {
149        /* |x| >= 2**-127 */
150        x = 0.25 * x * x;
151    }
152    return 1.0 - x;
153}
154
155const U00: f64 = -7.38042951086872317523e-02; /* 0xBFB2E4D6, 0x99CBD01F */
156const U01: f64 = 1.76666452509181115538e-01; /* 0x3FC69D01, 0x9DE9E3FC */
157const U02: f64 = -1.38185671945596898896e-02; /* 0xBF8C4CE8, 0xB16CFA97 */
158const U03: f64 = 3.47453432093683650238e-04; /* 0x3F36C54D, 0x20B29B6B */
159const U04: f64 = -3.81407053724364161125e-06; /* 0xBECFFEA7, 0x73D25CAD */
160const U05: f64 = 1.95590137035022920206e-08; /* 0x3E550057, 0x3B4EABD4 */
161const U06: f64 = -3.98205194132103398453e-11; /* 0xBDC5E43D, 0x693FB3C8 */
162const V01: f64 = 1.27304834834123699328e-02; /* 0x3F8A1270, 0x91C9C71A */
163const V02: f64 = 7.60068627350353253702e-05; /* 0x3F13ECBB, 0xF578C6C1 */
164const V03: f64 = 2.59150851840457805467e-07; /* 0x3E91642D, 0x7FF202FD */
165const V04: f64 = 4.41110311332675467403e-10; /* 0x3DFE5018, 0x3BD6D9EF */
166
167/// Zeroth order of the [Bessel function](https://en.wikipedia.org/wiki/Bessel_function) of the second kind (f64).
168#[cfg_attr(all(test, assert_no_panic), no_panic::no_panic)]
169pub fn y0(x: f64) -> f64 {
170    let z: f64;
171    let u: f64;
172    let v: f64;
173    let ix: u32;
174    let lx: u32;
175
176    ix = get_high_word(x);
177    lx = get_low_word(x);
178
179    /* y0(nan)=nan, y0(<0)=nan, y0(0)=-inf, y0(inf)=0 */
180    if ((ix << 1) | lx) == 0 {
181        return -1.0 / 0.0;
182    }
183    if (ix >> 31) != 0 {
184        return 0.0 / 0.0;
185    }
186    if ix >= 0x7ff00000 {
187        return 1.0 / x;
188    }
189
190    if ix >= 0x40000000 {
191        /* x >= 2 */
192        /* large ulp errors near zeros: 3.958, 7.086,.. */
193        return common(ix, x, true);
194    }
195
196    /* U(x^2)/V(x^2) + (2/pi)*j0(x)*log(x) */
197    if ix >= 0x3e400000 {
198        /* x >= 2**-27 */
199        /* large ulp error near the first zero, x ~= 0.89 */
200        z = x * x;
201        u = U00 + z * (U01 + z * (U02 + z * (U03 + z * (U04 + z * (U05 + z * U06)))));
202        v = 1.0 + z * (V01 + z * (V02 + z * (V03 + z * V04)));
203        return u / v + TPI * (j0(x) * log(x));
204    }
205    return U00 + TPI * log(x);
206}
207
208/* The asymptotic expansions of pzero is
209 *      1 - 9/128 s^2 + 11025/98304 s^4 - ...,  where s = 1/x.
210 * For x >= 2, We approximate pzero by
211 *      pzero(x) = 1 + (R/S)
212 * where  R = pR0 + pR1*s^2 + pR2*s^4 + ... + pR5*s^10
213 *        S = 1 + pS0*s^2 + ... + pS4*s^10
214 * and
215 *      | pzero(x)-1-R/S | <= 2  ** ( -60.26)
216 */
217const PR8: [f64; 6] = [
218    /* for x in [inf, 8]=1/[0,0.125] */
219    0.00000000000000000000e+00,  /* 0x00000000, 0x00000000 */
220    -7.03124999999900357484e-02, /* 0xBFB1FFFF, 0xFFFFFD32 */
221    -8.08167041275349795626e+00, /* 0xC02029D0, 0xB44FA779 */
222    -2.57063105679704847262e+02, /* 0xC0701102, 0x7B19E863 */
223    -2.48521641009428822144e+03, /* 0xC0A36A6E, 0xCD4DCAFC */
224    -5.25304380490729545272e+03, /* 0xC0B4850B, 0x36CC643D */
225];
226const PS8: [f64; 5] = [
227    1.16534364619668181717e+02, /* 0x405D2233, 0x07A96751 */
228    3.83374475364121826715e+03, /* 0x40ADF37D, 0x50596938 */
229    4.05978572648472545552e+04, /* 0x40E3D2BB, 0x6EB6B05F */
230    1.16752972564375915681e+05, /* 0x40FC810F, 0x8F9FA9BD */
231    4.76277284146730962675e+04, /* 0x40E74177, 0x4F2C49DC */
232];
233
234const PR5: [f64; 6] = [
235    /* for x in [8,4.5454]=1/[0.125,0.22001] */
236    -1.14125464691894502584e-11, /* 0xBDA918B1, 0x47E495CC */
237    -7.03124940873599280078e-02, /* 0xBFB1FFFF, 0xE69AFBC6 */
238    -4.15961064470587782438e+00, /* 0xC010A370, 0xF90C6BBF */
239    -6.76747652265167261021e+01, /* 0xC050EB2F, 0x5A7D1783 */
240    -3.31231299649172967747e+02, /* 0xC074B3B3, 0x6742CC63 */
241    -3.46433388365604912451e+02, /* 0xC075A6EF, 0x28A38BD7 */
242];
243const PS5: [f64; 5] = [
244    6.07539382692300335975e+01, /* 0x404E6081, 0x0C98C5DE */
245    1.05125230595704579173e+03, /* 0x40906D02, 0x5C7E2864 */
246    5.97897094333855784498e+03, /* 0x40B75AF8, 0x8FBE1D60 */
247    9.62544514357774460223e+03, /* 0x40C2CCB8, 0xFA76FA38 */
248    2.40605815922939109441e+03, /* 0x40A2CC1D, 0xC70BE864 */
249];
250
251const PR3: [f64; 6] = [
252    /* for x in [4.547,2.8571]=1/[0.2199,0.35001] */
253    -2.54704601771951915620e-09, /* 0xBE25E103, 0x6FE1AA86 */
254    -7.03119616381481654654e-02, /* 0xBFB1FFF6, 0xF7C0E24B */
255    -2.40903221549529611423e+00, /* 0xC00345B2, 0xAEA48074 */
256    -2.19659774734883086467e+01, /* 0xC035F74A, 0x4CB94E14 */
257    -5.80791704701737572236e+01, /* 0xC04D0A22, 0x420A1A45 */
258    -3.14479470594888503854e+01, /* 0xC03F72AC, 0xA892D80F */
259];
260const PS3: [f64; 5] = [
261    3.58560338055209726349e+01, /* 0x4041ED92, 0x84077DD3 */
262    3.61513983050303863820e+02, /* 0x40769839, 0x464A7C0E */
263    1.19360783792111533330e+03, /* 0x4092A66E, 0x6D1061D6 */
264    1.12799679856907414432e+03, /* 0x40919FFC, 0xB8C39B7E */
265    1.73580930813335754692e+02, /* 0x4065B296, 0xFC379081 */
266];
267
268const PR2: [f64; 6] = [
269    /* for x in [2.8570,2]=1/[0.3499,0.5] */
270    -8.87534333032526411254e-08, /* 0xBE77D316, 0xE927026D */
271    -7.03030995483624743247e-02, /* 0xBFB1FF62, 0x495E1E42 */
272    -1.45073846780952986357e+00, /* 0xBFF73639, 0x8A24A843 */
273    -7.63569613823527770791e+00, /* 0xC01E8AF3, 0xEDAFA7F3 */
274    -1.11931668860356747786e+01, /* 0xC02662E6, 0xC5246303 */
275    -3.23364579351335335033e+00, /* 0xC009DE81, 0xAF8FE70F */
276];
277const PS2: [f64; 5] = [
278    2.22202997532088808441e+01, /* 0x40363865, 0x908B5959 */
279    1.36206794218215208048e+02, /* 0x4061069E, 0x0EE8878F */
280    2.70470278658083486789e+02, /* 0x4070E786, 0x42EA079B */
281    1.53875394208320329881e+02, /* 0x40633C03, 0x3AB6FAFF */
282    1.46576176948256193810e+01, /* 0x402D50B3, 0x44391809 */
283];
284
285fn pzero(x: f64) -> f64 {
286    let p: &[f64; 6];
287    let q: &[f64; 5];
288    let z: f64;
289    let r: f64;
290    let s: f64;
291    let mut ix: u32;
292
293    ix = get_high_word(x);
294    ix &= 0x7fffffff;
295    if ix >= 0x40200000 {
296        p = &PR8;
297        q = &PS8;
298    } else if ix >= 0x40122E8B {
299        p = &PR5;
300        q = &PS5;
301    } else if ix >= 0x4006DB6D {
302        p = &PR3;
303        q = &PS3;
304    } else
305    /*ix >= 0x40000000*/
306    {
307        p = &PR2;
308        q = &PS2;
309    }
310    z = 1.0 / (x * x);
311    r = p[0] + z * (p[1] + z * (p[2] + z * (p[3] + z * (p[4] + z * p[5]))));
312    s = 1.0 + z * (q[0] + z * (q[1] + z * (q[2] + z * (q[3] + z * q[4]))));
313    return 1.0 + r / s;
314}
315
316/* For x >= 8, the asymptotic expansions of qzero is
317 *      -1/8 s + 75/1024 s^3 - ..., where s = 1/x.
318 * We approximate pzero by
319 *      qzero(x) = s*(-1.25 + (R/S))
320 * where  R = qR0 + qR1*s^2 + qR2*s^4 + ... + qR5*s^10
321 *        S = 1 + qS0*s^2 + ... + qS5*s^12
322 * and
323 *      | qzero(x)/s +1.25-R/S | <= 2  ** ( -61.22)
324 */
325const QR8: [f64; 6] = [
326    /* for x in [inf, 8]=1/[0,0.125] */
327    0.00000000000000000000e+00, /* 0x00000000, 0x00000000 */
328    7.32421874999935051953e-02, /* 0x3FB2BFFF, 0xFFFFFE2C */
329    1.17682064682252693899e+01, /* 0x40278952, 0x5BB334D6 */
330    5.57673380256401856059e+02, /* 0x40816D63, 0x15301825 */
331    8.85919720756468632317e+03, /* 0x40C14D99, 0x3E18F46D */
332    3.70146267776887834771e+04, /* 0x40E212D4, 0x0E901566 */
333];
334const QS8: [f64; 6] = [
335    1.63776026895689824414e+02,  /* 0x406478D5, 0x365B39BC */
336    8.09834494656449805916e+03,  /* 0x40BFA258, 0x4E6B0563 */
337    1.42538291419120476348e+05,  /* 0x41016652, 0x54D38C3F */
338    8.03309257119514397345e+05,  /* 0x412883DA, 0x83A52B43 */
339    8.40501579819060512818e+05,  /* 0x4129A66B, 0x28DE0B3D */
340    -3.43899293537866615225e+05, /* 0xC114FD6D, 0x2C9530C5 */
341];
342
343const QR5: [f64; 6] = [
344    /* for x in [8,4.5454]=1/[0.125,0.22001] */
345    1.84085963594515531381e-11, /* 0x3DB43D8F, 0x29CC8CD9 */
346    7.32421766612684765896e-02, /* 0x3FB2BFFF, 0xD172B04C */
347    5.83563508962056953777e+00, /* 0x401757B0, 0xB9953DD3 */
348    1.35111577286449829671e+02, /* 0x4060E392, 0x0A8788E9 */
349    1.02724376596164097464e+03, /* 0x40900CF9, 0x9DC8C481 */
350    1.98997785864605384631e+03, /* 0x409F17E9, 0x53C6E3A6 */
351];
352const QS5: [f64; 6] = [
353    8.27766102236537761883e+01,  /* 0x4054B1B3, 0xFB5E1543 */
354    2.07781416421392987104e+03,  /* 0x40A03BA0, 0xDA21C0CE */
355    1.88472887785718085070e+04,  /* 0x40D267D2, 0x7B591E6D */
356    5.67511122894947329769e+04,  /* 0x40EBB5E3, 0x97E02372 */
357    3.59767538425114471465e+04,  /* 0x40E19118, 0x1F7A54A0 */
358    -5.35434275601944773371e+03, /* 0xC0B4EA57, 0xBEDBC609 */
359];
360
361const QR3: [f64; 6] = [
362    /* for x in [4.547,2.8571]=1/[0.2199,0.35001] */
363    4.37741014089738620906e-09, /* 0x3E32CD03, 0x6ADECB82 */
364    7.32411180042911447163e-02, /* 0x3FB2BFEE, 0x0E8D0842 */
365    3.34423137516170720929e+00, /* 0x400AC0FC, 0x61149CF5 */
366    4.26218440745412650017e+01, /* 0x40454F98, 0x962DAEDD */
367    1.70808091340565596283e+02, /* 0x406559DB, 0xE25EFD1F */
368    1.66733948696651168575e+02, /* 0x4064D77C, 0x81FA21E0 */
369];
370const QS3: [f64; 6] = [
371    4.87588729724587182091e+01,  /* 0x40486122, 0xBFE343A6 */
372    7.09689221056606015736e+02,  /* 0x40862D83, 0x86544EB3 */
373    3.70414822620111362994e+03,  /* 0x40ACF04B, 0xE44DFC63 */
374    6.46042516752568917582e+03,  /* 0x40B93C6C, 0xD7C76A28 */
375    2.51633368920368957333e+03,  /* 0x40A3A8AA, 0xD94FB1C0 */
376    -1.49247451836156386662e+02, /* 0xC062A7EB, 0x201CF40F */
377];
378
379const QR2: [f64; 6] = [
380    /* for x in [2.8570,2]=1/[0.3499,0.5] */
381    1.50444444886983272379e-07, /* 0x3E84313B, 0x54F76BDB */
382    7.32234265963079278272e-02, /* 0x3FB2BEC5, 0x3E883E34 */
383    1.99819174093815998816e+00, /* 0x3FFFF897, 0xE727779C */
384    1.44956029347885735348e+01, /* 0x402CFDBF, 0xAAF96FE5 */
385    3.16662317504781540833e+01, /* 0x403FAA8E, 0x29FBDC4A */
386    1.62527075710929267416e+01, /* 0x403040B1, 0x71814BB4 */
387];
388const QS2: [f64; 6] = [
389    3.03655848355219184498e+01,  /* 0x403E5D96, 0xF7C07AED */
390    2.69348118608049844624e+02,  /* 0x4070D591, 0xE4D14B40 */
391    8.44783757595320139444e+02,  /* 0x408A6645, 0x22B3BF22 */
392    8.82935845112488550512e+02,  /* 0x408B977C, 0x9C5CC214 */
393    2.12666388511798828631e+02,  /* 0x406A9553, 0x0E001365 */
394    -5.31095493882666946917e+00, /* 0xC0153E6A, 0xF8B32931 */
395];
396
397fn qzero(x: f64) -> f64 {
398    let p: &[f64; 6];
399    let q: &[f64; 6];
400    let s: f64;
401    let r: f64;
402    let z: f64;
403    let mut ix: u32;
404
405    ix = get_high_word(x);
406    ix &= 0x7fffffff;
407    if ix >= 0x40200000 {
408        p = &QR8;
409        q = &QS8;
410    } else if ix >= 0x40122E8B {
411        p = &QR5;
412        q = &QS5;
413    } else if ix >= 0x4006DB6D {
414        p = &QR3;
415        q = &QS3;
416    } else
417    /*ix >= 0x40000000*/
418    {
419        p = &QR2;
420        q = &QS2;
421    }
422    z = 1.0 / (x * x);
423    r = p[0] + z * (p[1] + z * (p[2] + z * (p[3] + z * (p[4] + z * p[5]))));
424    s = 1.0 + z * (q[0] + z * (q[1] + z * (q[2] + z * (q[3] + z * (q[4] + z * q[5])))));
425    return (-0.125 + r / s) / x;
426}
compiler_builtins/math/libm_math/j0.rs

compiler_builtins/math/libm_math/
j0.rs
