mirror of
				https://github.com/saitohirga/WSJT-X.git
				synced 2025-11-03 21:40:52 -05:00 
			
		
		
		
	
		
			
				
	
	
		
			484 lines
		
	
	
		
			28 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
			
		
		
	
	
			484 lines
		
	
	
		
			28 KiB
		
	
	
	
		
			HTML
		
	
	
	
	
	
<html>
 | 
						|
<head>
 | 
						|
<meta http-equiv="Content-Type" content="text/html; charset=US-ASCII">
 | 
						|
<title>FAQs</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="../constants.html" title="Chapter 4. Mathematical Constants">
 | 
						|
<link rel="prev" href="new_const.html" title="Defining New Constants">
 | 
						|
<link rel="next" href="../dist.html" title="Chapter 5. Statistical Distributions and Functions">
 | 
						|
</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="new_const.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../constants.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="../dist.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
 | 
						|
</div>
 | 
						|
<div class="section">
 | 
						|
<div class="titlepage"><div><div><h2 class="title" style="clear: both">
 | 
						|
<a name="math_toolkit.constants_faq"></a><a class="link" href="constants_faq.html" title="FAQs">FAQs</a>
 | 
						|
</h2></div></div></div>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h0"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.why_are_these_constants_chosen"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.why_are_these_constants_chosen">Why are
 | 
						|
      <span class="emphasis"><em>these</em></span> Constants Chosen?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      It is, of course, impossible to please everyone with a list like this.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      Some of the criteria we have used are:
 | 
						|
    </p>
 | 
						|
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 | 
						|
<li class="listitem">
 | 
						|
          Used in Boost.Math.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Commonly used.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Expensive to compute.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Requested by users.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          <a href="http://en.wikipedia.org/wiki/Mathematical_constant" target="_top">Used in
 | 
						|
          science and mathematics.</a>
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          No integer values (because so cheap to construct).<br> (You can easily
 | 
						|
          define your own if found convenient, for example: <code class="computeroutput"><span class="identifier">FPT</span>
 | 
						|
          <span class="identifier">one</span> <span class="special">=</span><span class="keyword">static_cast</span><span class="special"><</span><span class="identifier">FPT</span><span class="special">>(</span><span class="number">42</span><span class="special">);</span></code>).
 | 
						|
        </li>
 | 
						|
</ul></div>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h1"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.how_are_constants_named"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.how_are_constants_named">How
 | 
						|
      are constants named?</a>
 | 
						|
    </h5>
 | 
						|
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 | 
						|
<li class="listitem">
 | 
						|
          Not macros, so no upper case.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          All lower case (following C++ standard names).
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          No CamelCase.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Underscore as _ delimiter between words.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Numbers spelt as words rather than decimal digits (except following pow).
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Abbreviation conventions:
 | 
						|
          <div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: circle; ">
 | 
						|
<li class="listitem">
 | 
						|
                root for square root.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                cbrt for cube root.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                pow for pow function using decimal digits like pow23 for n<sup>2/3</sup>.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                div for divided by or operator /.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                minus for operator -, plus for operator +.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                sqr for squared.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                cubed for cubed n<sup>3</sup>.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                words for greek, like π, ζ and Γ.
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                words like half, third, three_quarters, sixth for fractions. (Digit(s)
 | 
						|
                can get muddled).
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                log10 for log<sub>10</sub>
 | 
						|
              </li>
 | 
						|
<li class="listitem">
 | 
						|
                ln for log<sub>e</sub>
 | 
						|
              </li>
 | 
						|
</ul></div>
 | 
						|
        </li>
 | 
						|
</ul></div>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h2"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.how_are_the_constants_derived"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.how_are_the_constants_derived">How are
 | 
						|
      the constants derived?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      The constants have all been calculated using high-precision software working
 | 
						|
      with up to 300-bit precision giving about 100 decimal digits. (The precision
 | 
						|
      can be arbitrarily chosen and is limited only by compute time).
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h3"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.how_accurate_are_the_constants"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.how_accurate_are_the_constants">How Accurate
 | 
						|
      are the constants?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      The minimum accuracy chosen (100 decimal digits) exceeds the accuracy of reasonably-foreseeable
 | 
						|
      floating-point hardware (256-bit) and should meet most high-precision computations.
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h4"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.how_are_the_constants_tested"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.how_are_the_constants_tested">How are the
 | 
						|
      constants tested?</a>
 | 
						|
    </h5>
 | 
						|
<div class="orderedlist"><ol class="orderedlist" type="1">
 | 
						|
<li class="listitem">
 | 
						|
          Comparison using Boost.Test BOOST_CHECK_CLOSE_FRACTION using long double
 | 
						|
          literals, with at least 35 decimal digits, enough to be accurate for all
 | 
						|
          long double implementations. The tolerance is usually twice <code class="computeroutput"><span class="keyword">long</span> <span class="keyword">double</span> <span class="identifier">epsilon</span></code>.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Comparison with calculation at long double precision. This often requires
 | 
						|
          a slightly higher tolerance than two epsilon because of computational noise
 | 
						|
          from round-off etc, especially when trig and other functions are called.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Comparison with independent published values, for example, using <a href="http://oeis.org/" target="_top">The On-Line Encyclopedia of Integer Sequences (OEIS)</a>
 | 
						|
          again using at least 35 decimal digits strings.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Comparison with independely calculated values using arbitrary precision
 | 
						|
          tools like <a href="http://www.wolfram.com/mathematica/" target="_top">Mathematica</a>,
 | 
						|
          again using at least 35 decimal digits literal strings.
 | 
						|
        </li>
 | 
						|
</ol></div>
 | 
						|
<div class="warning"><table border="0" summary="Warning">
 | 
						|
<tr>
 | 
						|
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Warning]" src="../../../../../doc/src/images/warning.png"></td>
 | 
						|
<th align="left">Warning</th>
 | 
						|
</tr>
 | 
						|
<tr><td align="left" valign="top"><p>
 | 
						|
        We have not yet been able to <span class="bold"><strong>check</strong></span> that
 | 
						|
        <span class="bold"><strong>all</strong></span> constants are accurate at the full arbitrary
 | 
						|
        precision, at present 100 decimal digits. But certain key values like <code class="computeroutput"><span class="identifier">e</span></code> and <code class="computeroutput"><span class="identifier">pi</span></code>
 | 
						|
        appear to be accurate and internal consistencies suggest that others are
 | 
						|
        this accurate too.
 | 
						|
      </p></td></tr>
 | 
						|
</table></div>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h5"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.why_is_portability_important"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.why_is_portability_important">Why is Portability
 | 
						|
      important?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      Code written using math constants is easily portable even when using different
 | 
						|
      floating-point types with differing precision.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      It is a mistake to expect that results of computations will be <span class="bold"><strong>identical</strong></span>,
 | 
						|
      but you can achieve the <span class="bold"><strong>best accuracy possible for the
 | 
						|
      floating-point type in use</strong></span>.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      This has no extra cost to the user, but reduces irritating, and often confusing
 | 
						|
      and very hard-to-trace effects, caused by the intrinsically limited precision
 | 
						|
      of floating-point calculations.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      A harmless symptom of this limit is a spurious least-significant digit; at
 | 
						|
      worst, slightly inaccurate constants sometimes cause iterating algorithms to
 | 
						|
      diverge wildly because internal comparisons just fail.
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h6"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.what_is_the_internal_format_of_t"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.what_is_the_internal_format_of_t">What
 | 
						|
      is the Internal Format of the constants, and why?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      See <a class="link" href="tutorial.html" title="Tutorial">tutorial</a> above for normal
 | 
						|
      use, but this FAQ explains the internal details used for the constants.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      Constants are stored as 100 decimal digit values. However, some compilers do
 | 
						|
      not accept decimal digits strings as long as this. So the constant is split
 | 
						|
      into two parts, with the first containing at least 128-bit long double precision
 | 
						|
      (35 decimal digits), and for consistency should be in scientific format with
 | 
						|
      a signed exponent.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      The second part is the value of the constant expressed as a string literal,
 | 
						|
      accurate to at least 100 decimal digits (in practice that means at least 102
 | 
						|
      digits). Again for consistency use scientific format with a signed exponent.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      For types with precision greater than a long double, then if T is constructible
 | 
						|
      <code class="computeroutput"><span class="identifier">T</span> </code>is constructible from a
 | 
						|
      <code class="computeroutput"><span class="keyword">const</span> <span class="keyword">char</span><span class="special">*</span></code> then it's directly constructed from the string,
 | 
						|
      otherwise we fall back on lexical_cast to convert to type <code class="computeroutput"><span class="identifier">T</span></code>.
 | 
						|
      (Using a string is necessary because you can't use a numeric constant since
 | 
						|
      even a <code class="computeroutput"><span class="keyword">long</span> <span class="keyword">double</span></code>
 | 
						|
      might not have enough digits).
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      So, for example, a constant like pi is internally defined as
 | 
						|
    </p>
 | 
						|
<pre class="programlisting"><span class="identifier">BOOST_DEFINE_MATH_CONSTANT</span><span class="special">(</span><span class="identifier">pi</span><span class="special">,</span> <span class="number">3.141592653589793238462643383279502884e+00</span><span class="special">,</span> <span class="string">"3.14159265358979323846264338327950288419716939937510582097494459230781640628620899862803482534211706798214808651e+00"</span><span class="special">);</span>
 | 
						|
</pre>
 | 
						|
<p>
 | 
						|
      In this case the significand is 109 decimal digits, ensuring 100 decimal digits
 | 
						|
      are exact, and exponent is zero.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      See <a class="link" href="new_const.html" title="Defining New Constants">defining new constants</a> to
 | 
						|
      calculate new constants.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      A macro definition like this can be pasted into user code where convenient,
 | 
						|
      or into <code class="computeroutput"><span class="identifier">boost</span><span class="special">/</span><span class="identifier">math</span><span class="special">/</span><span class="identifier">constants</span><span class="special">.</span><span class="identifier">hpp</span></code> if it
 | 
						|
      is to be added to the Boost.Math library.
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h7"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.what_floating_point_types_could_"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.what_floating_point_types_could_">What
 | 
						|
      Floating-point Types could I use?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      Apart from the built-in floating-point types <code class="computeroutput"><span class="keyword">float</span></code>,
 | 
						|
      <code class="computeroutput"><span class="keyword">double</span></code>, <code class="computeroutput"><span class="keyword">long</span>
 | 
						|
      <span class="keyword">double</span></code>, there are several arbitrary
 | 
						|
      precision floating-point classes available, but most are not licensed for commercial
 | 
						|
      use.
 | 
						|
    </p>
 | 
						|
<h6>
 | 
						|
<a name="math_toolkit.constants_faq.h8"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.boost_multiprecision_by_christop"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.boost_multiprecision_by_christop">Boost.Multiprecision
 | 
						|
      by Christopher Kormanyos</a>
 | 
						|
    </h6>
 | 
						|
<p>
 | 
						|
      This work is based on an earlier work called e-float: Algorithm 910: A Portable
 | 
						|
      C++ Multiple-Precision System for Special-Function Calculations, in ACM TOMS,
 | 
						|
      {VOL 37, ISSUE 4, (February 2011)} (C) ACM, 2011. <a href="http://doi.acm.org/10.1145/1916461.1916469" target="_top">http://doi.acm.org/10.1145/1916461.1916469</a>
 | 
						|
      <a href="https://svn.boost.org/svn/boost/sandbox/e_float/" target="_top">e_float</a>
 | 
						|
      but is now re-factored and available under the Boost license in the Boost-sandbox
 | 
						|
      at <a href="https://svn.boost.org/svn/boost/sandbox/multiprecision/" target="_top">multiprecision</a>
 | 
						|
      where it is being refined and prepared for review.
 | 
						|
    </p>
 | 
						|
<h6>
 | 
						|
<a name="math_toolkit.constants_faq.h9"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.boost_cpp_float_by_john_maddock_"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.boost_cpp_float_by_john_maddock_">Boost.cpp_float
 | 
						|
      by John Maddock using Expression Templates</a>
 | 
						|
    </h6>
 | 
						|
<p>
 | 
						|
      <a href="https://svn.boost.org/svn/boost/sandbox/big_number/" target="_top">Big Number</a>
 | 
						|
      which is a reworking of <a href="https://svn.boost.org/svn/boost/sandbox/e_float/" target="_top">e_float</a>
 | 
						|
      by Christopher Kormanyos to use expression templates for faster execution.
 | 
						|
    </p>
 | 
						|
<h6>
 | 
						|
<a name="math_toolkit.constants_faq.h10"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.ntl_class_quad_float"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.ntl_class_quad_float">NTL
 | 
						|
      class quad_float</a>
 | 
						|
    </h6>
 | 
						|
<p>
 | 
						|
      <a href="http://shoup.net/ntl/" target="_top">NTL</a> by Victor Shoup has fixed and
 | 
						|
      arbitrary high precision fixed and floating-point types. However none of these
 | 
						|
      are licenced for commercial use.
 | 
						|
    </p>
 | 
						|
<pre class="programlisting"><span class="preprocessor">#include</span> <span class="special"><</span><span class="identifier">NTL</span><span class="special">/</span><span class="identifier">quad_float</span><span class="special">.</span><span class="identifier">h</span><span class="special">></span> <span class="comment">// quad precision 106-bit, about 32 decimal digits.</span>
 | 
						|
<span class="keyword">using</span> <span class="identifier">NTL</span><span class="special">::</span><span class="identifier">to_quad_float</span><span class="special">;</span> <span class="comment">// Less precise than arbitrary precision NTL::RR.</span>
 | 
						|
</pre>
 | 
						|
<p>
 | 
						|
      NTL class <code class="computeroutput"><span class="identifier">quad_float</span></code>, which
 | 
						|
      gives a form of quadruple precision, 106-bit significand (but without an extended
 | 
						|
      exponent range.) With an IEC559/IEEE 754 compatible processor, for example
 | 
						|
      Intel X86 family, with 64-bit double, and 53-bit significand, using the significands
 | 
						|
      of <span class="bold"><strong>two</strong></span> 64-bit doubles, if <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span><span class="special"><</span><span class="keyword">double</span><span class="special">>::</span><span class="identifier">digits10</span></code> is 16, then we get about twice the
 | 
						|
      precision, so <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span><span class="special"><</span><span class="identifier">quad_float</span><span class="special">>::</span><span class="identifier">digits10</span><span class="special">()</span></code>
 | 
						|
      should be 32. (the default <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span><span class="special"><</span><span class="identifier">RR</span><span class="special">>::</span><span class="identifier">digits10</span><span class="special">()</span></code>
 | 
						|
      should be about 40). (which seems to agree with experiments). We output constants
 | 
						|
      (including some noisy bits, an approximation to <code class="computeroutput"><span class="identifier">std</span><span class="special">::</span><span class="identifier">numeric_limits</span><span class="special"><</span><span class="identifier">RR</span><span class="special">>::</span><span class="identifier">max_digits10</span><span class="special">()</span></code>)
 | 
						|
      by adding 2 or 3 extra decimal digits, so using <code class="computeroutput"><span class="identifier">quad_float</span><span class="special">::</span><span class="identifier">SetOutputPrecision</span><span class="special">(</span><span class="number">32</span> <span class="special">+</span>
 | 
						|
      <span class="number">3</span><span class="special">);</span></code>
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      Apple Mac/Darwin uses a similar <span class="emphasis"><em>doubledouble</em></span> 106-bit for
 | 
						|
      its built-in <code class="computeroutput"><span class="keyword">long</span> <span class="keyword">double</span></code>
 | 
						|
      type.
 | 
						|
    </p>
 | 
						|
<div class="note"><table border="0" summary="Note">
 | 
						|
<tr>
 | 
						|
<td rowspan="2" align="center" valign="top" width="25"><img alt="[Note]" src="../../../../../doc/src/images/note.png"></td>
 | 
						|
<th align="left">Note</th>
 | 
						|
</tr>
 | 
						|
<tr><td align="left" valign="top"><p>
 | 
						|
        The precision of all <code class="computeroutput"><span class="identifier">doubledouble</span></code>
 | 
						|
        floating-point types is rather odd and values given are only approximate.
 | 
						|
      </p></td></tr>
 | 
						|
</table></div>
 | 
						|
<p>
 | 
						|
      <span class="bold"><strong>New projects should use <a href="../../../../../libs/multiprecision/doc/html/index.html" target="_top">Boost.Multiprecision</a>.</strong></span>
 | 
						|
    </p>
 | 
						|
<h6>
 | 
						|
<a name="math_toolkit.constants_faq.h11"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.ntl_class_rr"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.ntl_class_rr">NTL
 | 
						|
      class RR</a>
 | 
						|
    </h6>
 | 
						|
<p>
 | 
						|
      Arbitrary precision floating point with NTL class RR, default is 150 bit (about
 | 
						|
      50 decimal digits) used here with 300 bit to output 100 decimal digits, enough
 | 
						|
      for many practical non-'number-theoretic' C++ applications.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      <a href="http://www.shoup.net/ntl/" target="_top">NTL A Library for doing Number Theory</a>
 | 
						|
      is <span class="bold"><strong>not licenced for commercial use</strong></span>.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      This class is used in Boost.Math and is an option when using big_number projects
 | 
						|
      to calculate new math constants.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      <span class="bold"><strong>New projects should use <a href="../../../../../libs/multiprecision/doc/html/index.html" target="_top">Boost.Multiprecision</a>.</strong></span>
 | 
						|
    </p>
 | 
						|
<h6>
 | 
						|
<a name="math_toolkit.constants_faq.h12"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.gmp_and_mpfr"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.gmp_and_mpfr">GMP
 | 
						|
      and MPFR</a>
 | 
						|
    </h6>
 | 
						|
<p>
 | 
						|
      <a href="http://gmplib.org" target="_top">GMP</a> and <a href="http://www.mpfr.org/" target="_top">MPFR</a>
 | 
						|
      have also been used to compute constants, but are licensed under the <a href="http://www.gnu.org/copyleft/lesser.html" target="_top">Lesser GPL license</a> and
 | 
						|
      are <span class="bold"><strong>not licensed for commercial use</strong></span>.
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h13"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.what_happened_to_a_previous_coll"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.what_happened_to_a_previous_coll">What
 | 
						|
      happened to a previous collection of constants proposed for Boost?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      A review concluded that the way in which the constants were presented did not
 | 
						|
      meet many peoples needs. None of the methods proposed met many users' essential
 | 
						|
      requirement to allow writing simply <code class="computeroutput"><span class="identifier">pi</span></code>
 | 
						|
      rather than <code class="computeroutput"><span class="identifier">pi</span><span class="special">()</span></code>.
 | 
						|
      Many science and engineering equations look difficult to read when because
 | 
						|
      function call brackets can be confused with the many other brackets often needed.
 | 
						|
      All the methods then proposed of avoiding the brackets failed to meet all needs,
 | 
						|
      often on grounds of complexity and lack of applicability to various realistic
 | 
						|
      scenarios.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      So the simple namespace method, proposed on its own, but rejected at the first
 | 
						|
      review, has been added to allow users to have convenient access to float, double
 | 
						|
      and long double values, but combined with template struct and functions to
 | 
						|
      allow simultaneous use with other non-built-in floating-point types.
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h14"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.why_do_the_constants_internally_"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.why_do_the_constants_internally_">Why do
 | 
						|
      the constants (internally) have a struct rather than a simple function?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      A function mechanism was provided by in previous versions of Boost.Math.
 | 
						|
    </p>
 | 
						|
<p>
 | 
						|
      The new mechanism is to permit partial specialization. See Custom Specializing
 | 
						|
      a constant above. It should also allow use with other packages like <a href="http://www.ttmath.org/" target="_top">ttmath Bignum C++ library.</a>
 | 
						|
    </p>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h15"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.where_can_i_find_other_high_prec"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.where_can_i_find_other_high_prec">Where
 | 
						|
      can I find other high precision constants?</a>
 | 
						|
    </h5>
 | 
						|
<div class="orderedlist"><ol class="orderedlist" type="1">
 | 
						|
<li class="listitem">
 | 
						|
          Constants with very high precision and good accuracy (>40 decimal digits)
 | 
						|
          from Simon Plouffe's web based collection <a href="http://pi.lacim.uqam.ca/eng/" target="_top">http://pi.lacim.uqam.ca/eng/</a>.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          <a href="https://oeis.org/" target="_top">The On-Line Encyclopedia of Integer Sequences
 | 
						|
          (OEIS)</a>
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Checks using printed text optically scanned values and converted from:
 | 
						|
          D. E. Knuth, Art of Computer Programming, Appendix A, Table 1, Vol 1, ISBN
 | 
						|
          0 201 89683 4 (1997)
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          M. Abrahamovitz & I. E. Stegun, National Bureau of Standards, Handbook
 | 
						|
          of Mathematical Functions, a reference source for formulae now superceded
 | 
						|
          by
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Frank W. Olver, Daniel W. Lozier, Ronald F. Boisvert, Charles W. Clark,
 | 
						|
          NIST Handbook of Mathemetical Functions, Cambridge University Press, ISBN
 | 
						|
          978-0-521-14063-8, 2010.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          John F Hart, Computer Approximations, Kreiger (1978) ISBN 0 88275 642 7.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Some values from Cephes Mathematical Library, Stephen L. Moshier and CALC100
 | 
						|
          100 decimal digit Complex Variable Calculator Program, a DOS utility.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Xavier Gourdon, Pascal Sebah, 50 decimal digits constants at <a href="http://numbers.computation.free.fr/Constants/constants.html" target="_top">Number,
 | 
						|
          constants and computation</a>.
 | 
						|
        </li>
 | 
						|
</ol></div>
 | 
						|
<h5>
 | 
						|
<a name="math_toolkit.constants_faq.h16"></a>
 | 
						|
      <span class="phrase"><a name="math_toolkit.constants_faq.where_are_physical_constants"></a></span><a class="link" href="constants_faq.html#math_toolkit.constants_faq.where_are_physical_constants">Where are
 | 
						|
      Physical Constants?</a>
 | 
						|
    </h5>
 | 
						|
<p>
 | 
						|
      Not here in this Boost.Math collection, because physical constants:
 | 
						|
    </p>
 | 
						|
<div class="itemizedlist"><ul class="itemizedlist" style="list-style-type: disc; ">
 | 
						|
<li class="listitem">
 | 
						|
          Are measurements, not truely constants.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Are not truly constant and keeping changing as mensuration technology improves.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Have a instrinsic uncertainty.
 | 
						|
        </li>
 | 
						|
<li class="listitem">
 | 
						|
          Mathematical constants are stored and represented at varying precision,
 | 
						|
          but should never be inaccurate.
 | 
						|
        </li>
 | 
						|
</ul></div>
 | 
						|
<p>
 | 
						|
      Some physical constants may be available in Boost.Units.
 | 
						|
    </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 © 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å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="new_const.html"><img src="../../../../../doc/src/images/prev.png" alt="Prev"></a><a accesskey="u" href="../constants.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="../dist.html"><img src="../../../../../doc/src/images/next.png" alt="Next"></a>
 | 
						|
</div>
 | 
						|
</body>
 | 
						|
</html>
 |