DataWindow (FPScript)

21.09.2021

Creates a uniformly spaced data taper of a given size.

Syntax

DataWindow(Length, Window [ , Adjustment ])

 

The syntax of the DataWindow function consists of the following parts:

Part

Description

Length

The length of the window.

Permitted data structures are scalar value. All integral data types are permitted.

The value must be greater or equal to 2.

Window

The fixed or adjustable data window to be applied to the data.

The argument Window can have the following values:

Constant

Meaning

WIN_RECTANGULAR

Rectangular -13 dB (no windowing, width=1)

WIN_WELCH

Welch -21 dB (fixed width=1.4)

WIN_SINE

Sine -23 dB (fixed width=1.5)

WIN_BISQUARE

Bi-Square or Connes -28 dB (fixed width=1.8)

WIN_BARTLETT

Bartlett -27 dB (fixed width=2)

WIN_HANNING

Hanning Max. Rolloff -31 dB (cosine, order 2, fixed width=2)

WIN_TUKEYHANN O

Tukey-Hann -37 dB (fixed width=2)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_BARTLETTMOD O

Modified Bartlett -39 dB (fixed width=2.3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_HAMMING

Hamming Min. Sidelobe -43 dB (cosine, order 2, fixed width=2)

WIN_COS3MAXROLLOFF O

C3 Max. Rolloff -47 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS3BLACKMAN

Blackman -58 dB (cosine, order 3, fixed width=3)

WIN_COS3BHARRIS62 O

Blackman-Harris -62 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS3NUTALL O

C1 Nutall -64 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS3BLACKMANEXACT O

Blackman Exact -68 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS3BHARRIS68 O

Blackman-Harris -68 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS3MINSIDELOBE O

Nutall -71 dB (cosine, order 3, fixed width=3)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4MAXROLLOFF O

C5 Max. Rolloff -61 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4BHARRIS74 O

Blackman-Harris -74 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4NUTALL83 O

C3 Nutall -83 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4BHARRIS92 O

Blackman-Harris -92 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4NUTALL93 O

C1 Nutall -93 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COS4NUTALL96 O

Nutall -96 dB (cosine, order 4, fixed width=4)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_FLATTOP

Flattop -68 dB (cosine, order 5, fixed width=5)

WIN_BETA O

Beta, Max. Rolloff (adjustable width=1.5-6)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COSMAXROLLOFF O

Cosine Max. Rolloff (adjustable width=1.5-6)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_KAISERBESSEL

Kaiser-Bessel (fixed width=3, adjustable width=1.5-6 with the Spectral Analysis option installed)

WIN_VANDERMAAS O

VanderMaas (adjustable width=1.5-6)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_CHEBYSHEV O

Chebyshev (adjustable width=1.75-5.75)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_CHEBYSHEVAPPROX O

Chebyshev Approx. (adjustable width=2.1-5)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_SLEPIAN O

Slepian DPSS-1 (adjustable width=2-5)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_GAUSS O

Gaussian (adjustable width=2-6)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

WIN_COSTAPER O

Tapered Cosine (adjustable width=1-2)

O This constant requires the option Order Tracking or the option Spectral Analysis to be licensed.

Adjustment

The one-sided Fourier width as a multiple of the frequency interval. The valid range is window specific within 1.0 to 6.0. The default is 1.5 for a tapered cosine window and 3.0 for all other adjustable data windows.

Permitted data structures are scalar value. All real data types are permitted.

Remarks

The result is a data series with the specified window. You can then apply that window to a time-domain signal with the same length with a simple multiplication.

If an argument is a list, then the first element in the list is taken. If this is also a list, then the process is repeated.

Available in

Option Spectral Analysis

Examples

DataWindow(100, WIN_FLATTOP)

Generates a FlatTop window with 100 values. This window is appropriate for exact measurement of peaks in amplitude spectra.

See Also

ApplyWindow Function

VarWindow Function

FFTn Function

Spectral Analysis Option

Data Tapering Window

Fourier Spectral Analysis

Share article or send as email:

You might be interested in these articles