| // (C) Copyright John Maddock 2006. |
| // Use, modification and distribution are subject to the |
| // Boost Software License, Version 1.0. (See accompanying file |
| // LICENSE_1_0.txt or copy at http://www.boost.org/LICENSE_1_0.txt) |
| |
| #ifndef BOOST_MATH_SPECIAL_FUNCTIONS_DETAIL_LGAMMA_SMALL |
| #define BOOST_MATH_SPECIAL_FUNCTIONS_DETAIL_LGAMMA_SMALL |
| |
| #ifdef _MSC_VER |
| #pragma once |
| #endif |
| |
| namespace boost{ namespace math{ namespace detail{ |
| |
| // |
| // lgamma for small arguments: |
| // |
| template <class T, class Policy, class L> |
| T lgamma_small_imp(T z, T zm1, T zm2, const mpl::int_<64>&, const Policy& /* l */, const L&) |
| { |
| // This version uses rational approximations for small |
| // values of z accurate enough for 64-bit mantissas |
| // (80-bit long doubles), works well for 53-bit doubles as well. |
| // L is only used to select the Lanczos function. |
| |
| BOOST_MATH_STD_USING // for ADL of std names |
| T result = 0; |
| if(z < tools::epsilon<T>()) |
| { |
| result = -log(z); |
| } |
| else if((zm1 == 0) || (zm2 == 0)) |
| { |
| // nothing to do, result is zero.... |
| } |
| else if(z > 2) |
| { |
| // |
| // Begin by performing argument reduction until |
| // z is in [2,3): |
| // |
| if(z >= 3) |
| { |
| do |
| { |
| z -= 1; |
| zm2 -= 1; |
| result += log(z); |
| }while(z >= 3); |
| // Update zm2, we need it below: |
| zm2 = z - 2; |
| } |
| |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (z-2)(z+1)(Y + R(z-2)) |
| // |
| // where R(z-2) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // R(z-2) has the following properties: |
| // |
| // At double: Max error found: 4.231e-18 |
| // At long double: Max error found: 1.987e-21 |
| // Maximum Deviation Found (approximation error): 5.900e-24 |
| // |
| static const T P[] = { |
| static_cast<T>(-0.180355685678449379109e-1L), |
| static_cast<T>(0.25126649619989678683e-1L), |
| static_cast<T>(0.494103151567532234274e-1L), |
| static_cast<T>(0.172491608709613993966e-1L), |
| static_cast<T>(-0.259453563205438108893e-3L), |
| static_cast<T>(-0.541009869215204396339e-3L), |
| static_cast<T>(-0.324588649825948492091e-4L) |
| }; |
| static const T Q[] = { |
| static_cast<T>(0.1e1), |
| static_cast<T>(0.196202987197795200688e1L), |
| static_cast<T>(0.148019669424231326694e1L), |
| static_cast<T>(0.541391432071720958364e0L), |
| static_cast<T>(0.988504251128010129477e-1L), |
| static_cast<T>(0.82130967464889339326e-2L), |
| static_cast<T>(0.224936291922115757597e-3L), |
| static_cast<T>(-0.223352763208617092964e-6L) |
| }; |
| |
| static const float Y = 0.158963680267333984375e0f; |
| |
| T r = zm2 * (z + 1); |
| T R = tools::evaluate_polynomial(P, zm2); |
| R /= tools::evaluate_polynomial(Q, zm2); |
| |
| result += r * Y + r * R; |
| } |
| else |
| { |
| // |
| // If z is less than 1 use recurrance to shift to |
| // z in the interval [1,2]: |
| // |
| if(z < 1) |
| { |
| result += -log(z); |
| zm2 = zm1; |
| zm1 = z; |
| z += 1; |
| } |
| // |
| // Two approximations, on for z in [1,1.5] and |
| // one for z in [1.5,2]: |
| // |
| if(z <= 1.5) |
| { |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (z-1)(z-2)(Y + R(z-1)) |
| // |
| // where R(z-1) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // R(z-1) has the following properties: |
| // |
| // At double precision: Max error found: 1.230011e-17 |
| // At 80-bit long double precision: Max error found: 5.631355e-21 |
| // Maximum Deviation Found: 3.139e-021 |
| // Expected Error Term: 3.139e-021 |
| |
| // |
| static const float Y = 0.52815341949462890625f; |
| |
| static const T P[] = { |
| static_cast<T>(0.490622454069039543534e-1L), |
| static_cast<T>(-0.969117530159521214579e-1L), |
| static_cast<T>(-0.414983358359495381969e0L), |
| static_cast<T>(-0.406567124211938417342e0L), |
| static_cast<T>(-0.158413586390692192217e0L), |
| static_cast<T>(-0.240149820648571559892e-1L), |
| static_cast<T>(-0.100346687696279557415e-2L) |
| }; |
| static const T Q[] = { |
| static_cast<T>(0.1e1L), |
| static_cast<T>(0.302349829846463038743e1L), |
| static_cast<T>(0.348739585360723852576e1L), |
| static_cast<T>(0.191415588274426679201e1L), |
| static_cast<T>(0.507137738614363510846e0L), |
| static_cast<T>(0.577039722690451849648e-1L), |
| static_cast<T>(0.195768102601107189171e-2L) |
| }; |
| |
| T r = tools::evaluate_polynomial(P, zm1) / tools::evaluate_polynomial(Q, zm1); |
| T prefix = zm1 * zm2; |
| |
| result += prefix * Y + prefix * r; |
| } |
| else |
| { |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (2-z)(1-z)(Y + R(2-z)) |
| // |
| // where R(2-z) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // R(2-z) has the following properties: |
| // |
| // At double precision, max error found: 1.797565e-17 |
| // At 80-bit long double precision, max error found: 9.306419e-21 |
| // Maximum Deviation Found: 2.151e-021 |
| // Expected Error Term: 2.150e-021 |
| // |
| static const float Y = 0.452017307281494140625f; |
| |
| static const T P[] = { |
| static_cast<T>(-0.292329721830270012337e-1L), |
| static_cast<T>(0.144216267757192309184e0L), |
| static_cast<T>(-0.142440390738631274135e0L), |
| static_cast<T>(0.542809694055053558157e-1L), |
| static_cast<T>(-0.850535976868336437746e-2L), |
| static_cast<T>(0.431171342679297331241e-3L) |
| }; |
| static const T Q[] = { |
| static_cast<T>(0.1e1), |
| static_cast<T>(-0.150169356054485044494e1L), |
| static_cast<T>(0.846973248876495016101e0L), |
| static_cast<T>(-0.220095151814995745555e0L), |
| static_cast<T>(0.25582797155975869989e-1L), |
| static_cast<T>(-0.100666795539143372762e-2L), |
| static_cast<T>(-0.827193521891290553639e-6L) |
| }; |
| T r = zm2 * zm1; |
| T R = tools::evaluate_polynomial(P, -zm2) / tools::evaluate_polynomial(Q, -zm2); |
| |
| result += r * Y + r * R; |
| } |
| } |
| return result; |
| } |
| template <class T, class Policy, class L> |
| T lgamma_small_imp(T z, T zm1, T zm2, const mpl::int_<113>&, const Policy& /* l */, const L&) |
| { |
| // |
| // This version uses rational approximations for small |
| // values of z accurate enough for 113-bit mantissas |
| // (128-bit long doubles). |
| // |
| BOOST_MATH_STD_USING // for ADL of std names |
| T result = 0; |
| if(z < tools::epsilon<T>()) |
| { |
| result = -log(z); |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| } |
| else if((zm1 == 0) || (zm2 == 0)) |
| { |
| // nothing to do, result is zero.... |
| } |
| else if(z > 2) |
| { |
| // |
| // Begin by performing argument reduction until |
| // z is in [2,3): |
| // |
| if(z >= 3) |
| { |
| do |
| { |
| z -= 1; |
| result += log(z); |
| }while(z >= 3); |
| zm2 = z - 2; |
| } |
| BOOST_MATH_INSTRUMENT_CODE(zm2); |
| BOOST_MATH_INSTRUMENT_CODE(z); |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (z-2)(z+1)(Y + R(z-2)) |
| // |
| // where R(z-2) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // Maximum Deviation Found (approximation error) 3.73e-37 |
| |
| static const T P[] = { |
| -0.018035568567844937910504030027467476655L, |
| 0.013841458273109517271750705401202404195L, |
| 0.062031842739486600078866923383017722399L, |
| 0.052518418329052161202007865149435256093L, |
| 0.01881718142472784129191838493267755758L, |
| 0.0025104830367021839316463675028524702846L, |
| -0.00021043176101831873281848891452678568311L, |
| -0.00010249622350908722793327719494037981166L, |
| -0.11381479670982006841716879074288176994e-4L, |
| -0.49999811718089980992888533630523892389e-6L, |
| -0.70529798686542184668416911331718963364e-8L |
| }; |
| static const T Q[] = { |
| 1L, |
| 2.5877485070422317542808137697939233685L, |
| 2.8797959228352591788629602533153837126L, |
| 1.8030885955284082026405495275461180977L, |
| 0.69774331297747390169238306148355428436L, |
| 0.17261566063277623942044077039756583802L, |
| 0.02729301254544230229429621192443000121L, |
| 0.0026776425891195270663133581960016620433L, |
| 0.00015244249160486584591370355730402168106L, |
| 0.43997034032479866020546814475414346627e-5L, |
| 0.46295080708455613044541885534408170934e-7L, |
| -0.93326638207459533682980757982834180952e-11L, |
| 0.42316456553164995177177407325292867513e-13L |
| }; |
| |
| T R = tools::evaluate_polynomial(P, zm2); |
| R /= tools::evaluate_polynomial(Q, zm2); |
| |
| static const float Y = 0.158963680267333984375F; |
| |
| T r = zm2 * (z + 1); |
| |
| result += r * Y + r * R; |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| } |
| else |
| { |
| // |
| // If z is less than 1 use recurrance to shift to |
| // z in the interval [1,2]: |
| // |
| if(z < 1) |
| { |
| result += -log(z); |
| zm2 = zm1; |
| zm1 = z; |
| z += 1; |
| } |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| BOOST_MATH_INSTRUMENT_CODE(z); |
| BOOST_MATH_INSTRUMENT_CODE(zm2); |
| // |
| // Three approximations, on for z in [1,1.35], [1.35,1.625] and [1.625,1] |
| // |
| if(z <= 1.35) |
| { |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (z-1)(z-2)(Y + R(z-1)) |
| // |
| // where R(z-1) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // R(z-1) has the following properties: |
| // |
| // Maximum Deviation Found (approximation error) 1.659e-36 |
| // Expected Error Term (theoretical error) 1.343e-36 |
| // Max error found at 128-bit long double precision 1.007e-35 |
| // |
| static const float Y = 0.54076099395751953125f; |
| |
| static const T P[] = { |
| 0.036454670944013329356512090082402429697L, |
| -0.066235835556476033710068679907798799959L, |
| -0.67492399795577182387312206593595565371L, |
| -1.4345555263962411429855341651960000166L, |
| -1.4894319559821365820516771951249649563L, |
| -0.87210277668067964629483299712322411566L, |
| -0.29602090537771744401524080430529369136L, |
| -0.0561832587517836908929331992218879676L, |
| -0.0053236785487328044334381502530383140443L, |
| -0.00018629360291358130461736386077971890789L, |
| -0.10164985672213178500790406939467614498e-6L, |
| 0.13680157145361387405588201461036338274e-8L |
| }; |
| static const T Q[] = { |
| 1, |
| 4.9106336261005990534095838574132225599L, |
| 10.258804800866438510889341082793078432L, |
| 11.88588976846826108836629960537466889L, |
| 8.3455000546999704314454891036700998428L, |
| 3.6428823682421746343233362007194282703L, |
| 0.97465989807254572142266753052776132252L, |
| 0.15121052897097822172763084966793352524L, |
| 0.012017363555383555123769849654484594893L, |
| 0.0003583032812720649835431669893011257277L |
| }; |
| |
| T r = tools::evaluate_polynomial(P, zm1) / tools::evaluate_polynomial(Q, zm1); |
| T prefix = zm1 * zm2; |
| |
| result += prefix * Y + prefix * r; |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| } |
| else if(z <= 1.625) |
| { |
| // |
| // Use the following form: |
| // |
| // lgamma(z) = (2-z)(1-z)(Y + R(2-z)) |
| // |
| // where R(2-z) is a rational approximation optimised for |
| // low absolute error - as long as it's absolute error |
| // is small compared to the constant Y - then any rounding |
| // error in it's computation will get wiped out. |
| // |
| // R(2-z) has the following properties: |
| // |
| // Max error found at 128-bit long double precision 9.634e-36 |
| // Maximum Deviation Found (approximation error) 1.538e-37 |
| // Expected Error Term (theoretical error) 2.350e-38 |
| // |
| static const float Y = 0.483787059783935546875f; |
| |
| static const T P[] = { |
| -0.017977422421608624353488126610933005432L, |
| 0.18484528905298309555089509029244135703L, |
| -0.40401251514859546989565001431430884082L, |
| 0.40277179799147356461954182877921388182L, |
| -0.21993421441282936476709677700477598816L, |
| 0.069595742223850248095697771331107571011L, |
| -0.012681481427699686635516772923547347328L, |
| 0.0012489322866834830413292771335113136034L, |
| -0.57058739515423112045108068834668269608e-4L, |
| 0.8207548771933585614380644961342925976e-6L |
| }; |
| static const T Q[] = { |
| 1, |
| -2.9629552288944259229543137757200262073L, |
| 3.7118380799042118987185957298964772755L, |
| -2.5569815272165399297600586376727357187L, |
| 1.0546764918220835097855665680632153367L, |
| -0.26574021300894401276478730940980810831L, |
| 0.03996289731752081380552901986471233462L, |
| -0.0033398680924544836817826046380586480873L, |
| 0.00013288854760548251757651556792598235735L, |
| -0.17194794958274081373243161848194745111e-5L |
| }; |
| T r = zm2 * zm1; |
| T R = tools::evaluate_polynomial(P, 0.625 - zm1) / tools::evaluate_polynomial(Q, 0.625 - zm1); |
| |
| result += r * Y + r * R; |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| } |
| else |
| { |
| // |
| // Same form as above. |
| // |
| // Max error found (at 128-bit long double precision) 1.831e-35 |
| // Maximum Deviation Found (approximation error) 8.588e-36 |
| // Expected Error Term (theoretical error) 1.458e-36 |
| // |
| static const float Y = 0.443811893463134765625f; |
| |
| static const T P[] = { |
| -0.021027558364667626231512090082402429494L, |
| 0.15128811104498736604523586803722368377L, |
| -0.26249631480066246699388544451126410278L, |
| 0.21148748610533489823742352180628489742L, |
| -0.093964130697489071999873506148104370633L, |
| 0.024292059227009051652542804957550866827L, |
| -0.0036284453226534839926304745756906117066L, |
| 0.0002939230129315195346843036254392485984L, |
| -0.11088589183158123733132268042570710338e-4L, |
| 0.13240510580220763969511741896361984162e-6L |
| }; |
| static const T Q[] = { |
| 1, |
| -2.4240003754444040525462170802796471996L, |
| 2.4868383476933178722203278602342786002L, |
| -1.4047068395206343375520721509193698547L, |
| 0.47583809087867443858344765659065773369L, |
| -0.09865724264554556400463655444270700132L, |
| 0.012238223514176587501074150988445109735L, |
| -0.00084625068418239194670614419707491797097L, |
| 0.2796574430456237061420839429225710602e-4L, |
| -0.30202973883316730694433702165188835331e-6L |
| }; |
| // (2 - x) * (1 - x) * (c + R(2 - x)) |
| T r = zm2 * zm1; |
| T R = tools::evaluate_polynomial(P, -zm2) / tools::evaluate_polynomial(Q, -zm2); |
| |
| result += r * Y + r * R; |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| } |
| } |
| BOOST_MATH_INSTRUMENT_CODE(result); |
| return result; |
| } |
| template <class T, class Policy, class L> |
| T lgamma_small_imp(T z, T zm1, T zm2, const mpl::int_<0>&, const Policy& pol, const L&) |
| { |
| // |
| // No rational approximations are available because either |
| // T has no numeric_limits support (so we can't tell how |
| // many digits it has), or T has more digits than we know |
| // what to do with.... we do have a Lanczos approximation |
| // though, and that can be used to keep errors under control. |
| // |
| BOOST_MATH_STD_USING // for ADL of std names |
| T result = 0; |
| if(z < tools::epsilon<T>()) |
| { |
| result = -log(z); |
| } |
| else if(z < 0.5) |
| { |
| // taking the log of tgamma reduces the error, no danger of overflow here: |
| result = log(gamma_imp(z, pol, L())); |
| } |
| else if(z >= 3) |
| { |
| // taking the log of tgamma reduces the error, no danger of overflow here: |
| result = log(gamma_imp(z, pol, L())); |
| } |
| else if(z >= 1.5) |
| { |
| // special case near 2: |
| T dz = zm2; |
| result = dz * log((z + L::g() - T(0.5)) / boost::math::constants::e<T>()); |
| result += boost::math::log1p(dz / (L::g() + T(1.5)), pol) * T(1.5); |
| result += boost::math::log1p(L::lanczos_sum_near_2(dz), pol); |
| } |
| else |
| { |
| // special case near 1: |
| T dz = zm1; |
| result = dz * log((z + L::g() - T(0.5)) / boost::math::constants::e<T>()); |
| result += boost::math::log1p(dz / (L::g() + T(0.5)), pol) / 2; |
| result += boost::math::log1p(L::lanczos_sum_near_1(dz), pol); |
| } |
| return result; |
| } |
| |
| }}} // namespaces |
| |
| #endif // BOOST_MATH_SPECIAL_FUNCTIONS_DETAIL_LGAMMA_SMALL |
| |