------------------------------------------------------------------------ IMSL Name: CCORL/DCCORL (Single/Double precision version) Revised: June 10, 1991 Purpose: Compute the correlation of two complex vectors. Usage: CALL CCORL (IDO, N, X, Y, IPAD, NZ, Z, ZHAT) Arguments: IDO - Flag indicating the usage of CCORL. (Input) IDO Usage 0 If this is the only call to CCORL. If CCORL is called multiple times in sequence with the same NX, NY, and IPAD, IDO should be set to 1 on the first call 2 on the intermediate calls 3 on the final call. N - Length of the X and Y vectors. (Input) X - Complex vector of length N. (Input) Y - Complex vector of length N. (Input) IPAD - IPAD should be set as folows. (Input) IPAD = 0 for periodic data with X and Y different. IPAD = 1 for nonperiodic data with X and Y different. IPAD = 2 for periodic data with X and Y identical. IPAD = 3 for nonperiodic data with X and Y identical. NZ - Length of the vector Z. (Input/Output) Upon input: When IPAD is zero or two, NZ must be at least (2*N-1). When IPAD is one or three, NZ must be greater than or equal to the smallest integer greater than or equal to (2*N-1) of the form (2**alpha)*(3**beta)*(5**gamma) where alpha, beta, and gamma are nonnegative integers. Upon output, the value for NZ that was used by CCORL. Z - Complex vector of length NZ containing the correlation of X and Y. (Output) ZHAT - Complex vector of length NZ containing the inverse discrete complex Fourier transform of Z. (Output) Remarks: 1. Automatic workspace usage is CCORL 10*NZ+15 units, or DCCORL 20*NZ+30 units. Workspace may be explicitly provided, if desired, by use of C2ORL/DC2ORL. The reference is CALL C2ORL (IDO, N, X, Y, IPAD, NZ, Z, ZHAT, XWK, YWK, WK) The additional arguments are as follows: XWK - Complex work array of length NZ. YWK - Complex work array of length NZ. WK - Real work arrary of length 6*NZ+15. 2. Informational error Type Code 4 1 The length of the vector Z must be large enough to hold the results. An acceptable length is returned in NZ. GAMS: L1c1b Chapter: MATH/LIBRARY Transforms Page No.: MATH/LIBRARY User's Manual page 916 ------------------------------------------------------------------------ IMSL Name: CCORL/DCCORL (Single/Double precision version) Revised: June 10, 1991 Purpose: Compute the correlation of two complex vectors. Usage: CALL CCORL (IDO, N, X, Y, IPAD, NZ, Z, ZHAT) Arguments: IDO - Flag indicating the usage of CCORL. (Input) IDO Usage 0 If this is the only call to CCORL. If CCORL is called multiple times in sequence with the same NX, NY, and IPAD, IDO should be set to 1 on the first call 2 on the intermediate calls 3 on the final call. N - Length of the X and Y vectors. (Input) X - Complex vector of length N. (Input) Y - Complex vector of length N. (Input) IPAD - IPAD should be set as folows. (Input) IPAD = 0 for periodic data with X and Y different. IPAD = 1 for nonperiodic data with X and Y different. IPAD = 2 for periodic data with X and Y identical. IPAD = 3 for nonperiodic data with X and Y identical. NZ - Length of the vector Z. (Input/Output) Upon input: When IPAD is zero or two, NZ must be at least (2*N-1). When IPAD is one or three, NZ must be greater than or equal to the smallest integer greater than or equal to (2*N-1) of the form (2**alpha)*(3**beta)*(5**gamma) where alpha, beta, and gamma are nonnegative integers. Upon output, the value for NZ that was used by CCORL. Z - Complex vector of length NZ containing the correlation of X and Y. (Output) ZHAT - Complex vector of length NZ containing the inverse discrete complex Fourier transform of Z. (Output) Remarks: 1. Automatic workspace usage is CCORL 10*NZ+15 units, or DCCORL 20*NZ+30 units. Workspace may be explicitly provided, if desired, by use of C2ORL/DC2ORL. The reference is CALL C2ORL (IDO, N, X, Y, IPAD, NZ, Z, ZHAT, XWK, YWK, WK) The additional arguments are as follows: XWK - Complex work array of length NZ. YWK - Complex work array of length NZ. WK - Real work arrary of length 6*NZ+15. 2. Informational error Type Code 4 1 The length of the vector Z must be large enough to hold the results. An acceptable length is returned in NZ. GAMS: L1c1b Chapter: MATH/LIBRARY Transforms Page No.: MATH/LIBRARY User's Manual page 916