1 // boost atanh.hpp header file
3 // (C) Copyright Hubert Holin 2001.
4 // (C) Copyright John Maddock 2008.
5 // Distributed under the Boost Software License, Version 1.0. (See
6 // accompanying file LICENSE_1_0.txt or copy at
7 // http://www.boost.org/LICENSE_1_0.txt)
9 // See http://www.boost.org for updates, documentation, and revision history.
11 #ifndef BOOST_ATANH_HPP
12 #define BOOST_ATANH_HPP
19 #include <boost/config/no_tr1/cmath.hpp>
20 #include <boost/config.hpp>
21 #include <boost/math/tools/precision.hpp>
22 #include <boost/math/policies/error_handling.hpp>
23 #include <boost/math/special_functions/math_fwd.hpp>
24 #include <boost/math/special_functions/log1p.hpp>
26 // This is the inverse of the hyperbolic tangent function.
34 #if defined(__GNUC__) && (__GNUC__ < 3)
35 // gcc 2.x ignores function scope using declarations,
36 // put them in the scope of the enclosing namespace instead:
42 using ::std::numeric_limits;
45 // This is the main fare
47 template<typename T, typename Policy>
48 inline T atanh_imp(const T x, const Policy& pol)
51 static const char* function = "boost::math::atanh<%1%>(%1%)";
55 return policies::raise_domain_error<T>(
57 "atanh requires x >= -1, but got x = %1%.", x, pol);
61 return policies::raise_domain_error<T>(
63 "atanh requires x <= 1, but got x = %1%.", x, pol);
65 else if(x < -1 + tools::epsilon<T>())
68 return -policies::raise_overflow_error<T>(function, 0, pol);
70 else if(x > 1 - tools::epsilon<T>())
73 return policies::raise_overflow_error<T>(function, 0, pol);
75 else if(abs(x) >= tools::forth_root_epsilon<T>())
77 // http://functions.wolfram.com/ElementaryFunctions/ArcTanh/02/
79 return (boost::math::log1p(x, pol) - boost::math::log1p(-x, pol)) / 2;
80 return(log( (1 + x) / (1 - x) ) / 2);
84 // http://functions.wolfram.com/ElementaryFunctions/ArcTanh/06/01/03/01/
85 // approximation by taylor series in x at 0 up to order 2
88 if (abs(x) >= tools::root_epsilon<T>())
92 // approximation by taylor series in x at 0 up to order 4
93 result += x3/static_cast<T>(3);
101 template<typename T, typename Policy>
102 inline typename tools::promote_args<T>::type atanh(T x, const Policy&)
104 typedef typename tools::promote_args<T>::type result_type;
105 typedef typename policies::evaluation<result_type, Policy>::type value_type;
106 typedef typename policies::normalise<
108 policies::promote_float<false>,
109 policies::promote_double<false>,
110 policies::discrete_quantile<>,
111 policies::assert_undefined<> >::type forwarding_policy;
112 return policies::checked_narrowing_cast<result_type, forwarding_policy>(
113 detail::atanh_imp(static_cast<value_type>(x), forwarding_policy()),
114 "boost::math::atanh<%1%>(%1%)");
117 inline typename tools::promote_args<T>::type atanh(T x)
119 return boost::math::atanh(x, policies::policy<>());
125 #endif /* BOOST_ATANH_HPP */