XLPack 6.0
Excel VBA Numerical Library Reference Manual
Loading...
Searching...
No Matches

◆ Sint1f()

Sub Sint1f ( N As  Long,
R() As  Double,
Wsave() As  Double,
Info As  Long,
Optional Inc As  Long = 1 
)

One-dimensional sine transform

Purpose
This routine computes the one-dimensional Fourier transform of an odd sequence within a real array. This is referred to as the forward transform or Fourier analysis, transforming the sequence from physical to spectral space.
R(k) = (2/(N+1))ΣR(j)sin(π(j+1)(k+1)/(N+1)) (Σ for j = 0 to N-1) (k = 0 to N-1)
This transform is normalized since a call to Sint1f followed by a call to Sint1b (or vice-versa) reproduces the original array subject to algorithmic constraints, roundoff error, etc.
Parameters
[in]NThe length of the sequence to be transformed. (N >= 1) (The transform is most efficient when N+1 is a product of small primes)
[in,out]R()Array R(LR - 1) (LR >= Inc*(N - 1) + 1)
[in] The sequence to be transformed.
[out] The Fourier forward transformed sequence of data.
[in]Wsave()Array Wsave(LWsave - 1) (LWsave >= N/2 + N + ln(N)/ln(2) + 4)
Work data. Its contents must be initialized with a call to Sint1i before the first call to Sint1f or Sint1b for a given transform length N.
[out]Info= 0: Successful exit.
= -1: The argument N had an illegal value. (N < 1)
= -2: The argument R() is invalid. (Array R() is not big enough)
= -3: The argument Wsave() is invalid. (Array Wsave() is not big enough)
= -5: The argument Inc had an illegal value. (Inc < 1)
[in]Inc(Optional)
Integer increment between the locations, in array R(), of two consecutive elements within the sequence. (Inc >= 1) (default = 1)
Reference
FFTPACK
Example Program
Compute the sine transform and backward transform of 5 random data sequence successively, and compare with the original data sequence.
Sub Ex_Sint1()
Const N = 5
Dim Wsave() As Double, R(N - 1) As Double, R0(N - 1) As Double
Dim LWsave As Long, Info As Long, I As Long
'-- Initialization
LWsave = N / 2 + N + Log(N) / Log(2) + 4
ReDim Wsave(LWsave - 1)
Call Sint1i(N, Wsave, Info)
If Info <> 0 Then GoTo Err
'-- Generate test data
For I = 0 To N - 1
R(I) = Rnd()
R0(I) = R(I)
Next
'-- Forward transform
Call Sint1f(N, R(), Wsave(), Info)
If Info <> 0 Then GoTo Err
'-- Backward transform
Call Sint1b(N, R(), Wsave(), Info)
If Info <> 0 Then GoTo Err
'-- Print result
For I = 0 To N - 1
Debug.Print R0(I), R(I), R(I) - R0(I)
Next
Exit Sub
Err:
Debug.Print "Error in Sint1i/Sint1f/Sint1b: Info =", Info
End Sub
Example Results
0.135438859462738 0.135438859462739 6.10622663543836E-16
0.714208960533142 0.714208960533142 -2.22044604925031E-16
0.37578684091568 0.37578684091568 5.55111512312578E-17
0.634888648986816 0.634888648986816 -2.22044604925031E-16
0.813576877117157 0.813576877117157 0