1: $result$ – double scalar: The result of the function.
2: $ifail$ – int64int32nag_int scalar: $ifail = 0$ unless the function detects an error (see Error Indicators and Warnings).

Error Indicators and Warnings

Errors or warnings detected by the function:

$ifail = 1$: On entry, $x \leq 0.0$ , $K_{0}$ is undefined.

On soft failure, nag_specfun_bessel_k0_scaled (s18cc) returns zero.

$ifail = - 99$: An unexpected error has been triggered by this routine. Please contact NAG.

$ifail = - 399$: Your licence key may have expired or may not have been installed correctly.

$ifail = - 999$: Dynamic memory allocation failed.

Accuracy

Relative errors in the argument are attenuated when propagated into the function value. When the accuracy of the argument is essentially limited by the machine precision, the accuracy of the function value will be similarly limited by at most a small multiple of the machine precision.

Further Comments

None.

Example

This example reads values of the argument

x

from a file, evaluates the function at each value of

x

and prints the results.

Open in the MATLAB editor: s18cc_example

function s18cc_example


fprintf('s18cc example results\n\n');

x = [0.4  0.6  1.4  2.5  10  1000];
n = size(x,2);
result = x;

for j=1:n
  [result(j), ifail] = s18cc(x(j));
end

disp('      x        e^xK_0(x)');
fprintf('%12.3e%12.3e\n',[x; result]);

s18cc example results

      x        e^xK_0(x)
   4.000e-01   1.663e+00
   6.000e-01   1.417e+00
   1.400e+00   9.881e-01
   2.500e+00   7.595e-01
   1.000e+01   3.916e-01
   1.000e+03   3.963e-02

PDF version (NAG web site, 64-bit version, 64-bit version)

Chapter Contents

Chapter Introduction

NAG Toolbox