matplotlib.pyplot.especgrama

matplotlib.pyplot. specgram ( x , NFFT = Ninguno , Fs = Ninguno , Fc = Ninguno , detrend = Ninguno , ventana = Ninguno , noverlap = Ninguno , cmap = Ninguno , xextent = Ninguno , pad_to = Ninguno , lados = Ninguno , scale_by_freq = Ninguno , mode = Ninguna, escala = Ninguno , vmin = Ninguno , vmax = Ninguno , * , datos = Ninguno , ** kwargs )

Trazar un espectrograma.

Calcule y trace un espectrograma de datos en x . Los datos se dividen en segmentos de longitud NFFT y se calcula el espectro de cada sección. La función de ventana window se aplica a cada segmento y la cantidad de superposición de cada segmento se especifica con noverlap . El espectrograma se traza como un mapa de colores (usando imshow).

Parámetros :

matriz o secuencia x 1-D

Matriz o secuencia que contiene los datos.

Fs flotante, por defecto: 2

La frecuencia de muestreo (muestras por unidad de tiempo). Se utiliza para calcular las frecuencias de Fourier, freqs , en ciclos por unidad de tiempo.

ventana invocable o ndarray, por defecto:window_hanning

Una función o un vector de longitud NFFT . Para crear vectores de ventana, consulte window_hanning, window_none, numpy.blackman, numpy.hamming, numpy.bartlett, scipy.signal, scipy.signal.get_window, etc. Si se pasa una función como argumento, debe tomar un segmento de datos como argumento y devolver la versión de ventana del segmento.

lados {'predeterminado', 'de un solo lado', 'de dos lados'}, opcional

A qué lados del espectro volver. 'predeterminado' es unilateral para datos reales y bilateral para datos complejos. 'oneside' fuerza el regreso de un espectro de un solo lado, mientras que 'twosided' fuerza dos lados.

pad_to int, opcional

El número de puntos a los que se rellena el segmento de datos al realizar la FFT. Esto puede ser diferente de NFFT , que especifica la cantidad de puntos de datos utilizados. Si bien no aumenta la resolución real del espectro (la distancia mínima entre los picos resolubles), esto puede brindar más puntos en el gráfico, lo que permite obtener más detalles. Esto corresponde al parámetro nfft en la llamada a . El valor predeterminado es Ninguno, lo que establece pad_to igual a NFFT

NFFT int, predeterminado: 256

El número de puntos de datos utilizados en cada bloque para la FFT. Una potencia 2 es más eficiente. Esto NO debe usarse para obtener relleno cero, o la escala del resultado será incorrecta; use pad_to para esto en su lugar.

detrend {'ninguno', 'media', 'lineal'} o invocable, predeterminado: 'ninguno'

La función aplicada a cada segmento antes de fft-ing, diseñada para eliminar la tendencia media o lineal. A diferencia de MATLAB, donde el parámetro de tendencia es un vector, en Matplotlib es una función. El mlab módulo define detrend_none, detrend_meany detrend_linear, pero también puede usar una función personalizada. También puede usar una cadena para elegir una de las funciones: llamadas 'ninguna' detrend_none. llamadas 'malas' detrend_mean. llamadas 'lineales' detrend_linear.

scale_by_freq bool, por defecto: Verdadero

Si los valores de densidad resultantes deben escalarse según la frecuencia de escalado, que da la densidad en unidades de 1/Hz. Esto permite la integración sobre los valores de frecuencia devueltos. El valor predeterminado es True para la compatibilidad con MATLAB.

modo {'predeterminado', 'psd', 'magnitud', 'ángulo', 'fase'}

Qué tipo de espectro utilizar. El valor predeterminado es 'psd', que toma la densidad espectral de potencia. 'magnitud' devuelve el espectro de magnitud. 'angle' devuelve el espectro de fase sin desenvolver. 'fase' devuelve el espectro de fase con desenvolvimiento.

noverlap int, por defecto: 128

El número de puntos de superposición entre bloques.

escala {'predeterminada', 'lineal', 'dB'}

La escala de los valores en la especificación . 'lineal' no es escala. 'dB' devuelve los valores en la escala de dB. Cuando el modo es 'psd', esta es la potencia en dB (10 * log10). De lo contrario, esta es la amplitud de dB (20 * log10). 'predeterminado' es 'dB' si el modo es 'psd' o 'magnitud' y 'lineal' en caso contrario. Debe ser 'lineal' si el modo es 'ángulo' o 'fase'.

Fc int, por defecto: 0

La frecuencia central de x , que compensa las extensiones x de la gráfica para reflejar el rango de frecuencia utilizado cuando se adquiere una señal y luego se filtra y se reduce a banda base.

cmap Colormap, predeterminado: rcParams["image.cmap"](predeterminado: 'viridis')

xextent Ninguno o (xmin, xmax)

La extensión de la imagen a lo largo del eje x. El valor predeterminado establece xmin en el borde izquierdo del primer contenedor ( columna de espectro ) y xmax en el borde derecho del último contenedor. Tenga en cuenta que para noverlap>0 el ancho de los bins es menor que el de los segmentos.

objeto indexable de datos , opcional

Si se proporcionan, los siguientes parámetros también aceptan una cadena s, que se interpreta como data[s](a menos que esto genere una excepción):

X

**kwargs

Se pasan argumentos de palabras clave adicionales a imshow los que se crea la imagen del espectrograma. El argumento de palabra clave de origen no es compatible.

Devoluciones :

matriz 2D de espectro

Las columnas son los periodogramas de segmentos sucesivos.

matriz 1-D de frecuencias

Las frecuencias correspondientes a las filas en el espectro .

matriz t 1-D

Los tiempos correspondientes a los puntos medios de los segmentos (es decir, las columnas en el espectro ).

soyAxesImage

La imagen creada por imshow que contiene el espectrograma.

Ver también

psd

Difiere en la superposición predeterminada; al devolver la media de los periodogramas del segmento; en tiempos que no vuelven; y en la generación de un gráfico de líneas en lugar de un mapa de colores.

magnitude_spectrum

Un solo espectro, similar a tener un solo segmento cuando el modo es 'magnitud'. Traza una línea en lugar de un mapa de colores.

angle_spectrum

Un solo espectro, similar a tener un solo segmento cuando el modo es 'ángulo'. Traza una línea en lugar de un mapa de colores.

phase_spectrum

Un solo espectro, similar a tener un solo segmento cuando el modo es 'fase'. Traza una línea en lugar de un mapa de colores.

notas

Los parámetros detrend y scale_by_freq solo se aplican cuando el modo se establece en 'psd'.