Admin Production ni-theme
Current Publication

SymWin

LabWindows/CVI

SymWin

Advanced Analysis Library Only

AnalysisLibErrType SymWin (double arrayX[], ssize_t numberOfElements, int windowType, double windowParameter);

Purpose

Applies a symmetric window to a real signal. Symmetric windows are often used in digital filter design, whereas asymmetrical windows are often used in spectrum estimation. For a given window type, the coefficients of an n-point asymmetrical window are the same as the first n coefficients of the (n+1)-point symmetric window, as shown in the following illustration.

loc_fp_symwin.gif

Parameters

Input
Name Type Description
numberOfElements ssize_t The number of elements in arrayX.
windowType int The type of window to apply. windowType must be one of the following values:
Window Type Constant Value
Rectangle RECTANGLE 0
Hanning HANNING 1
Hamming HAMMING 2
Blackman-Harris BLKHARRIS 3
Exact Blackman EXBLKMAN 4
Blackman BLKMAN 5
Flat Top FLATTOP 6
4-Term Blackman-Harris BH4TERM 7
7-Term Blackman-Harris BH7TERM 8
Lowside LB LOWSIDELB 9
Blackman-Nuttall BLKMANNUTTAL 11
Triangle TRIANGLE 30
Barthann BARTHANN 31
Bohman BOHMAN 32
Parzen PARZEN 33
Welch WELCH 34
Kaiser KAISER 60
Dolph-Chebyshev DOLCHEBYSHEV 61
Gaussian GAUSSIAN 62
windowParameter double The window parameter. This parameter is referenced only if windowType is one of the following values:
  • KAISER: windowParameter specifies the beta parameter for a Kaiser window.
  • GAUSSIAN: windowParameter specifies the standard deviation for a Gaussian window. If windowParameter < 0, the function uses 0.2 for windowParameter instead.
  • DOLCHEBYSHEV: windowParameter specifies the ratio of the mainlobe to the sidelobe, in dB, for a Dolph-Chebyshev window. If windowParameter < 0, the function uses 60dB for windowParameter instead.
Output
Name Type Description
arrayX double [] On input, the input signal.

On output, this parameter returns the input signal with the selected window applied.

Return Value

Name Type Description
status AnalysisLibErrType A value that specifies the type of error that occurred. Refer to analysis.h for definitions of these constants.

Additional Information

Library: Advanced Analysis Library

Include file: analysis.h

LabWindows/CVI compatibility: LabWindows/CVI 8.0 and later