scorr_nonperiodic, dcorr_nonperiodic, ccorr_nonperiodic, zcorr_nonperiodic  

Nonperiodic correlation

FORMAT

  {S,D,C,Z}CORR_NONPERIODIC (x, y, out, nx, ny, status)

Arguments

  x                   real*4 | real*8 | complex*8 | complex*16
                      On entry, an array containing the data to be
                      correlated.
                      On exit, x is unchanged.

  y                   real*4 | real*8 | complex*8 | complex*16
                      On entry, an array containing the function to be
                      correlated with the data from the X array.
                      On exit, y is unchanged.

  out                 real*4 | real*8 | complex*8 | complex*16
                      On entry, a one-dimensional array OUT with the length
                      nx.
                      On exit, out contains the positive correlation
                      coefficients.

  nx                  integer*4
                      On entry, the number of values to be correlated, that
                      is, the length of the X array; nx > 0.
                      On exit, nx is unchanged.

  ny                  integer*4
                      On entry, the length of the Y array containing the
                      correlation function; ny > 0.
                      On exit, ny is unchanged.

  status              integer*4

                      status = 0 :DXML_SUCCESS()

                      status = 8 :DXML_ILL_N_RANGE()

Description

  The _CORR_NONPERIODIC functions compute the nonperiodic correlation of two
  arrays using a discrete summing technique.

Example

  INCLUDE 'CXMLDEF.FOR'
  INTEGER*4 N_F, N_M, STATUS
  REAL*8 A(500), B(15000), C(500)
  N_A = 500
  N_B = 15000
  CALL DCORR_NONPERIODIC(A,B,C,N_A,N_B,STATUS)

  This FORTRAN code computes the nonperiodic correlation of two vectors of
  double-precision real numbers, a and b, with lengths of 500 and 15000,
  respectively. The result is stored in c with length of 15499.