14a238c70SJohn Marino /* mpfr_expm1 -- Compute exp(x)-1
24a238c70SJohn Marino
3*ab6d115fSJohn Marino Copyright 2001, 2002, 2003, 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2011, 2012, 2013 Free Software Foundation, Inc.
4*ab6d115fSJohn Marino Contributed by the AriC and Caramel projects, INRIA.
54a238c70SJohn Marino
64a238c70SJohn Marino This file is part of the GNU MPFR Library.
74a238c70SJohn Marino
84a238c70SJohn Marino The GNU MPFR Library is free software; you can redistribute it and/or modify
94a238c70SJohn Marino it under the terms of the GNU Lesser General Public License as published by
104a238c70SJohn Marino the Free Software Foundation; either version 3 of the License, or (at your
114a238c70SJohn Marino option) any later version.
124a238c70SJohn Marino
134a238c70SJohn Marino The GNU MPFR Library is distributed in the hope that it will be useful, but
144a238c70SJohn Marino WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
154a238c70SJohn Marino or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public
164a238c70SJohn Marino License for more details.
174a238c70SJohn Marino
184a238c70SJohn Marino You should have received a copy of the GNU Lesser General Public License
194a238c70SJohn Marino along with the GNU MPFR Library; see the file COPYING.LESSER. If not, see
204a238c70SJohn Marino http://www.gnu.org/licenses/ or write to the Free Software Foundation, Inc.,
214a238c70SJohn Marino 51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA. */
224a238c70SJohn Marino
234a238c70SJohn Marino #define MPFR_NEED_LONGLONG_H
244a238c70SJohn Marino #include "mpfr-impl.h"
254a238c70SJohn Marino
264a238c70SJohn Marino /* The computation of expm1 is done by
274a238c70SJohn Marino expm1(x)=exp(x)-1
284a238c70SJohn Marino */
294a238c70SJohn Marino
304a238c70SJohn Marino int
mpfr_expm1(mpfr_ptr y,mpfr_srcptr x,mpfr_rnd_t rnd_mode)314a238c70SJohn Marino mpfr_expm1 (mpfr_ptr y, mpfr_srcptr x , mpfr_rnd_t rnd_mode)
324a238c70SJohn Marino {
334a238c70SJohn Marino int inexact;
344a238c70SJohn Marino mpfr_exp_t ex;
354a238c70SJohn Marino MPFR_SAVE_EXPO_DECL (expo);
364a238c70SJohn Marino
374a238c70SJohn Marino MPFR_LOG_FUNC
384a238c70SJohn Marino (("x[%Pu]=%.*Rg rnd=%d", mpfr_get_prec (x), mpfr_log_prec, x, rnd_mode),
394a238c70SJohn Marino ("y[%Pu]=%.*Rg inexact=%d", mpfr_get_prec (y), mpfr_log_prec, y,
404a238c70SJohn Marino inexact));
414a238c70SJohn Marino
424a238c70SJohn Marino if (MPFR_UNLIKELY (MPFR_IS_SINGULAR (x)))
434a238c70SJohn Marino {
444a238c70SJohn Marino if (MPFR_IS_NAN (x))
454a238c70SJohn Marino {
464a238c70SJohn Marino MPFR_SET_NAN (y);
474a238c70SJohn Marino MPFR_RET_NAN;
484a238c70SJohn Marino }
494a238c70SJohn Marino /* check for inf or -inf (expm1(-inf)=-1) */
504a238c70SJohn Marino else if (MPFR_IS_INF (x))
514a238c70SJohn Marino {
524a238c70SJohn Marino if (MPFR_IS_POS (x))
534a238c70SJohn Marino {
544a238c70SJohn Marino MPFR_SET_INF (y);
554a238c70SJohn Marino MPFR_SET_POS (y);
564a238c70SJohn Marino MPFR_RET (0);
574a238c70SJohn Marino }
584a238c70SJohn Marino else
594a238c70SJohn Marino return mpfr_set_si (y, -1, rnd_mode);
604a238c70SJohn Marino }
614a238c70SJohn Marino else
624a238c70SJohn Marino {
634a238c70SJohn Marino MPFR_ASSERTD (MPFR_IS_ZERO (x));
644a238c70SJohn Marino MPFR_SET_ZERO (y); /* expm1(+/- 0) = +/- 0 */
654a238c70SJohn Marino MPFR_SET_SAME_SIGN (y, x);
664a238c70SJohn Marino MPFR_RET (0);
674a238c70SJohn Marino }
684a238c70SJohn Marino }
694a238c70SJohn Marino
704a238c70SJohn Marino ex = MPFR_GET_EXP (x);
714a238c70SJohn Marino if (ex < 0)
724a238c70SJohn Marino {
734a238c70SJohn Marino /* For -1 < x < 0, abs(expm1(x)-x) < x^2/2.
744a238c70SJohn Marino For 0 < x < 1, abs(expm1(x)-x) < x^2. */
754a238c70SJohn Marino if (MPFR_IS_POS (x))
764a238c70SJohn Marino MPFR_FAST_COMPUTE_IF_SMALL_INPUT (y, x, - ex, 0, 1, rnd_mode, {});
774a238c70SJohn Marino else
784a238c70SJohn Marino MPFR_FAST_COMPUTE_IF_SMALL_INPUT (y, x, - ex, 1, 0, rnd_mode, {});
794a238c70SJohn Marino }
804a238c70SJohn Marino
814a238c70SJohn Marino MPFR_SAVE_EXPO_MARK (expo);
824a238c70SJohn Marino
834a238c70SJohn Marino if (MPFR_IS_NEG (x) && ex > 5) /* x <= -32 */
844a238c70SJohn Marino {
854a238c70SJohn Marino mpfr_t minus_one, t;
864a238c70SJohn Marino mpfr_exp_t err;
874a238c70SJohn Marino
884a238c70SJohn Marino mpfr_init2 (minus_one, 2);
894a238c70SJohn Marino mpfr_init2 (t, 64);
904a238c70SJohn Marino mpfr_set_si (minus_one, -1, MPFR_RNDN);
914a238c70SJohn Marino mpfr_const_log2 (t, MPFR_RNDU); /* round upward since x is negative */
924a238c70SJohn Marino mpfr_div (t, x, t, MPFR_RNDU); /* > x / ln(2) */
934a238c70SJohn Marino err = mpfr_cmp_si (t, MPFR_EMIN_MIN >= -LONG_MAX ?
944a238c70SJohn Marino MPFR_EMIN_MIN : -LONG_MAX) <= 0 ?
954a238c70SJohn Marino - (MPFR_EMIN_MIN >= -LONG_MAX ? MPFR_EMIN_MIN : -LONG_MAX) :
964a238c70SJohn Marino - mpfr_get_si (t, MPFR_RNDU);
974a238c70SJohn Marino /* exp(x) = 2^(x/ln(2))
984a238c70SJohn Marino <= 2^max(MPFR_EMIN_MIN,-LONG_MAX,ceil(x/ln(2)+epsilon))
994a238c70SJohn Marino with epsilon > 0 */
1004a238c70SJohn Marino mpfr_clear (t);
1014a238c70SJohn Marino MPFR_SMALL_INPUT_AFTER_SAVE_EXPO (y, minus_one, err, 0, 0, rnd_mode,
1024a238c70SJohn Marino expo, { mpfr_clear (minus_one); });
1034a238c70SJohn Marino mpfr_clear (minus_one);
1044a238c70SJohn Marino }
1054a238c70SJohn Marino
1064a238c70SJohn Marino /* General case */
1074a238c70SJohn Marino {
1084a238c70SJohn Marino /* Declaration of the intermediary variable */
1094a238c70SJohn Marino mpfr_t t;
1104a238c70SJohn Marino /* Declaration of the size variable */
1114a238c70SJohn Marino mpfr_prec_t Ny = MPFR_PREC(y); /* target precision */
1124a238c70SJohn Marino mpfr_prec_t Nt; /* working precision */
1134a238c70SJohn Marino mpfr_exp_t err, exp_te; /* error */
1144a238c70SJohn Marino MPFR_ZIV_DECL (loop);
1154a238c70SJohn Marino
1164a238c70SJohn Marino /* compute the precision of intermediary variable */
1174a238c70SJohn Marino /* the optimal number of bits : see algorithms.tex */
1184a238c70SJohn Marino Nt = Ny + MPFR_INT_CEIL_LOG2 (Ny) + 6;
1194a238c70SJohn Marino
1204a238c70SJohn Marino /* if |x| is smaller than 2^(-e), we will loose about e bits in the
1214a238c70SJohn Marino subtraction exp(x) - 1 */
1224a238c70SJohn Marino if (ex < 0)
1234a238c70SJohn Marino Nt += - ex;
1244a238c70SJohn Marino
1254a238c70SJohn Marino /* initialize auxiliary variable */
1264a238c70SJohn Marino mpfr_init2 (t, Nt);
1274a238c70SJohn Marino
1284a238c70SJohn Marino /* First computation of expm1 */
1294a238c70SJohn Marino MPFR_ZIV_INIT (loop, Nt);
1304a238c70SJohn Marino for (;;)
1314a238c70SJohn Marino {
1324a238c70SJohn Marino MPFR_BLOCK_DECL (flags);
1334a238c70SJohn Marino
1344a238c70SJohn Marino /* exp(x) may overflow and underflow */
1354a238c70SJohn Marino MPFR_BLOCK (flags, mpfr_exp (t, x, MPFR_RNDN));
1364a238c70SJohn Marino if (MPFR_OVERFLOW (flags))
1374a238c70SJohn Marino {
1384a238c70SJohn Marino inexact = mpfr_overflow (y, rnd_mode, MPFR_SIGN_POS);
1394a238c70SJohn Marino MPFR_SAVE_EXPO_UPDATE_FLAGS (expo, MPFR_FLAGS_OVERFLOW);
1404a238c70SJohn Marino break;
1414a238c70SJohn Marino }
1424a238c70SJohn Marino else if (MPFR_UNDERFLOW (flags))
1434a238c70SJohn Marino {
1444a238c70SJohn Marino inexact = mpfr_set_si (y, -1, rnd_mode);
1454a238c70SJohn Marino MPFR_ASSERTD (inexact == 0);
1464a238c70SJohn Marino inexact = -1;
1474a238c70SJohn Marino if (MPFR_IS_LIKE_RNDZ (rnd_mode, 1))
1484a238c70SJohn Marino {
1494a238c70SJohn Marino inexact = 1;
1504a238c70SJohn Marino mpfr_nexttozero (y);
1514a238c70SJohn Marino }
1524a238c70SJohn Marino break;
1534a238c70SJohn Marino }
1544a238c70SJohn Marino
1554a238c70SJohn Marino exp_te = MPFR_GET_EXP (t); /* FIXME: exp(x) may overflow! */
1564a238c70SJohn Marino mpfr_sub_ui (t, t, 1, MPFR_RNDN); /* exp(x)-1 */
1574a238c70SJohn Marino
1584a238c70SJohn Marino /* error estimate */
1594a238c70SJohn Marino /*err=Nt-(__gmpfr_ceil_log2(1+pow(2,MPFR_EXP(te)-MPFR_EXP(t))));*/
1604a238c70SJohn Marino err = Nt - (MAX (exp_te - MPFR_GET_EXP (t), 0) + 1);
1614a238c70SJohn Marino
1624a238c70SJohn Marino if (MPFR_LIKELY (MPFR_CAN_ROUND (t, err, Ny, rnd_mode)))
1634a238c70SJohn Marino {
1644a238c70SJohn Marino inexact = mpfr_set (y, t, rnd_mode);
1654a238c70SJohn Marino break;
1664a238c70SJohn Marino }
1674a238c70SJohn Marino
1684a238c70SJohn Marino /* increase the precision */
1694a238c70SJohn Marino MPFR_ZIV_NEXT (loop, Nt);
1704a238c70SJohn Marino mpfr_set_prec (t, Nt);
1714a238c70SJohn Marino }
1724a238c70SJohn Marino MPFR_ZIV_FREE (loop);
1734a238c70SJohn Marino
1744a238c70SJohn Marino mpfr_clear (t);
1754a238c70SJohn Marino }
1764a238c70SJohn Marino
1774a238c70SJohn Marino MPFR_SAVE_EXPO_FREE (expo);
1784a238c70SJohn Marino return mpfr_check_range (y, inexact, rnd_mode);
1794a238c70SJohn Marino }
180