timeseries

Создайте timeseries объект

Описание

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

Создание

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

Описание

пример

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

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

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

  • Interpolationtsdata.interpolation объект, который задает метод интерполяции.

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

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

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

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

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

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

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

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

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

  • Units Единицы измерения времени.

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

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

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

  • false — Последняя размерность массива данных выравнивается с временным вектором. Например, 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 свойство.

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

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

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

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

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

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

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

Dependenttrue

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

  • Units — Единицы измерения времени со значением 'weeks'дничасыминутысекундымиллисекунды, 'microseconds', или 'nanoseconds'.

  • Start Время начала.

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

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

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

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

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

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

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

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

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

  • false — Включайте 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