Saltar navegación

Documentación de FlexPro 2025

Coherence

Calcula el espectro de coherencia entre dos conjuntos de datos.

Sintaxis

Coherence(SignalA, SignalB, [ SpectrumType = COHERENCE_MAGNITUDE2 ], [ Window = WIN_HANNING ], [ Adjustment ], [ SegmentLength = 0 ], [ OverlapOrGap = 50 ], [ FFTLength = 0 ] [ , Peaks ])

 

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

Parte

Descripción

SignalA

El primer conjunto de datos que se va a analizar.

Las estructuras de datos permitidas son Serie de datos, Señal y Serie de señales. 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.

SignalB

El segundo conjunto de datos que se va a analizar.

Las estructuras de datos permitidas son Serie de datos, Señal y Serie de señales. 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 coherencia o espectro S/N que se va a calcular.

El argumento SpectrumType puede tener los siguientes valores:

Constante

Significado

COHERENCE_MAGNITUDE2

Coherencia de la magnitud²

COHERENCE_SNR

Espectro de la relación señal/ruido

COHERENCE_SNR_DB

Relación señal/ruido en dB (decibelios)

COHERENCE_SNR_DBNORM

Relación señal/ruido en dB (decibelios), valor de pico normalizado a cero.

+ SPECTRUM_PEAKS O

Si se añade esta constante a uno de los tipos de espectro anteriores, solo se mostrarán los picos del espectro. La adición de esta constante corresponde al valor 10 para el argumento Peaks.

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

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

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Se establece el valor predeterminado COHERENCE_MAGNITUDE2 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.

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

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

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.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

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 ajusta la longitud del segmento a la longitud de datos / 4.

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

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

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.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

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

FFTLength

La longitud de la transformada de Fourier. 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.

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

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

Peaks

Si se especifica, solo se emiten los picos del espectro interpolados por banda. Los picos pueden especificarse como un número o determinarse mediante un umbral de dB. Especifique un número positivo entre 1 y 100 sin unidad. Puede especificar un umbral dB como una magnitud física con la unidad dB entre 0,01 dB y 300 dB o como un número negativo entre -0,01 y -300 sin unidad.

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

Si el argumento es una lista, se toma su primer elemento. Si se trata de nuevo de una lista, se repite el proceso.

Notas

El resultado tiene la estructura de datos señal o serie de señales. Si el argumento SignalA es una serie de datos o una matriz de datos, el componente X del resultado contiene las frecuencias normalizadas de Nyquist. Si ambos conjuntos de datos tienen componentes X, estos deben ser idénticos. El número de valores de cada conjunto de datos y, en el caso de matrices de datos y series de señales, el número de columnas debe ser el mismo. Por ejemplo, puede combinar una serie de señales con una señal. En este caso, el espectro de la señal se calcula con los espectros de las columnas individuales de la serie de señales.

Disponibilidad

Opción Análisis espectral

Ejemplos

Coherence('Signal A', 'Signal B', COHERENCE_MAGNITUDE2, WIN_COS3MINSIDELOBE + WIN_NORMALIZEPOWER, 3, 0, 50, 0)

Calcula el espectro de coherencia de la 'Signal A' y la 'Signal B'. La ventana utilizada es Cos 3 Minimun Sidelobe -71 dB W=3, normalizado a la potencia. La longitud del segmento es la longitud de datos/4 y la longitud de la FFT se ajusta a la longitud del segmento. Este es un ejemplo del tutorial Análisis espectral cruzado.

Véase también

Función CrossPeriodogram

Función CrossSpectrum

Función TransferFunction

Opción Análisis espectral

Objeto de análisis Análisis espectral cruzado de Fourier

Medidas espectrales cruzadas

Funciones de ventana

Análisis espectral de Fourier

Tutorial Análisis espectral cruzado