naginterfaces.library.specfun.airy_​ai_​real

naginterfaces.library.specfun.airy_ai_real(x)

airy_ai_real returns a value for the Airy function, $Ai\left(x\right)$.

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

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

Parameters

xfloat

The argument $x$ of the function.

Returns

aifloat

The value of the Airy function, $Ai\left(x\right)$.

Raises

NagValueError

(errno $1$)

On entry, $x=⟨value⟩$.

Constraint: $x\le ⟨value⟩$.

$x$ is too large and positive. The function returns zero.

(errno $2$)

On entry, $x=⟨value⟩$.

Constraint: $x\ge ⟨value⟩$.

$x$ is too large and negative. The function returns zero.

Notes

airy_ai_real evaluates an approximation to the Airy function, $Ai\left(x\right)$. It is based on a number of Chebyshev expansions:

For $x<-5$,

$$Ai\left(x\right)=\frac{a\left(t\right)\sin \left(z\right)-b\left(t\right)\cos \left(z\right)}{{(-x)}^{1/4}}$$

where $z=\frac{\pi }{4}+\frac{2}{3}\sqrt{-x^3}$, and $a\left(t\right)$ and $b\left(t\right)$ are expansions in the variable $t=-2{\left(\frac{5}{x}\right)}^3-1$.

For $-5\le x\le 0$,

$$Ai\left(x\right)=f\left(t\right)-xg\left(t\right)\text{,}$$

where $f$ and $g$ are expansions in $t=-2{\left(\frac{x}{5}\right)}^3-1\text{.}$

For $0<x<4.5$,

$$Ai\left(x\right)=e^{-3x/2}y\left(t\right)\text{,}$$

where $y$ is an expansion in $t=4x/9-1$.

For $4.5\le x<9$,

$$Ai\left(x\right)=e^{-5x/2}u\left(t\right)\text{,}$$

where $u$ is an expansion in $t=4x/9-3$.

For $x\ge 9$,

$$Ai\left(x\right)=\frac{e^{-z}v\left(t\right)}{x^{1/4}}\text{,}$$

where $z=\frac{2}{3}\sqrt{x^3}$ and $v$ is an expansion in $t=2\left(\frac{18}{z}\right)-1$.

For $\left|x\right|<\text{machine precision}$, the result is set directly to $Ai\left(0\right)$. This both saves time and guards against underflow in intermediate calculations.

For large negative arguments, it becomes impossible to calculate the phase of the oscillatory function with any precision and so the function must fail. This occurs if $x<-{\left(\frac{3}{2ϵ}\right)}^{2/3}$, where $ϵ$ is the machine precision.

For large positive arguments, where $\text{Ai}$ decays in an essentially exponential manner, there is a danger of underflow so the function must fail.

References

NIST Digital Library of Mathematical Functions