Chris@102
|
1 // Copyright (c) 2015 John Maddock
|
Chris@102
|
2 // Use, modification and distribution are subject to the
|
Chris@102
|
3 // Boost Software License, Version 1.0. (See accompanying file
|
Chris@102
|
4 // LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt)
|
Chris@102
|
5 //
|
Chris@102
|
6 #ifndef BOOST_MATH_ELLINT_RG_HPP
|
Chris@102
|
7 #define BOOST_MATH_ELLINT_RG_HPP
|
Chris@102
|
8
|
Chris@102
|
9 #ifdef _MSC_VER
|
Chris@102
|
10 #pragma once
|
Chris@102
|
11 #endif
|
Chris@102
|
12
|
Chris@102
|
13 #include <boost/math/special_functions/math_fwd.hpp>
|
Chris@102
|
14 #include <boost/math/tools/config.hpp>
|
Chris@102
|
15 #include <boost/math/constants/constants.hpp>
|
Chris@102
|
16 #include <boost/math/policies/error_handling.hpp>
|
Chris@102
|
17 #include <boost/math/special_functions/ellint_rd.hpp>
|
Chris@102
|
18 #include <boost/math/special_functions/ellint_rf.hpp>
|
Chris@102
|
19 #include <boost/math/special_functions/pow.hpp>
|
Chris@102
|
20
|
Chris@102
|
21 namespace boost { namespace math { namespace detail{
|
Chris@102
|
22
|
Chris@102
|
23 template <typename T, typename Policy>
|
Chris@102
|
24 T ellint_rg_imp(T x, T y, T z, const Policy& pol)
|
Chris@102
|
25 {
|
Chris@102
|
26 BOOST_MATH_STD_USING
|
Chris@102
|
27 static const char* function = "boost::math::ellint_rf<%1%>(%1%,%1%,%1%)";
|
Chris@102
|
28
|
Chris@102
|
29 if(x < 0 || y < 0 || z < 0)
|
Chris@102
|
30 {
|
Chris@102
|
31 return policies::raise_domain_error<T>(function,
|
Chris@102
|
32 "domain error, all arguments must be non-negative, "
|
Chris@102
|
33 "only sensible result is %1%.",
|
Chris@102
|
34 std::numeric_limits<T>::quiet_NaN(), pol);
|
Chris@102
|
35 }
|
Chris@102
|
36 //
|
Chris@102
|
37 // Function is symmetric in x, y and z, but we require
|
Chris@102
|
38 // (x - z)(y - z) >= 0 to avoid cancellation error in the result
|
Chris@102
|
39 // which implies (for example) x >= z >= y
|
Chris@102
|
40 //
|
Chris@102
|
41 using std::swap;
|
Chris@102
|
42 if(x < y)
|
Chris@102
|
43 swap(x, y);
|
Chris@102
|
44 if(x < z)
|
Chris@102
|
45 swap(x, z);
|
Chris@102
|
46 if(y > z)
|
Chris@102
|
47 swap(y, z);
|
Chris@102
|
48
|
Chris@102
|
49 BOOST_ASSERT(x >= z);
|
Chris@102
|
50 BOOST_ASSERT(z >= y);
|
Chris@102
|
51 //
|
Chris@102
|
52 // Special cases from http://dlmf.nist.gov/19.20#ii
|
Chris@102
|
53 //
|
Chris@102
|
54 if(x == z)
|
Chris@102
|
55 {
|
Chris@102
|
56 if(y == z)
|
Chris@102
|
57 {
|
Chris@102
|
58 // x = y = z
|
Chris@102
|
59 // This also works for x = y = z = 0 presumably.
|
Chris@102
|
60 return sqrt(x);
|
Chris@102
|
61 }
|
Chris@102
|
62 else if(y == 0)
|
Chris@102
|
63 {
|
Chris@102
|
64 // x = y, z = 0
|
Chris@102
|
65 return constants::pi<T>() * sqrt(x) / 4;
|
Chris@102
|
66 }
|
Chris@102
|
67 else
|
Chris@102
|
68 {
|
Chris@102
|
69 // x = z, y != 0
|
Chris@102
|
70 swap(x, y);
|
Chris@102
|
71 return (x == 0) ? T(sqrt(z) / 2) : T((z * ellint_rc_imp(x, z, pol) + sqrt(x)) / 2);
|
Chris@102
|
72 }
|
Chris@102
|
73 }
|
Chris@102
|
74 else if(y == z)
|
Chris@102
|
75 {
|
Chris@102
|
76 if(x == 0)
|
Chris@102
|
77 return constants::pi<T>() * sqrt(y) / 4;
|
Chris@102
|
78 else
|
Chris@102
|
79 return (y == 0) ? T(sqrt(x) / 2) : T((y * ellint_rc_imp(x, y, pol) + sqrt(x)) / 2);
|
Chris@102
|
80 }
|
Chris@102
|
81 else if(y == 0)
|
Chris@102
|
82 {
|
Chris@102
|
83 swap(y, z);
|
Chris@102
|
84 //
|
Chris@102
|
85 // Special handling for common case, from
|
Chris@102
|
86 // Numerical Computation of Real or Complex Elliptic Integrals, eq.46
|
Chris@102
|
87 //
|
Chris@102
|
88 T xn = sqrt(x);
|
Chris@102
|
89 T yn = sqrt(y);
|
Chris@102
|
90 T x0 = xn;
|
Chris@102
|
91 T y0 = yn;
|
Chris@102
|
92 T sum = 0;
|
Chris@102
|
93 T sum_pow = 0.25f;
|
Chris@102
|
94
|
Chris@102
|
95 while(fabs(xn - yn) >= 2.7 * tools::root_epsilon<T>() * fabs(xn))
|
Chris@102
|
96 {
|
Chris@102
|
97 T t = sqrt(xn * yn);
|
Chris@102
|
98 xn = (xn + yn) / 2;
|
Chris@102
|
99 yn = t;
|
Chris@102
|
100 sum_pow *= 2;
|
Chris@102
|
101 sum += sum_pow * boost::math::pow<2>(xn - yn);
|
Chris@102
|
102 }
|
Chris@102
|
103 T RF = constants::pi<T>() / (xn + yn);
|
Chris@102
|
104 return ((boost::math::pow<2>((x0 + y0) / 2) - sum) * RF) / 2;
|
Chris@102
|
105 }
|
Chris@102
|
106 return (z * ellint_rf_imp(x, y, z, pol)
|
Chris@102
|
107 - (x - z) * (y - z) * ellint_rd_imp(x, y, z, pol) / 3
|
Chris@102
|
108 + sqrt(x * y / z)) / 2;
|
Chris@102
|
109 }
|
Chris@102
|
110
|
Chris@102
|
111 } // namespace detail
|
Chris@102
|
112
|
Chris@102
|
113 template <class T1, class T2, class T3, class Policy>
|
Chris@102
|
114 inline typename tools::promote_args<T1, T2, T3>::type
|
Chris@102
|
115 ellint_rg(T1 x, T2 y, T3 z, const Policy& pol)
|
Chris@102
|
116 {
|
Chris@102
|
117 typedef typename tools::promote_args<T1, T2, T3>::type result_type;
|
Chris@102
|
118 typedef typename policies::evaluation<result_type, Policy>::type value_type;
|
Chris@102
|
119 return policies::checked_narrowing_cast<result_type, Policy>(
|
Chris@102
|
120 detail::ellint_rg_imp(
|
Chris@102
|
121 static_cast<value_type>(x),
|
Chris@102
|
122 static_cast<value_type>(y),
|
Chris@102
|
123 static_cast<value_type>(z), pol), "boost::math::ellint_rf<%1%>(%1%,%1%,%1%)");
|
Chris@102
|
124 }
|
Chris@102
|
125
|
Chris@102
|
126 template <class T1, class T2, class T3>
|
Chris@102
|
127 inline typename tools::promote_args<T1, T2, T3>::type
|
Chris@102
|
128 ellint_rg(T1 x, T2 y, T3 z)
|
Chris@102
|
129 {
|
Chris@102
|
130 return ellint_rg(x, y, z, policies::policy<>());
|
Chris@102
|
131 }
|
Chris@102
|
132
|
Chris@102
|
133 }} // namespaces
|
Chris@102
|
134
|
Chris@102
|
135 #endif // BOOST_MATH_ELLINT_RG_HPP
|
Chris@102
|
136
|