external/fftpack/fftpack5/sinqmb.F

   1 subroutine sinqmb ( lot, jump, n, inc, x, lenx, wsave, lensav, &
   2   work, lenwrk, ier )
   3
   4 !*****************************************************************************80
   5 !
   6 !! SINQMB: real single precision backward sine quarter wave, multiple vectors.
   7 !
   8 !  Discussion:
   9 !
  10 !    SINQMB computes the one-dimensional Fourier transform of multiple
  11 !    sequences within a real array, where each of the sequences is a
  12 !    sine series with odd wave numbers.  This transform is referred to as
  13 !    the backward transform or Fourier synthesis, transforming the
  14 !    sequences from spectral to physical space.
  15 !
  16 !    This transform is normalized since a call to SINQMB followed
  17 !    by a call to SINQMF (or vice-versa) reproduces the original
  18 !    array  within roundoff error.
  19 !
  20 !
  21 !    Copyright (C) 1995-2004, Scientific Computing Division,
  22 !    University Corporation for Atmospheric Research
  23 !
  24 !  Modified:
  25 !
  26 !    03 April 2005
  27 !
  28 !  Author:
  29 !
  30 !    Paul Swarztrauber
  31 !    Richard Valent
  32 !
  33 !  Reference:
  34 !
  35 !    Paul Swarztrauber,
  36 !    Vectorizing the Fast Fourier Transforms,
  37 !    in Parallel Computations,
  38 !    edited by G. Rodrigue,
  39 !    Academic Press, 1982.
  40 !
  41 !    Paul Swarztrauber,
  42 !    Fast Fourier Transform Algorithms for Vector Computers,
  43 !    Parallel Computing, pages 45-63, 1984.
  44 !
  45 !  Parameters:
  46 !
  47 !    Input, integer ( kind = 4 ) LOT, the number of sequences to be transformed
  48 !    within array R.
  49 !
  50 !    Input, integer ( kind = 4 ) JUMP, the increment between the locations, in
  51 !    array R, of the first elements of two consecutive sequences to be
  52 !    transformed.
  53 !
  54 !    Input, integer ( kind = 4 ) N, the length of each sequence to be
  55 !    transformed.  The transform is most efficient when N is a product of
  56 !    small primes.
  57 !
  58 !    Input, integer ( kind = 4 ) INC, the increment between the locations, in
  59 !    array R, of two consecutive elements within the same sequence.
  60 !
  61 !    Input/output, real ( kind = 4 ) R(LENR), containing LOT sequences, each
  62 !    having length N.  R can have any number of dimensions, but the total
  63 !    number of locations must be at least LENR.  On input, R contains the data
  64 !    to be transformed, and on output the transformed data.
  65 !
  66 !    Input, integer ( kind = 4 ) LENR, the dimension of the R array.
  67 !    LENR must be at least (LOT-1)*JUMP + INC*(N-1)+ 1.
  68 !
  69 !    Input, real ( kind = 4 ) WSAVE(LENSAV).  WSAVE's contents must be
  70 !    initialized with a call to SINQMI before the first call to routine SINQMF
  71 !    or SINQMB for a given transform length N.  WSAVE's contents may be re-used
  72 !    for subsequent calls to SINQMF and SINQMB with the same N.
  73 !
  74 !    Input, integer ( kind = 4 ) LENSAV, the dimension of the WSAVE array.
  75 !    LENSAV must be at least 2*N + INT(LOG(REAL(N))) + 4.
  76 !
  77 !    Workspace, real ( kind = 4 ) WORK(LENWRK).
  78 !
  79 !    Input, integer ( kind = 4 ) LENWRK, the dimension of the WORK array.
  80 !    LENWRK must be at least LOT*N.
  81 !
  82 !    Output, integer ( kind = 4 ) IER, error flag.
  83 !    0, successful exit;
  84 !    1, input parameter LENR not big enough;
  85 !    2, input parameter LENSAV not big enough;
  86 !    3, input parameter LENWRK not big enough;
  87 !    4, input parameters INC,JUMP,N,LOT are not consistent;
  88 !    20, input error returned by lower level routine.
  89 !
  90   implicit none
  91
  92   integer ( kind = 4 ) inc
  93   integer ( kind = 4 ) lensav
  94   integer ( kind = 4 ) lenwrk
  95
  96   integer ( kind = 4 ) ier
  97   integer ( kind = 4 ) ier1
  98   integer ( kind = 4 ) jump
  99   integer ( kind = 4 ) k
 100   integer ( kind = 4 ) kc
 101   integer ( kind = 4 ) lenx
 102   integer ( kind = 4 ) lj
 103   integer ( kind = 4 ) lot
 104   integer ( kind = 4 ) m
 105   integer ( kind = 4 ) n
 106   integer ( kind = 4 ) ns2
 107   real ( kind = 4 ) work(lenwrk)
 108   real ( kind = 4 ) wsave(lensav)
 109   real ( kind = 4 ) x(inc,*)
 110   logical              xercon
 111   real ( kind = 4 ) xhold
 112
 113   ier = 0
 114
 115   if ( lenx < ( lot - 1 ) * jump + inc * ( n - 1 ) + 1 ) then
 116     ier = 1
 117     call xerfft ( 'sinqmb', 6 )
 118     return
 119   end if
 120
 121   if ( lensav < 2 * n + int ( log ( real ( n, kind = 4 ) ) ) + 4 ) then
 122     ier = 2
 123     call xerfft ( 'sinqmb', 8 )
 124     return
 125   end if
 126
 127   if ( lenwrk < lot * n ) then
 128     ier = 3
 129     call xerfft ( 'sinqmb', 10 )
 130     return
 131   end if
 132
 133   if ( .not. xercon ( inc, jump, n, lot ) ) then
 134     ier = 4
 135     call xerfft ( 'sinqmb', -1 )
 136     return
 137   end if
 138
 139   lj = ( lot - 1 ) * jump + 1
 140
 141   if ( n <= 1 ) then
 142     do m = 1, lj, jump
 143       x(m,1) = 4.0E+00 * x(m,1)
 144     end do
 145     return
 146   end if
 147
 148   ns2 = n / 2
 149
 150   do k = 2, n, 2
 151     do m = 1, lj, jump
 152       x(m,k) = -x(m,k)
 153     end do
 154   end do
 155
 156   call cosqmb ( lot, jump, n, inc, x, lenx, wsave, lensav, work, lenwrk, ier1 )
 157
 158   if ( ier1 /= 0 ) then
 159     ier = 20
 160     call xerfft ( 'sinqmb', -5 )
 161     return
 162   end if
 163
 164   do k = 1, ns2
 165     kc = n - k
 166     do m = 1, lj, jump
 167       xhold = x(m,k)
 168       x(m,k) = x(m,kc+1)
 169       x(m,kc+1) = xhold
 170     end do
 171   end do
 172
 173   return
 174 end