Exponenta Banner
exponenta event banner

timeseries

Создание timeseries объект

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

Описание

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

Создание

Как создать 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

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

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

  • Interpolation - A tsdata.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', 'days', 'hours', 'minutes', 'seconds', 'milliseconds', '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 объекты
idealfiltertimeseries идеальный фильтр
plotГрафик timeseries
resampleПовторная выборка timeseries временной вектор
setЗадайте timeseries свойства
setabstimeЗадайте timeseries время как векторы символов даты
setinterpmethodУстановите метод интерполяции по умолчанию для timeseries объект
setuniformtimeИзменение равномерных timeseries временной вектор
synchronizeСинхронизация и повторная выборка двух timeseries объекты, использующие общий временной вектор
getЗапрос- timeseries свойства
getabstimeПреобразование timeseries временной вектор в массив ячеек
getdatasamplesДоступ к timeseries выборки данных
getdatasamplesizetimeseries размер выборки данных
getinterpmethodtimeseries метод интерполяции
getqualitydesctimeseries качество данных
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 данные

Примеры

свернуть все

Открыть Live Script

Создайте 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

Документация MATLAB

Поддержка