naginterfaces.library.specfun.bessel_​k1_​real

naginterfaces.library.specfun.bessel_k1_real(x)

bessel_k1_real returns the value of the modified Bessel function $K_1\left(x\right)$.

For full information please refer to the NAG Library document for s18ad

https://support.nag.com/numeric/nl/nagdoc_30/flhtml/s/s18adf.html

Parameters

xfloat

The argument $x$ of the function.

Returns

k1float

The value of the function at $x$.

Raises

NagValueError

(errno $1$)

On entry, $x=⟨value⟩$.

Constraint: $x>0.0$.

$K_0$ is undefined and the function returns zero.

Warns

NagAlgorithmicWarning

(errno $2$)

On entry, $x=⟨value⟩$.

Constraint: $x>⟨value⟩$.

$x$ is too small, there is a danger of overflow and the function returns approximately the largest representable value.

Notes

bessel_k1_real evaluates an approximation to the modified Bessel function of the second kind $K_1\left(x\right)$.

Note: $K_1\left(x\right)$ is undefined for $x\le 0$ and the function will fail for such arguments.

The function is based on five Chebyshev expansions:

For $0<x\le 1$,

$$K_1\left(x\right)=\frac{1}{x}+xln\left(x\right){\sum ^{\prime }}_{r=0}{a}_r{T}_r\left(t\right)-x{\sum ^{\prime }}_{r=0}{b}_r{T}_r\left(t\right)\text{, where}t=2x^2-1\text{.}$$

For $1<x\le 2$,

$$K_1\left(x\right)=e^{-x}{\sum ^{\prime }}_{r=0}{c}_r{T}_r\left(t\right)\text{, where}t=2x-3\text{.}$$

For $2<x\le 4$,

$$K_1\left(x\right)=e^{-x}{\sum ^{\prime }}_{r=0}{d}_r{T}_r\left(t\right)\text{, where}t=x-3\text{.}$$

For $x>4$,

$$K_1\left(x\right)=\frac{e^{-x}}{\sqrt{x}}{\sum ^{\prime }}_{r=0}{e}_r{T}_r\left(t\right)\text{, where}t=\frac{9-x}{1+x}\text{.}$$

For $x$ near zero, $K_1\left(x\right)\simeq \frac{1}{x}$. This approximation is used when $x$ is sufficiently small for the result to be correct to machine precision. For very small $x$ on some machines, it is impossible to calculate $\frac{1}{x}$ without overflow and the function must fail.

For large $x$, where there is a danger of underflow due to the smallness of $K_1$, the result is set exactly to zero.

References

NIST Digital Library of Mathematical Functions