3 <meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
4 <title>Overview of the Jacobi Elliptic Functions</title>
5 <link rel="stylesheet" href="../../math.css" type="text/css">
6 <meta name="generator" content="DocBook XSL Stylesheets V1.79.1">
7 <link rel="home" href="../../index.html" title="Math Toolkit 2.11.0">
8 <link rel="up" href="../jacobi.html" title="Jacobi Elliptic Functions">
9 <link rel="prev" href="../jacobi.html" title="Jacobi Elliptic Functions">
10 <link rel="next" href="jacobi_elliptic.html" title="Jacobi Elliptic SN, CN and DN">
12 <body bgcolor="white" text="black" link="#0000FF" vlink="#840084" alink="#0000FF">
13 <table cellpadding="2" width="100%"><tr>
14 <td valign="top"><img alt="Boost C++ Libraries" width="277" height="86" src="../../../../../../boost.png"></td>
15 <td align="center"><a href="../../../../../../index.html">Home</a></td>
16 <td align="center"><a href="../../../../../../libs/libraries.htm">Libraries</a></td>
17 <td align="center"><a href="http://www.boost.org/users/people.html">People</a></td>
18 <td align="center"><a href="http://www.boost.org/users/faq.html">FAQ</a></td>
19 <td align="center"><a href="../../../../../../more/index.htm">More</a></td>
22 <div class="spirit-nav">
23 <a accesskey="p" href="../jacobi.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../jacobi.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="jacobi_elliptic.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>
26 <div class="titlepage"><div><div><h3 class="title">
27 <a name="math_toolkit.jacobi.jac_over"></a><a class="link" href="jac_over.html" title="Overview of the Jacobi Elliptic Functions">Overview of the Jacobi
28 Elliptic Functions</a>
29 </h3></div></div></div>
31 There are twelve Jacobi Elliptic functions, of which the three copolar functions
32 <span class="emphasis"><em>sn</em></span>, <span class="emphasis"><em>cn</em></span> and <span class="emphasis"><em>dn</em></span>
33 are the most important as the other nine can be computed from these three
34 <a href="#ftn.math_toolkit.jacobi.jac_over.f0" class="footnote" name="math_toolkit.jacobi.jac_over.f0"><sup class="footnote">[2]</sup></a> <a href="#ftn.math_toolkit.jacobi.jac_over.f1" class="footnote" name="math_toolkit.jacobi.jac_over.f1"><sup class="footnote">[3]</sup></a> <a href="#ftn.math_toolkit.jacobi.jac_over.f2" class="footnote" name="math_toolkit.jacobi.jac_over.f2"><sup class="footnote">[4]</sup></a>.
37 These functions each take two arguments: a parameter, and a variable as described
41 Like all elliptic functions these can be parameterised in a number of ways:
43 <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
45 In terms of a parameter <span class="emphasis"><em>m</em></span>.
48 In terms of the elliptic modulus <span class="emphasis"><em>k</em></span> where <span class="emphasis"><em>m
49 = k<sup>2</sup></em></span>.
52 In terms of the modular angle α, where <span class="emphasis"><em>m = sin<sup>2</sup>  α</em></span>.
56 In our implementation, these functions all take the elliptic modulus <span class="emphasis"><em>k</em></span>
60 In addition the variable <span class="emphasis"><em>u</em></span> is sometimes expressed as
61 an amplitude φ, in our implementation we always use <span class="emphasis"><em>u</em></span>.
64 Finally note that our functions all take the elliptic modulus <span class="emphasis"><em>k</em></span>
65 as the <span class="bold"><strong>first</strong></span> argument - this is for alignment
66 with the Elliptic Integrals (but is different from other implementations,
67 for example Mathworks).
70 A simple example comparing use of <a href="http://www.wolframalpha.com/" target="_top">Wolfram
71 Alpha</a> with Boost.Math (including much higher precision using Boost.Multiprecision)
72 is <a href="../../../../example/jacobi_zeta_example.cpp" target="_top">jacobi_zeta_example.cpp</a>.
75 There are twelve functions for computing the twelve individual Jacobi elliptic
76 functions: <a class="link" href="jacobi_cd.html" title="Jacobi Elliptic Function cd">jacobi_cd</a>,
77 <a class="link" href="jacobi_cn.html" title="Jacobi Elliptic Function cn">jacobi_cn</a>, <a class="link" href="jacobi_cs.html" title="Jacobi Elliptic Function cs">jacobi_cs</a>,
78 <a class="link" href="jacobi_dc.html" title="Jacobi Elliptic Function dc">jacobi_dc</a>, <a class="link" href="jacobi_dn.html" title="Jacobi Elliptic Function dn">jacobi_dn</a>,
79 <a class="link" href="jacobi_ds.html" title="Jacobi Elliptic Function ds">jacobi_ds</a>, <a class="link" href="jacobi_nc.html" title="Jacobi Elliptic Function nc">jacobi_nc</a>,
80 <a class="link" href="jacobi_nd.html" title="Jacobi Elliptic Function nd">jacobi_nd</a>, <a class="link" href="jacobi_ns.html" title="Jacobi Elliptic Function ns">jacobi_ns</a>,
81 <a class="link" href="jacobi_sc.html" title="Jacobi Elliptic Function sc">jacobi_sc</a>, <a class="link" href="jacobi_sd.html" title="Jacobi Elliptic Function sd">jacobi_sd</a>
82 and <a class="link" href="jacobi_sn.html" title="Jacobi Elliptic Function sn">jacobi_sn</a>.
85 They are all called as for example:
87 <pre class="programlisting"><span class="identifier">jacobi_cs</span><span class="special">(</span><span class="identifier">k</span><span class="special">,</span> <span class="identifier">u</span><span class="special">);</span>
90 Note however that these individual functions are all really thin wrappers
91 around the function <a class="link" href="jacobi_elliptic.html" title="Jacobi Elliptic SN, CN and DN">jacobi_elliptic</a>
92 which calculates the three copolar functions <span class="emphasis"><em>sn</em></span>, <span class="emphasis"><em>cn</em></span>
93 and <span class="emphasis"><em>dn</em></span> in a single function call.
95 <div class="tip"><table border="0" summary="Tip">
97 <td rowspan="2" align="center" valign="top" width="25"><img alt="[Tip]" src="../../../../../../doc/src/images/tip.png"></td>
98 <th align="left">Tip</th>
100 <tr><td align="left" valign="top"><p>
101 If you need more than one of these functions for a given set of arguments,
102 it's most efficient to use <a class="link" href="jacobi_elliptic.html" title="Jacobi Elliptic SN, CN and DN">jacobi_elliptic</a>.
105 <div class="footnotes">
106 <br><hr style="width:100; text-align:left;margin-left: 0">
107 <div id="ftn.math_toolkit.jacobi.jac_over.f0" class="footnote"><p><a href="#math_toolkit.jacobi.jac_over.f0" class="para"><sup class="para">[2] </sup></a>
108 <a href="http://en.wikipedia.org/wiki/Jacobi_elliptic_functions" target="_top">Wikipedia:
109 Jacobi elliptic functions</a>
111 <div id="ftn.math_toolkit.jacobi.jac_over.f1" class="footnote"><p><a href="#math_toolkit.jacobi.jac_over.f1" class="para"><sup class="para">[3] </sup></a>
112 <a href="http://mathworld.wolfram.com/JacobiEllipticFunctions.html" target="_top">Weisstein,
113 Eric W. "Jacobi Elliptic Functions." From MathWorld - A Wolfram
116 <div id="ftn.math_toolkit.jacobi.jac_over.f2" class="footnote"><p><a href="#math_toolkit.jacobi.jac_over.f2" class="para"><sup class="para">[4] </sup></a>
117 <a href="http://dlmf.nist.gov/22" target="_top">Digital Library of Mathematical Functions:
118 Jacobian Elliptic Functions, Reinhardt, W. P., Walker, O. L.</a>
122 <table xmlns:rev="http://www.cs.rpi.edu/~gregod/boost/tools/doc/revision" width="100%"><tr>
123 <td align="left"></td>
124 <td align="right"><div class="copyright-footer">Copyright © 2006-2019 Nikhar
125 Agrawal, Anton Bikineev, Paul A. Bristow, Marco Guazzone, Christopher Kormanyos,
126 Hubert Holin, Bruno Lalande, John Maddock, Jeremy Murphy, Matthew Pulver, Johan
127 Råde, Gautam Sewani, Benjamin Sobotta, Nicholas Thompson, Thijs van den Berg,
128 Daryle Walker and Xiaogang Zhang<p>
129 Distributed under the Boost Software License, Version 1.0. (See accompanying
130 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>)
135 <div class="spirit-nav">
136 <a accesskey="p" href="../jacobi.html"><img src="../../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../jacobi.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="jacobi_elliptic.html"><img src="../../../../../../doc/src/images/next.png" alt="Next"></a>