Saltar navegación

Documentación de FlexPro 2025

STFTSpectrum

Calcula un espectro de tiempo-frecuencia mediante la transformada de Fourier de tiempo corto (STFT).

Sintaxis

STFTSpectrum(Signal, [ SpectrumType = SPECTRUM_DBNORM ], [ Window = WIN_HANNING ], [ Adjustment ], [ SegmentLength = 0 ], [ OverlapOrGap = 50 ], [ FFTLength = 0 ], [ dBLimit = 0 ] [ , MaxFrequencies = 0 ])

 

La sintaxis de la función STFTSpectrum consta de los siguientes elementos:

Parte

Descripción

Signal

Los datos que se van a analizar. Los datos deben tener una frecuencia de muestreo constante y no deben contener valores inválidos.

Las estructuras de datos permitidas son Serie de datos y Señal. Se permiten todos los tipos de datos reales excepto Tiempo de calendario y Intervalo de tiempo.

No se permiten valores inválidos en este argumento.

Se aplican restricciones adicionales al componente X. Los valores deben tener un espaciado positivo constante. No se permiten valores inválidos en este argumento.

Si el argumento es una lista, la función se ejecuta para cada elemento de la lista y el resultado también es una lista.

SpectrumType

El tipo de espectro que se va a calcular.

El argumento SpectrumType puede tener los siguientes valores:

Constante

Significado

SPECTRUM_AMPLITUDE

Amplitud

SPECTRUM_RMSAMPLITUDE

Amplitud RMS

SPECTRUM_AMPLITUDE2

Amplitud2

SPECTRUM_DB O

Amplitud en dB (decibelios)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_DBNORM O

dB (decibelios), valor máximo normalizado a cero

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_PSD O

PSD (densidad espectral de potencia)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_TISA O

TISA (amplitud2 integrada en el tiempo)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_MSA

MSA (amplitud2 promediada)

SPECTRUM_SSA O

SSA (amplitud2 sumada)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_VARIANCE O

Potencia, normalizada a la varianza

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_MAGNITUDE2 O

Magnitud2

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

SPECTRUM_MAGNITUDE O

Magnitud

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

+ SPECTRUM_NORMDATALENGTH O

Si se añade esta constante a uno de los tipos de espectro anteriores, los espectros se normalizan a la longitud de datos en lugar de a la longitud del segmento, de forma análoga al periodograma.

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

Se establece el valor predeterminado SPECTRUM_DBNORM si no se especifica el argumento.

Window

La ventana fija o ajustable que se va a aplicar.

El argumento Window puede tener los siguientes valores:

Constante

Significado

WIN_RECTANGULAR

Rectángulo -13 dB (sin ventana, ancho=1)

WIN_WELCH

Welch -21 dB (ancho fijo=1,4)

WIN_SINE

Seno -23 dB (ancho fijo=1,5)

WIN_BISQUARE

Bi-Cuadrada o Connes -28 dB (ancho fijo=1,8)

WIN_BARTLETT

Bartlett -27 dB (ancho fijo=2)

WIN_HANNING

Hanning Rolloff máx. -31 dB (coseno, orden 2, ancho fijo=2)

WIN_TUKEYHANN O

Tukey-Hann -37 dB (ancho fijo=2)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_BARTLETTMOD O

Bartlett mod. -39 dB (ancho fijo=2,3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_HAMMING

Hanning Sidelobe min. -43 dB (coseno, orden 2, ancho fijo=2)

WIN_COS3MAXROLLOFF O

C3 Rolloff máx. -47 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS3BLACKMAN

Blackman -58 dB (coseno, orden 3, ancho fijo=3)

WIN_COS3BHARRIS62 O

Blackman-Harris -62 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS3NUTALL O

C1 Nutall -64 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS3BLACKMANEXACT O

Blackman exacto -68 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS3BHARRIS68 O

Blackman-Harris -68 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS3MINSIDELOBE O

Nutall -71 dB (coseno, orden 3, ancho fijo=3)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4MAXROLLOFF O

C5 Rolloff máx. -61 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4BHARRIS74 O

Blackman-Harris -74 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4NUTALL83 O

C3 Nutall -83 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4BHARRIS92 O

Blackman-Harris -92 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4NUTALL93 O

C1 Nutall -93 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COS4NUTALL96 O

Nutall -96 dB (coseno, orden 4, ancho fijo=4)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_FLATTOP

Flattop -68 dB (coseno, orden 5, ancho fijo=5)

WIN_BETA O

Beta, máx. Rollof (ancho ajustable =1,5-6)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COSMAXROLLOFF O

Máx. coseno Rolloff (ancho ajustable =1,5-6)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_KAISERBESSEL

Kaiser-Bessel (ancho fijo=3, ancho ajustable =1,5-6 con la opción de análisis espectral instalada)

WIN_VANDERMAAS O

VanderMaas (ancho ajustable =1,5-6)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_CHEBYSHEV O

Chebyshev (ancho ajustable =1,75-5,75)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_CHEBYSHEVAPPROX O

Chebyshev aproximado (ancho ajustable =2,1-5)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_SLEPIAN O

Slepian DPSS-1 (ancho ajustable =2-5)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_GAUSS O

Gaussiano (ancho ajustable =2-6)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

WIN_COSTAPER O

Coseno atenuado (ancho ajustable =1-2)

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

+ WIN_NORMALIZEAMPLITUDE

Si esta constante se añade a una de las constantes de ventana anteriores, se realiza una normalización de amplitud después de la ventana de ponderación. En este caso, normalizado con respecto a la ganancia de la ventana de ponderación utilizada, es decir, la suma de todos los valores de la ventana de ponderación dividida por su número. Esto compensa la atenuación de las amplitudes causada por la ventana de ponderación de los datos y, por tanto, es especialmente adecuado para medir picos en el espectro.

+ WIN_NORMALIZEPOWER O

Si esta constante se añade a una de las constantes de ventana anteriores, se realiza una normalización de la potencia después de la función de ventana. De este modo se compensa la pérdida de potencia, es decir, se utiliza como factor de normalización el cociente de la suma de los cuadrados de los datos antes y después de la función de ventana.

O Esta constante solo está disponible si la opción Análisis de órdenes o la opción Análisis espectral tenía licencia.

Se establece el valor predeterminado WIN_HANNING si no se especifica el argumento.

Adjustment

El ancho de Fourier unilateral como múltiplo del intervalo de frecuencia. El intervalo válido depende de la ventana y está comprendido entre 1,0 y 6,0. El valor predeterminado es 1,5 para una ventana de coseno cónico y 3,0 para el resto de las ventanas ajustables.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales.

SegmentLength

La longitud de los segmentos de datos individuales. El rango válido está comprendido entre 2 y la longitud de los datos / 2. El valor predeterminado 0 establece la longitud del segmento en el doble de la raíz cuadrada de la longitud de los datos, redondeada a la potencia de dos más cercana.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos enteros.

Se establece el valor predeterminado 0 si no se especifica el argumento.

OverlapOrGap

Si este argumento se especifica como un número positivo, define el porcentaje de solapamiento de los segmentos de datos individuales. Si se especifica como un número negativo, su valor establece el espacio entre los segmentos de datos individuales en puntos de muestreo.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales.

El valor debe ser menor o igual que 95.

Se establece el valor predeterminado 50 si no se especifica el argumento.

FFTLength

La longitud de las transformadas de Fourier individuales. Si la longitud de la FFT especificada es mayor que la longitud del segmento, se añaden ceros. El rango válido está entre la longitud del segmento y la longitud máxima para la FFT. Un valor de 0 ajusta la longitud de la FFT a la longitud del segmento.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos enteros.

El valor debe ser mayor o igual que 0 y menor o igual que 268435456.

Se establece el valor predeterminado 0 si no se especifica el argumento.

dBLimit

La línea de base en dB que se debe aplicar al espectro. El rango oscila entre 1,0 dB y 120,0 dB o 0 para ninguna línea de base.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales. El argumento se transforma en la unidad dB.

El valor debe ser mayor o igual que 0,0 dB y menor o igual que 120,0 dB.

Se establece el valor predeterminado 0 si no se especifica el argumento.

MaxFrequencies

Número máximo de valores de frecuencia en la STFT (solo espectro PSD de potencia normalizada). El rango está entre 10 y 10000; 0 significa sin límite.

Las estructuras de datos permitidas son Valor escalar. Se permiten todos los tipos de datos reales.

Se establece el valor predeterminado 0 si no se especifica el argumento.

Notas

El resultado siempre tiene la estructura de datos Serie de señales con componente Z.

El componente X contiene la frecuencia y el componente Z los tiempos de inicio de los segmentos. Si el argumento Signal es una serie de datos, el componente X del resultado contiene las frecuencias normalizadas de Nyquist y el componente Z contiene los valores de índice de los inicios de segmento.

El siguiente gráfico visualiza la configuración para la longitud del segmento, el solapamiento y la longitud de la FFT:

Disponibilidad

FlexPro Professional, Developer Suite

Ejemplos

TransposeMatrix(STFTSpectrum(Signal, SPECTRUM_DBNORM, WIN_HANNING + WIN_NORMALIZEPOWER, 2, 256, 50, 0, 20, 0))

Calcula el espectro STFT de una señal y luego transpone el resultado de modo que las frecuencias se asignen al componente Z. Se selecciona dB normalizado como tipo de espectro. La ventana utilizada es Cos2 Hanning -31 dB W=2. La longitud de la FFT se ajusta a la longitud del segmento, que tiene el valor 256. Este es un ejemplo del tutorial Análisis espectral de tiempo-frecuencia.

Véase también

Función CWTSpectrum

Función FFTn

Función FourierSpectrum

Función Periodogram

Opción Análisis espectral

Objeto de análisis Análisis espectral de tiempo-frecuencia

Transformada de Fourier de tiempo corto (STFT)

Funciones de ventana

Tutorial Análisis espectral de tiempo-frecuencia