w4kek/WSJT-X
1
0
Fork 0
mirror of https://github.com/saitohirga/WSJT-X.git synced 2025-10-31 13:10:19 -04:00
Code Issues Packages Projects Releases Wiki Activity
WSJT-X/boost/libs/math/doc/html/math_toolkit/bessel/mbessel.html

1123 lines
54 KiB
HTML
Raw Normal View History

Squashed 'boost/' content from commit b4feb19f2 git-subtree-dir: boost git-subtree-split: b4feb19f287ee92d87a9624b5d36b7cf46aeadeb
2018-06-09 21:48:32 +01:00
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
<title>Modified Bessel Functions of the First and Second Kinds</title>
<link rel="stylesheet" href="../../math.css" type="text/css">
<meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
<link rel="home" href="../../index.html" title="Math Toolkit 2.5.1">
<link rel="up" href="../bessel.html" title="Bessel Functions">
<link rel="prev" href="bessel_root.html" title="Finding Zeros of Bessel Functions of the First and Second Kinds">
<link rel="next" href="sph_bessel.html" title="Spherical Bessel Functions of the First and Second Kinds">
</head>
<body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
<table cellpadding="2" width="100%"><tr>
<td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
<td align="center"><a href="../../../../../../index.html">Home</a></td>
<td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
<td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
<td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
<td align="center"><a href="../../../../../../more/index.htm">More</a></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="bessel_root.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../bessel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="sph_bessel.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
<div class="section">
<div class="titlepage"><div><div><h3 class="title">
<a name="math_toolkit.bessel.mbessel"></a><a class="link" href="mbessel.html" title="Modified Bessel Functions of the First and Second Kinds">Modified Bessel Functions
of the First and Second Kinds</a>
</h3></div></div></div>
<h5>
<a name="math_toolkit.bessel.mbessel.h0"></a>
<span class="phrase"><a name="math_toolkit.bessel.mbessel.synopsis"></a></span><a class="link" href="mbessel.html#math_toolkit.bessel.mbessel.synopsis">Synopsis</a>
</h5>
<p>
<code class="computeroutput"><span class="preprocessor">#include</span> <span class="special">&lt;</span><span class="identifier">boost</span><span class="special">/</span><span class="identifier">math</span><span class="special">/</span><span class="identifier">special_functions</span><span class="special">/</span><span class="identifier">bessel</span><span class="special">.</span><span class="identifier">hpp</span><span class="special">&gt;</span></code>
</p>
<pre class="programlisting"><span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">T2</span><span class="special">&gt;</span>
<a class="link" href="../result_type.html" title="Calculation of the Type of the Result"><span class="emphasis"><em>calculated-result-type</em></span></a> <span class="identifier">cyl_bessel_i</span><span class="special">(</span><span class="identifier">T1</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">T2</span> <span class="identifier">x</span><span class="special">);</span>
<span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">T2</span><span class="special">,</span> <span class="keyword">class</span> <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">Policy</a><span class="special">&gt;</span>
<a class="link" href="../result_type.html" title="Calculation of the Type of the Result"><span class="emphasis"><em>calculated-result-type</em></span></a> <span class="identifier">cyl_bessel_i</span><span class="special">(</span><span class="identifier">T1</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">T2</span> <span class="identifier">x</span><span class="special">,</span> <span class="keyword">const</span> <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">Policy</a><span class="special">&amp;);</span>
<span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">T2</span><span class="special">&gt;</span>
<a class="link" href="../result_type.html" title="Calculation of the Type of the Result"><span class="emphasis"><em>calculated-result-type</em></span></a> <span class="identifier">cyl_bessel_k</span><span class="special">(</span><span class="identifier">T1</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">T2</span> <span class="identifier">x</span><span class="special">);</span>
<span class="keyword">template</span> <span class="special">&lt;</span><span class="keyword">class</span> <span class="identifier">T1</span><span class="special">,</span> <span class="keyword">class</span> <span class="identifier">T2</span><span class="special">,</span> <span class="keyword">class</span> <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">Policy</a><span class="special">&gt;</span>
<a class="link" href="../result_type.html" title="Calculation of the Type of the Result"><span class="emphasis"><em>calculated-result-type</em></span></a> <span class="identifier">cyl_bessel_k</span><span class="special">(</span><span class="identifier">T1</span> <span class="identifier">v</span><span class="special">,</span> <span class="identifier">T2</span> <span class="identifier">x</span><span class="special">,</span> <span class="keyword">const</span> <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">Policy</a><span class="special">&amp;);</span>
</pre>
<h5>
<a name="math_toolkit.bessel.mbessel.h1"></a>
<span class="phrase"><a name="math_toolkit.bessel.mbessel.description"></a></span><a class="link" href="mbessel.html#math_toolkit.bessel.mbessel.description">Description</a>
</h5>
<p>
The functions <a class="link" href="mbessel.html" title="Modified Bessel Functions of the First and Second Kinds">cyl_bessel_i</a>
and <a class="link" href="mbessel.html" title="Modified Bessel Functions of the First and Second Kinds">cyl_bessel_k</a> return
the result of the modified Bessel functions of the first and second kind
respectively:
</p>
<p>
cyl_bessel_i(v, x) = I<sub>v</sub>(x)
</p>
<p>
cyl_bessel_k(v, x) = K<sub>v</sub>(x)
</p>
<p>
where:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel2.svg"></span>
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel3.svg"></span>
</p>
<p>
The return type of these functions is computed using the <a class="link" href="../result_type.html" title="Calculation of the Type of the Result"><span class="emphasis"><em>result
type calculation rules</em></span></a> when T1 and T2 are different types.
The functions are also optimised for the relatively common case that T1 is
an integer.
</p>
<p>
The final <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">Policy</a> argument is optional and can
be used to control the behaviour of the function: how it handles errors,
what level of precision to use etc. Refer to the <a class="link" href="../../policy.html" title="Chapter&#160;15.&#160;Policies: Controlling Precision, Error Handling etc">policy
documentation for more details</a>.
</p>
<p>
The functions return the result of <a class="link" href="../error_handling.html#math_toolkit.error_handling.domain_error">domain_error</a>
whenever the result is undefined or complex. For <a class="link" href="bessel_first.html" title="Bessel Functions of the First and Second Kinds">cyl_bessel_j</a>
this occurs when <code class="computeroutput"><span class="identifier">x</span> <span class="special">&lt;</span>
<span class="number">0</span></code> and v is not an integer, or when
<code class="computeroutput"><span class="identifier">x</span> <span class="special">==</span>
<span class="number">0</span></code> and <code class="computeroutput"><span class="identifier">v</span>
<span class="special">!=</span> <span class="number">0</span></code>.
For <a class="link" href="bessel_first.html" title="Bessel Functions of the First and Second Kinds">cyl_neumann</a> this
occurs when <code class="computeroutput"><span class="identifier">x</span> <span class="special">&lt;=</span>
<span class="number">0</span></code>.
</p>
<p>
The following graph illustrates the exponential behaviour of I<sub>v</sub>.
</p>
<p>
<span class="inlinemediaobject"><img src="../../../graphs/cyl_bessel_i.svg" align="middle"></span>
</p>
<p>
The following graph illustrates the exponential decay of K<sub>v</sub>.
</p>
<p>
<span class="inlinemediaobject"><img src="../../../graphs/cyl_bessel_k.svg" align="middle"></span>
</p>
<h5>
<a name="math_toolkit.bessel.mbessel.h2"></a>
<span class="phrase"><a name="math_toolkit.bessel.mbessel.testing"></a></span><a class="link" href="mbessel.html#math_toolkit.bessel.mbessel.testing">Testing</a>
</h5>
<p>
There are two sets of test values: spot values calculated using <a href="http://functions.wolfram.com" target="_top">functions.wolfram.com</a>,
and a much larger set of tests computed using a simplified version of this
implementation (with all the special case handling removed).
</p>
<h5>
<a name="math_toolkit.bessel.mbessel.h3"></a>
<span class="phrase"><a name="math_toolkit.bessel.mbessel.accuracy"></a></span><a class="link" href="mbessel.html#math_toolkit.bessel.mbessel.accuracy">Accuracy</a>
</h5>
<p>
The following tables show how the accuracy of these functions varies on various
platforms, along with comparison to other libraries. Note that only results
for the widest floating-point type on the system are given, as narrower types
have <a class="link" href="../relative_error.html#math_toolkit.relative_error.zero_error">effectively zero
error</a>. All values are relative errors in units of epsilon. Note that
our test suite includes some fairly extreme inputs which results in most
of the worst problem cases in other libraries:
</p>
<div class="table">
<a name="math_toolkit.bessel.mbessel.table_cyl_bessel_i_integer_orders_"></a><p class="title"><b>Table&#160;6.44.&#160;Error rates for cyl_bessel_i (integer orders)</b></p>
<div class="table-contents"><table class="table" summary="Error rates for cyl_bessel_i (integer orders)">
<colgroup>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th>
</th>
<th>
<p>
Microsoft Visual C++ version 12.0<br> Win32<br> double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> long double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> double
</p>
</th>
<th>
<p>
Sun compiler version 0x5130<br> Sun Solaris<br> long double
</p>
</th>
</tr></thead>
<tbody>
<tr>
<td>
<p>
Bessel I0: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.877&#949; (Mean = 0.549&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.57&#949; (Mean = 2.1&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 8.49&#949; (Mean = 3.46&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i_integer_orders___tr1_cmath__Bessel_I0_Mathworld_Data_Integer_Version_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 0.79&#949; (Mean = 0.482&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> <span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Rmath_3_0_2_Bessel_I0_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 2.55e+43&#949; (Mean = 8.06e+42&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Cephes_Bessel_I0_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.54&#949; (Mean = 2.11&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel I1: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.885&#949; (Mean = 0.55&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.83&#949; (Mean = 2.79&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 5&#949; (Mean = 2.15&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i_integer_orders___tr1_cmath__Bessel_I1_Mathworld_Data_Integer_Version_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 0.82&#949; (Mean = 0.456&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> <span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Rmath_3_0_2_Bessel_I1_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 1.28e+43&#949; (Mean = 4.05e+42&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Cephes_Bessel_I1_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 6.52&#949; (Mean = 2.25&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel In: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.46&#949; (Mean = 1.32&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.33&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 430&#949; (Mean = 163&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i_integer_orders___tr1_cmath__Bessel_In_Mathworld_Data_Integer_Version_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 5.15&#949; (Mean = 2.13&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__GSL_1_16_Bessel_In_Mathworld_Data_Integer_Version_">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Rmath_3_0_2_Bessel_In_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 3.67e+177&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_integer_orders__Cephes_Bessel_In_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 463&#949; (Mean = 140&#949;)</span>
</p>
</td>
</tr>
</tbody>
</table></div>
</div>
<br class="table-break"><div class="table">
<a name="math_toolkit.bessel.mbessel.table_cyl_bessel_i"></a><p class="title"><b>Table&#160;6.45.&#160;Error rates for cyl_bessel_i</b></p>
<div class="table-contents"><table class="table" summary="Error rates for cyl_bessel_i">
<colgroup>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th>
</th>
<th>
<p>
Microsoft Visual C++ version 12.0<br> Win32<br> double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> long double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> double
</p>
</th>
<th>
<p>
Sun compiler version 0x5130<br> Sun Solaris<br> long double
</p>
</th>
</tr></thead>
<tbody>
<tr>
<td>
<p>
Bessel I0: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.877&#949; (Mean = 0.549&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.57&#949; (Mean = 2.1&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 8.49&#949; (Mean = 3.46&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_I0_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 270&#949; (Mean = 91.6&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_I0_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Rmath_3_0_2_Bessel_I0_Mathworld_Data">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 2.55e+43&#949; (Mean = 8.06e+42&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Cephes_Bessel_I0_Mathworld_Data">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.54&#949; (Mean = 2.11&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel I1: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.885&#949; (Mean = 0.55&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.83&#949; (Mean = 2.79&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 5&#949; (Mean = 2.15&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_I1_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 128&#949; (Mean = 41&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_I1_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Rmath_3_0_2_Bessel_I1_Mathworld_Data">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 1.28e+43&#949; (Mean = 4.05e+42&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Cephes_Bessel_I1_Mathworld_Data">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 6.52&#949; (Mean = 2.25&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel In: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.46&#949; (Mean = 1.32&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.33&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 430&#949; (Mean = 163&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_In_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 2.31&#949; (Mean = 0.838&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_In_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Rmath_3_0_2_Bessel_In_Mathworld_Data">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = 3.67e+177&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Cephes_Bessel_In_Mathworld_Data">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 463&#949; (Mean = 140&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Iv: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 2.97&#949; (Mean = 1.33&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.12&#949; (Mean = 1.85&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 616&#949; (Mean = 221&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_Iv_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 5.95&#949; (Mean = 2.08&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_Iv_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 1e+04&#949; (Mean = 3.18e+03&#949;))<br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Cephes_Bessel_Iv_Mathworld_Data">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.12&#949; (Mean = 1.95&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel In: Random Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 9.67&#949; (Mean = 1.89&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 6.79&#949; (Mean = 1.15&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 645&#949; (Mean = 132&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 261&#949; (Mean = 53.2&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_In_Random_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 7.37&#949; (Mean = 2.4&#949;))<br> (<span class="emphasis"><em>Cephes:</em></span> Max
= 4.22e+06&#949; (Mean = 2.26e+05&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 176&#949; (Mean = 39.2&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Iv: Random Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.46&#949; (Mean = 1.54&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 8.35&#949; (Mean = 1.49&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 1.05e+03&#949; (Mean =
224&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_Iv_Random_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.661&#949; (Mean = 0.0441&#949;)</span><br>
<br> (<span class="emphasis"><em>GSL 1.16:</em></span> Max = 6.18e+03&#949; (Mean = 1.55e+03&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_Iv_Random_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = 4.28e+08&#949; (Mean = 2.85e+07&#949;))</span><br>
(<span class="emphasis"><em>Cephes:</em></span> <span class="red">Max = 6e+30&#949; (Mean
= 4e+29&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Cephes_Bessel_Iv_Random_Data">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 283&#949; (Mean = 88.4&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Iv: Mathworld Data (large values)
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.67&#949; (Mean = 1.64&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 14.7&#949; (Mean = 6.57&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 118&#949; (Mean = 57.2&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_i__tr1_cmath__Bessel_Iv_Mathworld_Data_large_values_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 37&#949; (Mean = 18&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_GSL_1_16_Bessel_Iv_Mathworld_Data_large_values_">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
<span class="red">Max = 3.77e+168&#949; (Mean = 2.39e+168&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_i_Rmath_3_0_2_Bessel_Iv_Mathworld_Data_large_values_">And
other failures.</a>)</span><br> (<span class="emphasis"><em>Cephes:</em></span>
Max = 73.7&#949; (Mean = 58.5&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 14.7&#949; (Mean = 6.59&#949;)</span>
</p>
</td>
</tr>
</tbody>
</table></div>
</div>
<br class="table-break"><div class="table">
<a name="math_toolkit.bessel.mbessel.table_cyl_bessel_k_integer_orders_"></a><p class="title"><b>Table&#160;6.46.&#160;Error rates for cyl_bessel_k (integer orders)</b></p>
<div class="table-contents"><table class="table" summary="Error rates for cyl_bessel_k (integer orders)">
<colgroup>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th>
</th>
<th>
<p>
Microsoft Visual C++ version 12.0<br> Win32<br> double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> long double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> double
</p>
</th>
<th>
<p>
Sun compiler version 0x5130<br> Sun Solaris<br> long double
</p>
</th>
</tr></thead>
<tbody>
<tr>
<td>
<p>
Bessel K0: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.55&#949; (Mean = 0.837&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.16&#949; (Mean = 1.46&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 9.33&#949; (Mean = 3.25&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 1.2&#949; (Mean = 0.733&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> Max = 0.833&#949; (Mean = 0.601&#949;))<br> (<span class="emphasis"><em>Cephes:</em></span>
Max = 1.1e+06&#949; (Mean = 3.68e+05&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.16&#949; (Mean = 1.49&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel K1: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 1&#949; (Mean = 0.573&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.02&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 8.94&#949; (Mean = 3.19&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 0.626&#949; (Mean = 0.333&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> Max = 0.894&#949; (Mean = 0.516&#949;))<br> (<span class="emphasis"><em>Cephes:</em></span>
Max = 5.38e+05&#949; (Mean = 1.79e+05&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.02&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kn: Mathworld Data (Integer Version)
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.63&#949; (Mean = 1.46&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.48&#949; (Mean = 2.14&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 12.9&#949; (Mean = 4.91&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_k_integer_orders___tr1_cmath__Bessel_Kn_Mathworld_Data_Integer_Version_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 168&#949; (Mean = 59.5&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> Max = 8.48&#949; (Mean = 2.98&#949;))<br> (<span class="emphasis"><em>Cephes:</em></span>
<span class="red">Max = +INF&#949; (Mean = +INF&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_integer_orders__Cephes_Bessel_Kn_Mathworld_Data_Integer_Version_">And
other failures.</a>)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.48&#949; (Mean = 1.98&#949;)</span>
</p>
</td>
</tr>
</tbody>
</table></div>
</div>
<br class="table-break"><div class="table">
<a name="math_toolkit.bessel.mbessel.table_cyl_bessel_k"></a><p class="title"><b>Table&#160;6.47.&#160;Error rates for cyl_bessel_k</b></p>
<div class="table-contents"><table class="table" summary="Error rates for cyl_bessel_k">
<colgroup>
<col>
<col>
<col>
<col>
<col>
</colgroup>
<thead><tr>
<th>
</th>
<th>
<p>
Microsoft Visual C++ version 12.0<br> Win32<br> double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> long double
</p>
</th>
<th>
<p>
GNU C++ version 5.1.0<br> linux<br> double
</p>
</th>
<th>
<p>
Sun compiler version 0x5130<br> Sun Solaris<br> long double
</p>
</th>
</tr></thead>
<tbody>
<tr>
<td>
<p>
Bessel K0: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.55&#949; (Mean = 0.837&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.16&#949; (Mean = 1.46&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 9.33&#949; (Mean = 3.25&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 6.04&#949; (Mean = 2.16&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> Max = 0.833&#949; (Mean = 0.601&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.16&#949; (Mean = 1.49&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel K1: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 1&#949; (Mean = 0.573&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.02&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 8.94&#949; (Mean = 3.19&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 6.26&#949; (Mean = 2.21&#949;))<br> (<span class="emphasis"><em>Rmath
3.0.2:</em></span> Max = 0.894&#949; (Mean = 0.516&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 1.8&#949; (Mean = 1.02&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kn: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.63&#949; (Mean = 1.46&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.48&#949; (Mean = 2.14&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 12.9&#949; (Mean = 4.91&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_k__tr1_cmath__Bessel_Kn_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 3.36&#949; (Mean = 1.43&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_GSL_1_16_Bessel_Kn_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 8.48&#949; (Mean = 2.98&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.48&#949; (Mean = 1.98&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kv: Mathworld Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.78&#949; (Mean = 2.2&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.58&#949; (Mean = 2.44&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 13&#949; (Mean = 4.81&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_k__tr1_cmath__Bessel_Kv_Mathworld_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 5.47&#949; (Mean = 2.04&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_GSL_1_16_Bessel_Kv_Mathworld_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 3.15&#949; (Mean = 1.35&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 3.58&#949; (Mean = 2.29&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kv: Mathworld Data (large values)
</p>
</td>
<td>
<p>
<span class="blue">Max = 59.8&#949; (Mean = 26.9&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 42.3&#949; (Mean = 21&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 42.3&#949; (Mean = 19.8&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_k__tr1_cmath__Bessel_Kv_Mathworld_Data_large_values_">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0&#949; (Mean = 0&#949;)</span><br> <br> (<span class="emphasis"><em>GSL
1.16:</em></span> Max = 308&#949; (Mean = 142&#949;) <a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_GSL_1_16_Bessel_Kv_Mathworld_Data_large_values_">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 84.6&#949; (Mean = 37.8&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 43.1&#949; (Mean = 21.3&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kn: Random Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.47&#949; (Mean = 1.4&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.55&#949; (Mean = 1.09&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 13.9&#949; (Mean = 2.91&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.764&#949; (Mean = 0.0348&#949;)</span><br>
<br> (<span class="emphasis"><em>GSL 1.16:</em></span> Max = 8.71&#949; (Mean = 1.76&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_GSL_1_16_Bessel_Kn_Random_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 7.47&#949; (Mean = 1.34&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 4.55&#949; (Mean = 1.21&#949;)</span>
</p>
</td>
</tr>
<tr>
<td>
<p>
Bessel Kv: Random Data
</p>
</td>
<td>
<p>
<span class="blue">Max = 8.33&#949; (Mean = 1.62&#949;)</span>
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.88&#949; (Mean = 1.48&#949;)</span><br> <br>
(<span class="emphasis"><em>&lt;tr1/cmath&gt;:</em></span> Max = 13.6&#949; (Mean = 2.68&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_long_double_cyl_bessel_k__tr1_cmath__Bessel_Kv_Random_Data">And
other failures.</a>)
</p>
</td>
<td>
<p>
<span class="blue">Max = 0.507&#949; (Mean = 0.0313&#949;)</span><br>
<br> (<span class="emphasis"><em>GSL 1.16:</em></span> Max = 9.71&#949; (Mean = 1.47&#949;)
<a class="link" href="../logs_and_tables/logs.html#errors_GNU_C_version_5_1_0_linux_double_cyl_bessel_k_GSL_1_16_Bessel_Kv_Random_Data">And
other failures.</a>)<br> (<span class="emphasis"><em>Rmath 3.0.2:</em></span>
Max = 7.37&#949; (Mean = 1.49&#949;))
</p>
</td>
<td>
<p>
<span class="blue">Max = 7.88&#949; (Mean = 1.49&#949;)</span>
</p>
</td>
</tr>
</tbody>
</table></div>
</div>
<br class="table-break"><h5>
<a name="math_toolkit.bessel.mbessel.h4"></a>
<span class="phrase"><a name="math_toolkit.bessel.mbessel.implementation"></a></span><a class="link" href="mbessel.html#math_toolkit.bessel.mbessel.implementation">Implementation</a>
</h5>
<p>
The following are handled as special cases first:
</p>
<p>
When computing I<sub>v</sub> &#160; for <span class="emphasis"><em>x &lt; 0</em></span>, then &#957; &#160; must be an integer
or a domain error occurs. If &#957; &#160; is an integer, then the function is odd if &#957; &#160; is
odd and even if &#957; &#160; is even, and we can reflect to <span class="emphasis"><em>x &gt; 0</em></span>.
</p>
<p>
For I<sub>v</sub> &#160; with v equal to 0, 1 or 0.5 are handled as special cases.
</p>
<p>
The 0 and 1 cases use minimax rational approximations on finite and infinite
intervals. The coefficients are from:
</p>
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
<li class="listitem">
J.M. Blair and C.A. Edwards, <span class="emphasis"><em>Stable rational minimax approximations
to the modified Bessel functions I_0(x) and I_1(x)</em></span>, Atomic
Energy of Canada Limited Report 4928, Chalk River, 1974.
</li>
<li class="listitem">
S. Moshier, <span class="emphasis"><em>Methods and Programs for Mathematical Functions</em></span>,
Ellis Horwood Ltd, Chichester, 1989.
</li>
</ul></div>
<p>
While the 0.5 case is a simple trigonometric function:
</p>
<p>
I<sub>0.5</sub>(x) = sqrt(2 / &#960;x) * sinh(x)
</p>
<p>
For K<sub>v</sub> &#160; with <span class="emphasis"><em>v</em></span> an integer, the result is calculated using
the recurrence relation:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel5.svg"></span>
</p>
<p>
starting from K<sub>0</sub> &#160; and K<sub>1</sub> &#160; which are calculated using rational the approximations
above. These rational approximations are accurate to around 19 digits, and
are therefore only used when T has no more than 64 binary digits of precision.
</p>
<p>
When <span class="emphasis"><em>x</em></span> is small compared to <span class="emphasis"><em>v</em></span>,
I<sub>v</sub>x &#160; is best computed directly from the series:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel17.svg"></span>
</p>
<p>
In the general case, we first normalize &#957; &#160; to [<code class="literal">0, [inf]</code>)
with the help of the reflection formulae:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel9.svg"></span>
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel10.svg"></span>
</p>
<p>
Let &#956; &#160; = &#957; - floor(&#957; + 1/2), then &#956; &#160; is the fractional part of &#957; &#160; such that |&#956;| &lt;= 1/2
(we need this for convergence later). The idea is to calculate K<sub>&#956;</sub>(x) and K<sub>&#956;+1</sub>(x),
and use them to obtain I<sub>&#957;</sub>(x) and K<sub>&#957;</sub>(x).
</p>
<p>
The algorithm is proposed by Temme in N.M. Temme, <span class="emphasis"><em>On the numerical
evaluation of the modified bessel function of the third kind</em></span>,
Journal of Computational Physics, vol 19, 324 (1975), which needs two continued
fractions as well as the Wronskian:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel11.svg"></span>
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel12.svg"></span>
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel8.svg"></span>
</p>
<p>
The continued fractions are computed using the modified Lentz's method (W.J.
Lentz, <span class="emphasis"><em>Generating Bessel functions in Mie scattering calculations
using continued fractions</em></span>, Applied Optics, vol 15, 668 (1976)).
Their convergence rates depend on <span class="emphasis"><em>x</em></span>, therefore we need
different strategies for large <span class="emphasis"><em>x</em></span> and small <span class="emphasis"><em>x</em></span>.
</p>
<p>
<span class="emphasis"><em>x &gt; v</em></span>, CF1 needs O(<span class="emphasis"><em>x</em></span>) iterations
to converge, CF2 converges rapidly.
</p>
<p>
<span class="emphasis"><em>x &lt;= v</em></span>, CF1 converges rapidly, CF2 fails to converge
when <span class="emphasis"><em>x</em></span> <code class="literal">-&gt;</code> 0.
</p>
<p>
When <span class="emphasis"><em>x</em></span> is large (<span class="emphasis"><em>x</em></span> &gt; 2), both
continued fractions converge (CF1 may be slow for really large <span class="emphasis"><em>x</em></span>).
K<sub>&#956;</sub> &#160; and K<sub>&#956;+1</sub> &#160;
can be calculated by
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel13.svg"></span>
</p>
<p>
where
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel14.svg"></span>
</p>
<p>
<span class="emphasis"><em>S</em></span> is also a series that is summed along with CF2, see
I.J. Thompson and A.R. Barnett, <span class="emphasis"><em>Modified Bessel functions I_v and
K_v of real order and complex argument to selected accuracy</em></span>, Computer
Physics Communications, vol 47, 245 (1987).
</p>
<p>
When <span class="emphasis"><em>x</em></span> is small (<span class="emphasis"><em>x</em></span> &lt;= 2), CF2
convergence may fail (but CF1 works very well). The solution here is Temme's
series:
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel15.svg"></span>
</p>
<p>
where
</p>
<p>
<span class="inlinemediaobject"><img src="../../../equations/mbessel16.svg"></span>
</p>
<p>
f<sub>k</sub> &#160; and h<sub>k</sub> &#160;
are also computed by recursions (involving gamma functions), but
the formulas are a little complicated, readers are referred to N.M. Temme,
<span class="emphasis"><em>On the numerical evaluation of the modified Bessel function of
the third kind</em></span>, Journal of Computational Physics, vol 19, 324
(1975). Note: Temme's series converge only for |&#956;| &lt;= 1/2.
</p>
<p>
K<sub>&#957;</sub>(x) is then calculated from the forward recurrence, as is K<sub>&#957;+1</sub>(x). With these
two values and f<sub>&#957;</sub>, the Wronskian yields I<sub>&#957;</sub>(x) directly.
</p>
</div>
<table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
<td align="left"></td>
<td align="right"><div class="copyright-footer">Copyright &#169; 2006-2010, 2012-2014 Nikhar Agrawal,
Anton Bikineev, Paul A. Bristow, Marco Guazzone, Christopher Kormanyos, Hubert
Holin, Bruno Lalande, John Maddock, Jeremy Murphy, Johan R&#229;de, Gautam Sewani,
Benjamin Sobotta, Thijs van den Berg, Daryle Walker and Xiaogang Zhang<p>
Distributed under the Boost Software License, Version 1.0. (See accompanying
file LICENSE_1_0.txt or copy at <a href="http://www.boost.org/LICENSE_1_0.txt" target="_top">http://www.boost.org/LICENSE_1_0.txt</a>)
</p>
</div></td>
</tr></table>
<hr>
<div class="spirit-nav">
<a accesskey="p" href="bessel_root.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../bessel.html"><img src="../../../../../../doc/src/images/up.png" alt="Up"></a><a accesskey="h" href="../../index.html"><img src="../../../../../../doc/src/images/home.png" alt="Home"></a><a accesskey="n" href="sph_bessel.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
</div>
</body>
</html>
Reference in New Issue Copy Permalink