EJCN
This function evaluates the Jacobi elliptic function cn(x, m).
Function Return Value
EJCN — Real or complex function value. (Output)
Required Arguments
X — Real or complex argument for which the function value is desired. (Input)
AM — Parameter of the elliptic function (m = k2). (Input)
FORTRAN 90 Interface
Generic: EJCN (X, AM)
Specific: The specific interface names are S_EJCN, D_EJCN, C_EJCN, and Z_EJCN.
FORTRAN 77 Interface
Single: EJCN (X, AM)
Double: The double precision name is DEJCN.
Complex: The complex name is CEJCN.
Double Complex: The double complex name is ZEJCN.
Description
The Jacobi elliptic function cn(x, m) = cos ɸ, where the amplitude ɸ is defined by the following:
The function cn(x, m) is computed by first applying, if necessary, a Jacobi transformation so that the parameter, m, is between zero and one. Then, a descending Landen (Gauss) transform is applied until the parameter is small. The small parameter approximation is then applied.
Comments
Informational errors
Type | Code | Description |
|---|
3 | 2 | The result is accurate to less than one half precision because ∣X∣ is too large. |
3 | 2 | The result is accurate to less than one half precision because ∣REAL (Z)∣ is too large. |
3 | 3 | The result is accurate to less than one half precision because ∣AIMAG (Z)∣ is too large. |
3 | 5 | Landen transform did not converge. Result may not be accurate. This should never occur. |
Examples
Example 1
In this example, cn(1.5, 0.5) is computed and printed.
USE EJCN_INT
USE UMACH_INT
IMPLICIT NONE
! Declare variables
INTEGER NOUT
REAL AM, VALUE, X
! Compute
AM = 0.5
X = 1.5
VALUE = EJCN(X, AM)
! Print the results
CALL UMACH (2, NOUT)
WRITE (NOUT,99999) X, AM, VALUE
99999 FORMAT (' EJCN(', F6.3, ',', F6.3, ') = ', F6.3)
END
Output
EJCN( 1.500, 0.500) = 0.250
Example 2
In this example, cn(1.5 + 0.3i, 0.5) is computed and printed.
USE EJCN_INT
USE UMACH_INT
IMPLICIT NONE
! Declare variables
INTEGER NOUT
REAL AM
COMPLEX VALUE, Z
! Compute
Z = (1.5, 0.3)
AM = 0.5
VALUE = EJCN(Z, AM)
! Print the results
CALL UMACH (2, NOUT)
WRITE (NOUT,99999) Z, AM, VALUE
99999 FORMAT (' EJCN((', F6.3, ',', F6.3, '), ', F6.3, ') = (', &
F6.3, ',', F6.3, ')')
END
Output
EJCN(( 1.500, 0.300), 0.500) = ( 0.251,-0.212)
