timeseries

Crear un objeto timeseries

Descripción

Las series temporales representan la evolución en el tiempo de una población o proceso dinámicos. Se utilizan para identificar, modelar y pronosticar patrones y comportamientos de datos que se muestrean durante intervalos de tiempo discretos.

Nota

Se recomienda timetable en lugar de timeseries. Los horarios pueden almacenar datos con marca de tiempo de distintos tipos y cuentan con un amplio conjunto de funciones compatibles para el preprocesamiento, la reestructuración y el análisis.

No hay planes para eliminar el tipo de datos timeseries.

Creación

Para crear un objeto timeseries, utilice la función timeseries con argumentos de entrada que describan las muestras de datos.

Sintaxis

ts = timeseries(datavals)

ts = timeseries(datavals,timevals)

ts = timeseries(datavals,timevals,quality)

ts = timeseries(___,'Name',tsname)

ts = timeseries()

ts = timeseries(tsname)

Descripción

ts = timeseries(datavals) devuelve un objeto timeseries que contiene los datos en datavals. Asigna tiempos de muestra predeterminados a partir de cero segundos con una unidad de tiempo de un segundo.

ts = timeseries(datavals,timevals) especifica los tiempos de muestra para la serie. El objeto resultante ordena los datos por tiempo.

ts = timeseries(datavals,timevals,quality) especifica descripciones de calidad en términos de los códigos definidos por QualityInfo.Code.

ts = timeseries(___,'Name',tsname) especifica un nombre tsname para el objeto timeseries.

ts = timeseries() devuelve un objeto timeseries vacío.

ts = timeseries(tsname) crea un objeto timeseries vacío con el nombre tsname.

Argumentos de entrada

datavals — Datos de muestra

escalar | vector | arreglo multidimensional

Datos de muestra, especificados como un escalar numérico o logical, un vector o un arreglo multidimensional.

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

timevals — Tiempos de muestra

escalar | vector

Tiempos de muestra, especificados como un escalar o vector numérico o un arreglo de celdas de vectores de caracteres de fecha. Los vectores de caracteres de fecha válidos pueden tener las siguientes formas:

Formato	Ejemplo
dd-mmm-yyyy HH:MM:SS	01-Mar-2000 15:45:17
dd-mmm-yyyy	01-Mar-2000
mm/dd/yy	03/01/00
mm/dd	03/01
HH:MM:SS	15:45:17
HH:MM:SS PM	3:45:17 PM
HH:MM	15:45
HH:MM PM	3:45 PM
mmm.dd,yyyy HH:MM:SS	Mar.01,2000 15:45:17
mmm.dd,yyyy	Mar.01,2000
mm/dd/yyyy	03/01/2000

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

quality — Códigos de calidad

[] (predeterminado) | escalar | vector | arreglo multidimensional

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 correspondiente del arreglo de datos.

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

tsname — Nombre de timeseries

vector de caracteres

Nombre de timeseries, especificado como un vector de caracteres.

Propiedades

Data — Datos de muestra

escalar | vector | arreglo multidimensional

Datos de muestra, representados como un escalar numérico o logical, un vector o un arreglo multidimensional. La primera o la última dimensión de los datos debe alinearse con la orientación del vector de tiempo.

Data tiene los siguientes atributos:

Dependent

true

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

DataInfo — Información de datos

recopilación de campos

Información de datos, representada como una recopilación de los siguientes campos:

• Units: vector de caracteres que especifica unidades de datos.

• Interpolation: un objeto tsdata.interpolation que especifica el método de interpolación.

  Los campos del objeto tsdata.interpolation incluyen lo siguiente:

  • Fhandle: identificador de función para una función de interpolación definida por el usuario.

  • Name: vector de caracteres que especifica el nombre del método de interpolación. Los métodos incluyen 'linear' (predeterminado) para la interpolación lineal y 'zoh' para la retención de orden cero.

• UserData: información adicional definida por el usuario introducida como un vector de caracteres.

Events — Información del evento

arreglo de objetos tsdata.event

Información del evento, representada como un arreglo de objetos tsdata.event que contienen información sobre el evento.

Los campos del objeto tsdata.event incluyen lo siguiente:

• EventData: información adicional definida por el usuario sobre el evento.

• Name: vector de caracteres que especifica el nombre del evento.

• Time: hora a la que ocurre el evento, especificada como un número real o un vector de caracteres de fecha.

• Units: unidades de tiempo.

• StartDate: una fecha de referencia especificada como un vector de caracteres de fecha. StartDate está vacío cuando el vector de tiempo es numérico.

IsTimeFirst — Alineación del vector de tiempo

true | false

Alineación del vector de tiempo, representada como una de las siguientes opciones:

• true: la primera dimensión del arreglo de datos está alineada con el vector de tiempo. Por ejemplo, ts = timeseries(rand(3,3),1:3);

• false: la última dimensión del arreglo de datos está alineada con el vector de tiempo. Por ejemplo, ts = timeseries(rand(3,4,5),1:5);

IsTimeFirst tiene los siguientes atributos:

Dependent	true
SetAccess	'protected'

Length — Longitud del vector de tiempo

escalar

Longitud del vector de tiempo, representada como un escalar.

Length tiene los siguientes atributos:

Dependent	true
SetAccess	'protected'

Name — Nombre de timeseries

vector de caracteres

Nombre de timeseries, representado como un vector de caracteres.

Quality — Códigos de calidad

[] (predeterminado) | escalar | vector | arreglo multidimensional

Códigos de calidad, representados 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 correspondiente del arreglo de datos.

Quality tiene los siguientes atributos:

Dependent

true

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

QualityInfo — Información de calidad

recopilación de campos

Información de calidad para describir los códigos Quality, representada como una recopilación de los siguientes campos:

• Code: vector entero que contiene los valores de -128 a 127 que definen los códigos de calidad. Puede asignar uno de estos valores enteros a cada valor Data utilizando la propiedad Quality.

• Description: arreglo de celdas de vectores de caracteres, donde cada elemento proporciona una descripción legible de la calidad asociada Code.

• UserData: información adicional definida por el usuario.

Las longitudes de Code y Description deben coincidir.

Time — Valores de tiempo

vector

Valores de tiempo, representados como un vector.

Cuando TimeInfo.StartDate está vacío, los valores se miden en relación con 0. Cuando se define TimeInfo.StartDate, los valores representan vectores de caracteres de fecha medidos en relación con StartDate.

La longitud de Time debe ser la misma que la primera o la última dimensión de Data.

Time tiene los siguientes atributos:

Dependent

true

TimeInfo — Información del tiempo

recopilación de campos

Información del tiempo, representada como una recopilación de los siguientes campos que describen el vector de tiempo:

• Units: unidades de tiempo con valor 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds' o 'nanoseconds'.

• Start: hora de inicio.

• End: hora de finalización (solo de lectura).

• Increment: intervalo entre valores de tiempo subsiguientes (NaN cuando los tiempos no están muestreados de manera uniforme).

• Length: longitud del vector de tiempo (solo de lectura).

• Format: vector de caracteres que define la visualización de la fecha (consulte datestr).

• StartDate: vector de caracteres de fecha que define la fecha de referencia (consulte setabstime). Especifique StartDate utilizando el mismo formato que Format.

• UserData: información adicional definida por el usuario.

Para acceder al valor de un campo, utilice el formato ts.TimeInfo.field para un objeto timeseries ts.

TreatNaNasMissing — Indicador de valores faltantes

true (predeterminado) | false

Indicador de valores faltantes, representado como una de las siguientes opciones:

• true: trata todos los valores NaN como datos faltantes, excepto las funciones de estadísticas descriptivas.

• false: incluye valores NaN en las funciones estadísticas descriptivas y propaga NaN al resultado.

UserData — Datos de usuario

[] (predeterminado)

Datos de usuario, representados como cualquier dato adicional para añadir al objeto timeseries.

Funciones del objeto

Modificar y representar gráficamente

addevent	Add event to timeseries
addsample	Add data sample to timeseries object
append	Concatenate timeseries objects in time
delevent	Remove event from timeseries
delsample	Remove sample from timeseries object
detrend	Subtract mean or best-fit line from timeseries object
filter	Modify frequency content of timeseries objects
idealfilter	timeseries ideal filter
plot	Representar gráficamente timeseries
resample	Resample time vector in timeseries or tscollection
setabstime	Set timeseries or tscollection times as date character vectors
setinterpmethod	Set default interpolation method for timeseries object
setuniformtime	Modify uniform timeseries time vector
synchronize	Synchronize and resample two timeseries objects using common time vector

Consultar

getabstime	Convert timeseries or tscollection time vector to cell array
getdatasamples	Acceder a muestras de datos timeseries
getdatasamplesize	timeseries data sample size
getinterpmethod	timeseries interpolation method
getqualitydesc	timeseries data quality
getsamples	Subset of timeseries
getsampleusingtime	Subset of timeseries or tscollection data
gettsafteratevent	Create timeseries at or after event
gettsafterevent	Create timeseries after event
gettsatevent	Create timeseries at event
gettsbeforeatevent	Create timeseries at or before event
gettsbeforeevent	Create timeseries before event
gettsbetweenevents	Create timeseries between events

Estadística descriptiva

iqr	Interquartile range of timeseries data
max	Maximum of timeseries data
mean	Mean of timeseries data
median	Median of timeseries data
min	Minimum of timeseries data
std	Standard deviation of timeseries data
sum	Sum of timeseries data
var	Variance of timeseries data

Ejemplos

Crear timeseries

Cree un objeto timeseries con cinco muestras de datos escalares, especificando un nombre para timeseries. A continuación, se muestran los tiempos de muestra y los valores de los datos.

ts1 = timeseries(([5 10 15 20 25])',"Name","MyTimeSeries")

  timeseries

  Common Properties:
            Name: 'MyTimeSeries'
            Time: [5x1 double]
        TimeInfo: [1x1 tsdata.timemetadata]
            Data: [5x1 double]
        DataInfo: [1x1 tsdata.datametadata]

  More properties, Methods

ts1.Time

ans = 5×1

     0
     1
     2
     3
     4

ts1.Data

ans = 5×1

     5
    10
    15
    20
    25

Cree un objeto timeseries con cinco muestras de datos, donde cada muestra es un vector columna de longitud 2. Por lo tanto, hay dos tiempos de muestra, a partir de cero segundos.

ts2 = timeseries(rand(2,5))

  timeseries

  Common Properties:
            Name: 'unnamed'
            Time: [2x1 double]
        TimeInfo: [1x1 tsdata.timemetadata]
            Data: [2x5 double]
        DataInfo: [1x1 tsdata.datametadata]

  More properties, Methods

ts2.Time

ans = 2×1

     0
     1

Cree un objeto timeseries con cinco muestras de datos que se muestrearon en intervalos de 10 segundos.

ts3 = timeseries((1:5)',[0 10 20 30 40])

  timeseries

  Common Properties:
            Name: 'unnamed'
            Time: [5x1 double]
        TimeInfo: [1x1 tsdata.timemetadata]
            Data: [5x1 double]
        DataInfo: [1x1 tsdata.datametadata]

  More properties, Methods

ts3.Time

ans = 5×1

     0
    10
    20
    30
    40

ts3.TimeInfo

  tsdata.timemetadata
  Namespace: tsdata

  Uniform Time:
    Length       5
    Increment    10 seconds

  Time Range:
    Start        0 seconds
    End          40 seconds

  Common Properties:
          Units: 'seconds'
         Format: ''
      StartDate: ''

  More properties, Methods

Historial de versiones

Introducido antes de R2006a

R2025a: El editor de variables muestra directamente las propiedades de los objetos timeseries

Cuando se abre un objeto timeseries en el editor de variables, ahora se muestran directamente los campos Propiedad, Valor, Tamaño y Clase, en lugar de mostrar un editor especializado para los datos timeseries. Aun así, con esta visualización actualizada puede acceder y ver todas las propiedades del objeto timeseries y editar algunos de sus valores de propiedad.

Consulte también

timetable | tscollection | tsdata.event | timeseries2timetable

Temas

• Objetos y colecciones de series temporales