sigma  1.0.0
Loading...
Searching...
No Matches
series_detail.hpp File Reference

Shared helpers for building the outer Taylor series of the elementary functions (exp, log, 1/x, sqrt). More...

#include <cstddef>
#include <sigma/detail/numeric.hpp>
#include <vector>

Go to the source code of this file.

Namespaces

namespace  sigma
 The primary namespace for the sigma library.

Functions

template<typename T>
T sigma::detail::factorial (std::size_t k)
 Returns k! as a value_t.
template<typename T>
T sigma::detail::half_binomial_coefficient (std::size_t k)
template<typename T>
T sigma::detail::half_falling_factorial (std::size_t k)
template<typename T>
std::vector< T > sigma::detail::exp_outer_coeffs (T c, std::size_t order)
template<typename T>
std::vector< T > sigma::detail::log_outer_coeffs (T c, std::size_t order)
template<typename T>
std::vector< T > sigma::detail::reciprocal_outer_coeffs (T c, std::size_t order)
 Outer-series coefficients of 1/x about c: (-1)^k / c^(k+1).
template<typename T>
std::vector< T > sigma::detail::sqrt_outer_coeffs (T c, std::size_t order)
 Outer-series coefficients of sqrt(x) about c: sqrt(c) * C(1/2,k) / c^k.

Detailed Description

Shared helpers for building the outer Taylor series of the elementary functions (exp, log, 1/x, sqrt).

These are used both by Taylor's own (non-rigorous) elementary functions in operations/exponents.ipp and by TaylorModel's, which additionally need the (n+1)-th derivative of the same outer function for the Lagrange remainder of Eq. \(\eqref{eq:tm-outer-rem}\) (see docs/taylor.md).

is_integer_exponent(), used by pow() but not itself series-related, lives in sigma/detail/numeric.hpp and is re-exposed here (via the include above) so existing callers of detail::is_integer_exponent under sigma/taylor/ keep working unqualified.

Function Documentation

◆ exp_outer_coeffs()

template<typename T>
std::vector< T > sigma::detail::exp_outer_coeffs ( T c,
std::size_t order )

Outer-series coefficients of exp(x) about c, i.e. exp(c)/k! for k = 0, ..., order.

◆ half_binomial_coefficient()

template<typename T>
T sigma::detail::half_binomial_coefficient ( std::size_t k)

Returns the k-th binomial-series coefficient \(C(1/2, k) = \prod_{i=0}^{k-1}(1/2 - i) / k!\), used by the Taylor series of sqrt.

◆ half_falling_factorial()

template<typename T>
T sigma::detail::half_falling_factorial ( std::size_t k)

Returns the k-th falling factorial (1/2)(1/2-1)...(1/2-k+1), i.e. half_binomial_coefficient(k) * k!, used for the (n+1)-th derivative of sqrt.

◆ log_outer_coeffs()

template<typename T>
std::vector< T > sigma::detail::log_outer_coeffs ( T c,
std::size_t order )

Outer-series coefficients of log(x) about c: log(c) for k=0, and (-1)^(k-1) / (k c^k) for k >= 1.