naginterfaces.library.specfun.mathieu_ang_periodic_real¶
- naginterfaces.library.specfun.mathieu_ang_periodic_real(ordval, q, parity, mode, x=None)[source]¶
mathieu_ang_periodic_real
calculates real-valued periodic angular Mathieu functions ( or ) and/or their first derivatives, where and are solutions to the Mathieu differential equation .For full information please refer to the NAG Library document for s22ca
https://support.nag.com/numeric/nl/nagdoc_30.2/flhtml/s/s22caf.html
- Parameters
- ordvalint
, the order number of the Mathieu function to be computed.
- qfloat
, the Mathieu function parameter.
- parityint
Specifies whether to compute even or odd Mathieu function.
Compute even Mathieu function, .
Compute odd Mathieu function, .
- modeint
Specifies whether the Mathieu function or its derivative is required.
Compute Mathieu function values.
Compute derivative values of Mathieu function.
Compute both Mathieu function and derivative values.
Compute neither Mathieu functions nor derivative values, returns only (the characteristic value).
- xNone or float, array-like, shape , optional
Note: the required length for this argument is determined as follows: if : ; otherwise: .
The values of at which to compute Mathieu function or derivative values.
- Returns
- fNone or float, ndarray, shape
If or , the Mathieu function values or . If or , is not used.
- f_derivNone or float, ndarray, shape
If or , the Mathieu function derivative values or . If or , is not used.
- afloat
, the characteristic value for the Mathieu function.
- Raises
- NagValueError
- (errno )
On entry, and .
Constraint: if , or if , .
- (errno )
On entry, .
Constraint: or .
- (errno )
On entry, .
Constraint: , , or .
- (errno )
On entry, .
Constraint: .
- Notes
mathieu_ang_periodic_real
calculates an approximation to and/or , or and/or , where and are respectively the even and odd parity real-valued periodic angular Mathieu functions, for an array of values of , and for integer order value , where for even parity, and for odd parity. The function also returns values of for these periodic Mathieu functions, this is known as the characteristic value or eigenvalue.The solutions are computed by approximating Mathieu functions as Fourier series, where expansion coefficients are obtained by solving the eigenvalue problem generated from the relevant recurrence relation, see Module 28 in NIST Digital Library of Mathematical Functions.
- References
NIST Digital Library of Mathematical Functions