временные ряды

Описание

Временные ряды представляют эволюцию времени динамической генеральной совокупности или процесс. Они используются, чтобы идентифицировать, смоделировать, и предсказать шаблоны и поведения в данных, которые выбираются на интервалах дискретного времени.

Создание

Чтобы создать объект timeseries, используйте функцию timeseries с входными параметрами, которые описывают выборки данных.

Синтаксис

ts = timeseries(datavals)
ts = timeseries(datavals,timevals)
ts = timeseries(datavals,timevals,quality)
ts = timeseries(___,'Name',tsname)
ts = timeseries()
ts = timeseries(tsname)

Описание

пример

ts = timeseries(datavals) возвращает объект timeseries, содержащий данные в datavals.

ts = timeseries(datavals,timevals) возвращает объект timeseries, содержащий данные в datavals, соответствующем временам в векторном timevals.

ts = timeseries(datavals,timevals,quality) задает качественные описания с точки зрения кодов, заданных QualityInfo.Code.

ts = timeseries(___,'Name',tsname) задает имя tsname для объекта timeseries.

ts = timeseries() возвращает пустой объект timeseries.

ts = timeseries(tsname) создает пустой объект timeseries с именем tsname.

Входные параметры

развернуть все

Выборочные данные, заданные как числовой скаляр или скаляр logical, вектор или многомерный массив.

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Шаги расчета, заданные в виде числа или вектора или массива ячеек векторов символов даты. Допустимые векторы символов даты могут иметь следующие формы:

ФорматПример
dd-mmm-yyyy HH:MM:SS01-Mar-2000 15:45:17
dd-mmm-yyyy01-Mar-2000
mm/dd/yy03/01/00
mm/dd03/01
HH:MM:SS15:45:17
HH:MM:SS PM3:45:17 PM
HH:MM15:45
HH:MM PM3:45 PM
mmm.dd,yyyy HH:MM:SSMar.01,2000 15:45:17
mmm.dd,yyyyMar.01,2000
mm/dd/yyyy03/01/2000

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | cell

Качественные коды, заданные как [] или скаляр, вектор или многомерный массив целых чисел в пределах от-128 к 127.

  • Когда качественное кодовое обозначение является вектором, оно должно иметь ту же длину как временной вектор. Каждый элемент применяется к соответствующей выборке данных.

  • Когда качественное кодовое обозначение является массивом, оно должно иметь тот же размер как массив данных. Каждый элемент применяется к соответствующему элементу массива данных.

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Имя timeseries, заданное как вектор символов.

Свойства

развернуть все

Выборочные данные, представленные как числовой скаляр или скаляр logical, вектор или многомерный массив. Или первое или последняя размерность данных должны выровняться с ориентацией временного вектора.

Data имеет следующие атрибуты:

Dependenttrue

Типы данных: double | single | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical

Информация о данных, представленная как набор следующих полей:

  • Модули Вектор символов, задающий модули данных.

  • Объект Interpolation — A tsdata.interpolation, который задает метод интерполяции.

    Поля объекта tsdata.interpolation включают следующее:

    • Fhandle — Указатель на функцию к пользовательской функции интерполяции.

    • Имя Вектор символов, задающий имя метода интерполяции. Методы включают 'linear' (значение по умолчанию) для линейной интерполяции, и 'zoh' для нулевого порядка содержат.

  • UserData Дополнительная пользовательская информация, вводимая как вектор символов.

Информация о событии, представленная как массив объектов tsdata.event, содержащих информацию о событии.

Поля объекта tsdata.event включают следующее:

  • Данные о событиях Дополнительная пользовательская информация о событии.

  • Имя Вектор символов, задающий имя события

  • Время Время, в течение которого событие имеет место, заданный как вещественное число или вектор символов даты.

  • Модули Единицы измерения времени.

  • StartDate — Ссылочная дата, заданная как вектор символов даты. StartDate пуст, когда временной вектор является числовым.

Выравнивание временного вектора, представленное как одна из следующих опций:

  • tRUE Первая размерность массива данных выравнивается с временным вектором. Например, ts = timeseries(rand(3,3),1:3);

  • ложь Последняя размерность массива данных выравнивается с временным вектором. Например, ts = timeseries(rand(3,4,5),1:5);

IsTimeFirst имеет следующие атрибуты:

Dependenttrue
SetAccess'protected'

Длина временного вектора, представленная как скаляр.

Length имеет следующие атрибуты:

Dependenttrue
SetAccess'protected'

Имя timeseries, представленное как вектор символов.

Качественные коды, представленные как [] или скаляр, вектор или многомерный массив целых чисел в пределах от-128 к 127.

  • Когда качественное кодовое обозначение является вектором, оно должно иметь ту же длину как временной вектор. Каждый элемент применяется к соответствующей выборке данных.

  • Когда качественное кодовое обозначение является массивом, оно должно иметь тот же размер как массив данных. Каждый элемент применяется к соответствующему элементу массива данных.

Quality имеет следующие атрибуты:

Dependenttrue

Типы данных: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64

Информация о качестве, чтобы описать коды Quality, представленные как набор следующих полей:

  • Code — Целочисленный вектор, содержащий значения -128 к 127, которые задают качественные коды. Можно присвоить одно из этих целочисленных значений к каждому значению Data при помощи свойства Quality.

  • Описание Массив ячеек из символьных векторов, где каждый элемент предоставляет читаемое описание связанного качества Code.

  • UserData Дополнительная пользовательская информация.

Длины Code и Description должны соответствовать.

Временные стоимости, представленные как вектор.

Когда TimeInfo.StartDate пуст, значения измеряются относительно 0. Когда TimeInfo.StartDate задан, значения представляют векторы символов даты, измеренные относительно StartDate.

Длина Time должна совпасть с первым или последней размерностью Data.

Time имеет следующие атрибуты:

Dependenttrue

Информация времени, представленная как набор следующих полей, описывающих временной вектор:

  • Модули Единицы измерения времени со значением 'weeks', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', 'microseconds' или 'nanoseconds'.

  • Запуск Время начала.

  • Конец Время окончания (только для чтения).

  • Increment — Интервал между последующими временными стоимостями (NaN, когда времена однородно не выбираются).

  • Длина Вектор отрезка времени (только для чтения).

  • Формат Вектор символов, задающий отображение даты (см. datestr).

  • StartDate — Вектор символов даты, задающий ссылочную дату (см. setabstime).

  • UserData Дополнительная пользовательская информация.

Чтобы получить доступ к значению поля, используйте форму ts.TimeInfo.field для объекта timeseries ts.

Индикатор отсутствующего значения, представленный как одна из следующих опций:

  • tRUE Обработайте все значения NaN как недостающие данные за исключением функций описательной статистики.

  • ложь Включайте значения NaN в функции описательной статистики, распространяя NaN к результату.

Пользовательские данные, представленные как любые дополнительные данные, чтобы добавить к объекту timeseries.

Функции объекта

развернуть все

addeventДобавьте событие в timeseries
addsampleДобавьте выборку данных в объект timeseries
appendКонкатенация timeseries возражает вовремя
deleventУдалите событие из timeseries
delsampleУдалите выборку из объекта timeseries
detrendВычтите среднее значение или наилучшую эмпирическую кривую от объекта timeseries
filterИзмените содержимое частоты объектов timeseries
idealfilterфильтр идеала timeseries
plotПостройте timeseries
resampleПередискретизируйте временной вектор timeseries
setУстановите свойства timeseries
setabstimeУстановите времена timeseries как векторы символов даты
setinterpmethodУстановите метод интерполяции по умолчанию для объекта timeseries
setuniformtimeИзмените универсальный временной вектор timeseries
synchronizeСинхронизируйте и передискретизируйте два объекта timeseries с помощью общего временного вектора
getЗапросите свойства timeseries
getabstimeПреобразуйте временной вектор timeseries в массив ячеек
getdatasamplesДоступ к выборкам данных о timeseries
getdatasamplesizeобъем выборки данных о timeseries
getinterpmethodметод интерполяции timeseries
getqualitydescкачество данных timeseries
getsamplesПодмножество timeseries
getsampleusingtimeПодмножество данных о timeseries
gettsafterateventСоздайте timeseries в или после события
gettsaftereventСоздайте timeseries после события
gettsateventСоздайте timeseries в событии
gettsbeforeateventСоздайте timeseries в или перед событием
gettsbeforeeventСоздайте timeseries перед событием
gettsbetweeneventsСоздайте timeseries между событиями
iqrМежквартильный размах данных о timeseries
maxМаксимум данных о timeseries
meanСреднее значение данных о timeseries
medianМедиана данных о timeseries
minМинимум данных о timeseries
stdСтандартное отклонение данных о timeseries
sumСумма данных о timeseries
varОтклонение данных о timeseries

Примеры

свернуть все

Создайте объект timeseries с 5 скалярными выборками данных, задав имя для timeseries.

ts1 = timeseries((1:5)','Name','MyTimeSeries');

Создайте timeseries с 5 выборками данных, где каждая выборка является вектор-столбцом длины 2.

ts2 = timeseries(rand(2,5));

Создайте timeseries с 5 выборками данных, которые были выбраны в интервалах 10 единиц измерения времени.

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

Представлено до R2006a