s18ac returns the value of the modified Bessel function .
Syntax
C# |
---|
public static double s18ac( double x, out int ifail ) |
Visual Basic |
---|
Public Shared Function s18ac ( _ x As Double, _ <OutAttribute> ByRef ifail As Integer _ ) As Double |
Visual C++ |
---|
public: static double s18ac( double x, [OutAttribute] int% ifail ) |
F# |
---|
static member s18ac : x : float * ifail : int byref -> float |
Parameters
- x
- Type: System..::..DoubleOn entry: the argument of the function.Constraint: .
- ifail
- Type: System..::..Int32%On exit: unless the method detects an error or a warning has been flagged (see [Error Indicators and Warnings]).
Return Value
s18ac returns the value of the modified Bessel function .
Description
s18ac evaluates an approximation to the modified Bessel function of the second kind .
Note: is undefined for and the method will fail for such arguments.
The method is based on five Chebyshev expansions:
For ,
For ,
For ,
For ,
For near zero, , where denotes Euler's constant. This approximation is used when is sufficiently small for the result to be correct to machine precision.
For large , where there is a danger of underflow due to the smallness of , the result is set exactly to zero.
References
Abramowitz M and Stegun I A (1972) Handbook of Mathematical Functions (3rd Edition) Dover Publications
Error Indicators and Warnings
Errors or warnings detected by the method:
- , is undefined. On failure the method returns zero.
Accuracy
Let and be the relative errors in the argument and result respectively.
If is somewhat larger than the machine precision (i.e., if is due to data errors etc.), then and are approximately related by:
Figure 1 shows the behaviour of the error amplification factor
However, if is of the same order as machine precision, then rounding errors could make slightly larger than the above relation predicts.
For small , the amplification factor is approximately
, which implies strong attenuation of the error, but in general can never be less than the machine precision.
For large , and we have strong amplification of the relative error. Eventually , which is asymptotically given by , becomes so small that it cannot be calculated without underflow and hence the method will return zero. Note that for large the errors will be dominated by those of the standard function exp.
Parallelism and Performance
None.
Further Comments
None.
Example
This example reads values of the argument from a file, evaluates the function at each value of and prints the results.
Example program (C#): s18ace.cs