array2timetable

Преобразуйте гомогенный массив в расписание

Синтаксис

TT = array2timetable(X,'RowTimes',rowTimes)
TT = array2timetable(X,'SampleRate',Fs)
TT = array2timetable(X,'TimeStep',dt)
TT = array2timetable(___,'StartTime',t0)
TT = array2timetable(___,'VariableNames',varNames)

Описание

пример

TT = array2timetable(X,'RowTimes',rowTimes) преобразовывает X и rowTimes к расписанию. X является M-by-N массив, и rowTimes является M-by-1 вектор значений длительности или datetime. Каждый столбец X становится переменной TT. Временные стоимости в rowTimes маркируют строки расписания. TT является M-by-N расписание.

Для получения дополнительной информации о создании и использовании расписаний, см. Расписания.

пример

TT = array2timetable(X,'SampleRate',Fs) использует частоту дискретизации Fs, чтобы вычислить расположенные с равными интервалами времена строки. Fs является положительным числовым скаляром, который задает количество выборок в секунду (Гц). Первый раз строки является нулевыми секундами.

пример

TT = array2timetable(X,'TimeStep',dt) использует временной шаг dt, чтобы вычислить расположенные с равными интервалами времена строки. dt является длительностью или календарным значением длительности, которое задает отрезок времени между временами строки подряд. Первый раз строки является нулевыми секундами.

пример

TT = array2timetable(___,'StartTime',t0) задает время начала t0, вместо нулевых секунд, как первый раз строки. Можно использовать этот синтаксис, когда вы создаете обычное расписание с помощью или 'SampleRate' или аргументов в виде пар "имя-значение" 'TimeStep' от любого из предыдущих двух синтаксисов.

пример

TT = array2timetable(___,'VariableNames',varNames) задает имена переменных в выходном расписании. Можно использовать этот синтаксис с любым из входных параметров предыдущих синтаксисов.

Примеры

свернуть все

Преобразуйте массив в расписание. Добавьте вектор длительности как времена строки.

X = rand(5,3);
Time = seconds(1:5);
TT = array2timetable(X,'RowTimes',Time)
TT=5×3 timetable
    Time       X1         X2         X3   
    _____    _______    _______    _______

    1 sec    0.81472    0.09754    0.15761
    2 sec    0.90579     0.2785    0.97059
    3 sec    0.12699    0.54688    0.95717
    4 sec    0.91338    0.95751    0.48538
    5 sec    0.63236    0.96489    0.80028

Возвратите размер расписания. TT содержит пять строк и три переменные. Набор времен строки является свойством таблицы. Времена строки не содержатся в табличной переменной.

size(TT)
ans = 1×2

     5     3

Задайте частоту дискретизации 500 Гц и преобразуйте массив в расписание.

X = rand(5,3);
TT = array2timetable(X,'SampleRate',500)
TT=5×3 timetable
      Time         X1         X2         X3   
    _________    _______    _______    _______

    0 sec        0.81472    0.09754    0.15761
    0.002 sec    0.90579     0.2785    0.97059
    0.004 sec    0.12699    0.54688    0.95717
    0.006 sec    0.91338    0.95751    0.48538
    0.008 sec    0.63236    0.96489    0.80028

Задайте временной шаг 0,5 секунд и преобразуйте массив в расписание.

X = rand(5,3);
TT = array2timetable(X,'TimeStep',seconds(0.5))
TT=5×3 timetable
     Time        X1         X2         X3   
    _______    _______    _______    _______

    0 sec      0.81472    0.09754    0.15761
    0.5 sec    0.90579     0.2785    0.97059
    1 sec      0.12699    0.54688    0.95717
    1.5 sec    0.91338    0.95751    0.48538
    2 sec      0.63236    0.96489    0.80028

Задайте временной шаг 15 секунд и время начала 5 минут.

X = rand(5,3);
TT = array2timetable(X,'TimeStep',seconds(15),'StartTime',minutes(5))
TT=5×3 timetable
      Time        X1         X2         X3   
    ________    _______    _______    _______

    5 min       0.81472    0.09754    0.15761
    5.25 min    0.90579     0.2785    0.97059
    5.5 min     0.12699    0.54688    0.95717
    5.75 min    0.91338    0.95751    0.48538
    6 min       0.63236    0.96489    0.80028

Преобразуйте массив в расписание. Задайте времена строки как вектор datetime. Задайте имена для переменных расписания.

X = randi([70 90],5,3);
Time = datetime(2016,7,1:5);
varNames = {'Temp1','Temp2','Temp3'};
TT = array2timetable(X,'RowTimes',Time,'VariableNames',varNames)
TT=5×3 timetable
       Time        Temp1    Temp2    Temp3
    ___________    _____    _____    _____

    01-Jul-2016     87       72       73  
    02-Jul-2016     89       75       90  
    03-Jul-2016     72       81       90  
    04-Jul-2016     89       90       80  
    05-Jul-2016     83       90       86  

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

свернуть все

Введите матрицу.

Типы данных: удвойтесь | единственный | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | логический | char | строка | категориальный | datetime | длительность | calendarDuration
Поддержка комплексного числа: Да

Времена, сопоставленные со строками расписания, заданного как вектор datetime или вектор длительности. Каждый раз маркирует строку в выходном расписании. Временные стоимости в rowTimes не должны быть уникальными, не отсортированы, или регулярными.

Частота дискретизации, заданная в виде положительного числа. Fs задает количество выборок в секунду (Гц).

Временной шаг, заданный как скаляр datetime или скаляр длительности.

Типы данных: datetime | длительность | calendarDuration

Время начала, заданное как скаляр datetime или скаляр длительности.

  • Если t0 является значением datetime, то времена строки TT являются значениями datetime.

  • Если t0 является длительностью, то времена строки являются длительностью.

Если временной шаг, dt является календарным значением длительности, то t0 должен быть значением datetime.

Типы данных: datetime | длительность

Имена переменных в выходном расписании, заданном как массив ячеек из символьных векторов или массив строк. Количество имен в varNames должно равняться количеству переменных.

Выходные аргументы

свернуть все

Выведите расписание. Расписание может сохранить метаданные, такие как описания, переменные модули, имена переменных, и времена строки. Для получения дополнительной информации смотрите раздел Properties timetable.

Вопросы совместимости

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

Не рекомендуемый запуск в R2018b

Расширенные возможности

Введенный в R2017b

Была ли эта тема полезной?