Contenido principal

resample

Volver a muestrear un vector de tiempo en timeseries o tscollection

Descripción

Nota

La función resample se aplica a los objetos creados utilizando timeseries o tscollection. Para obtener información sobre cómo volver a muestrear una función timetable, que se recomienda en lugar de timeseries y tscollection, consulte retime.

tsout = resample(tsin,timevec) vuelve a muestrear una serie temporal o recopilación usando un vector de tiempo nuevo. La función resample usa el método de interpolación asociado a cada serie temporal.

ejemplo

tsout = resample(tsin,timevec,interpmethod) vuelve a muestrear usando un método de interpolación especificado. interpmethod puede ser 'linear' para la interpolación lineal o 'zoh' para la retención de orden cero.

ejemplo

tsout = resample(tsin,timevec,interpmethod,code) aplica los códigos de calidad de code a todas las muestras.

Ejemplos

contraer todo

Cree un objeto timeseries y vuelva a muestrearlo usando interpolación lineal según los tiempos de timevec. Compare los datos originales con los datos que se han vuelto a muestrear.

tsin = timeseries([1.1 2.9 3.7 4.0 3.0]',1:5);
tsout = resample(tsin,[1 1.5 3.5 4.5 4.9]);
tsindata = tsin.Data
tsindata = 5×1

    1.1000
    2.9000
    3.7000
    4.0000
    3.0000

tsoutdata = tsout.Data
tsoutdata = 5×1

    1.1000
    2.0000
    3.8500
    3.5000
    3.1000

Vuelva a muestrear un objeto tscollection compuesto por dos objetos timeseries.

Cree un objeto tscollection a partir de los dos objetos timeseries.

ts1=timeseries([1.1 2.9 3.7 4.0 3.0]',1:5,'Name','Acceleration');
ts2=timeseries([3.2 4.2 6.2 8.5 1.1]',1:5,'Name','Speed');
tscin = tscollection({ts1,ts2})
Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              5 seconds

Member Time Series Objects:

      Acceleration
      Speed

Vuelva a muestrear los datos de tscin según un vector de tiempo nuevo usando la interpolación de retención de orden cero.

tsout = resample(tscin,[1 1.5 3.5 4.5 4.9],'zoh')
Time Series Collection Object: unnamed

Time vector characteristics

      Start time            1 seconds
      End time              4.900000e+00 seconds

Member Time Series Objects:

      Acceleration
      Speed

Argumentos de entrada

contraer todo

Series temporales de entrada, especificadas como un objeto timeseries o tscollection.

Vector de tiempo nuevo, especificado como un vector de tiempos para volver a muestrear.

Cuando el vector de tiempo original contiene fechas y horas, pero timevec es numérico, resample define timevec en relación con la propiedad tsin.TimeInfo.StartDate usando las unidades existentes.

Tipos de datos: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Método de interpolación, especificado como una de las siguientes opciones:

  • 'linear': interpolación lineal.

  • 'zoh': retención de orden cero.

Códigos de calidad, especificados como [] o un escalar, un vector o un arreglo multidimensional de números enteros entre -128 y 127.

  • Cuando el valor del código de calidad es un vector, debe tener la misma longitud que el vector de tiempo. Cada elemento se aplica a la muestra de datos correspondiente.

  • Cuando el valor del código de calidad es un arreglo, debe tener el mismo tamaño que el arreglo de datos. Cada elemento se aplica al elemento de datos correspondiente del arreglo de datos.

Tipos de datos: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Historial de versiones

Introducido antes de R2006a