naginterfaces.library.specfun.kelvin_kei_vector¶
- naginterfaces.library.specfun.kelvin_kei_vector(x)[source]¶
kelvin_kei_vector
returns an array of values for the Kelvin function .For full information please refer to the NAG Library document for s19ar
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/s/s19arf.html
- Parameters
- xfloat, array-like, shape
The argument of the function, for .
- Returns
- ffloat, ndarray, shape
, the function values.
- ivalidint, ndarray, shape
contains the error code for , for .
No error.
is too large, the result underflows. contains zero. The threshold value is the same as for = 1 in
kelvin_kei()
., the function is undefined. contains .
- Raises
- NagValueError
- (errno )
On entry, .
Constraint: .
- Warns
- NagAlgorithmicWarning
- (errno )
On entry, at least one value of was invalid.
Check for more information.
- Notes
kelvin_kei_vector
evaluates an approximation to the Kelvin function for an array of arguments , for .Note: for the function is undefined, so we need only consider .
The function is based on several Chebyshev expansions:
For ,
where , and are expansions in the variable ;
For ,
where is an expansion in the variable ;
For ,
where , and and are expansions in the variable .
For , the function is undefined, and hence the function fails and returns zero.
When is sufficiently close to zero, the result is computed as
and when is even closer to zero simply as
For large , is asymptotically given by and this becomes so small that it cannot be computed without underflow and the function fails.
- References
NIST Digital Library of Mathematical Functions