Имена размерности, заданные как двухэлементный массив ячеек из символьных векторов или двухэлементный массив строк.

Можно получить доступ к данным о расписании с помощью двух имен размерности. Если вы используете точечный синтаксис и первое имя размерности, то можно получить доступ ко временам строки как к вектору. Если вы используете точечный синтаксис и имя второго измерения, то данные из всех переменных конкатенированы вместе в одном массиве, как будто вы индексировали в расписание с помощью синтаксиса {:,:}.

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

Пример

Создайте расписание и отобразите его имена размерности. Можно получить доступ ко временам строки и данным с помощью имен размерности с точечным синтаксисом.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3]);
TT.Properties.DimensionNames

ans = 1x2 cell array
    {'Time'}    {'Variables'}

Доступ ко временам строки с помощью первого имени размерности.

TT.Time

ans = 3x1 datetime array
   18-Dec-2015
   19-Dec-2015
   20-Dec-2015

Доступ к данным с помощью имени второго измерения. Этот синтаксис эквивалентен TT{:,:,}.

TT.Variables

ans = 3×3

   37.3000   30.1000   13.4000
   39.1000   30.0300    6.5000
   42.3000   29.9000    7.3000

Измените имена его размерностей с помощью свойства Properties.DimensionNames. Поменяв имена размерности, можно получить доступ ко временам строки и данным с помощью синтаксисов TT.Date и TT.WeatherData соответственно.

TT.Properties.DimensionNames = {'Date','WeatherData'};
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Date'  'WeatherData'}
           VariableNames: {'Var1'  'Var2'  'Var3'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: 1d
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

Описание расписания, заданное как вектор символов или скаляр строки. Это описание видимо при использовании функции summary.

Если вы задаете это свойство с помощью скаляра строки, то оно преобразовано и сохранено как вектор символов.

Пример

Создайте расписание. Измените имена переменных и описание расписания. Отобразите сводные данные результата.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3]);
TT.Properties.VariableNames = {'Temp','Pressure','WindSpeed'};
TT.Properties.Description = 'Weather Data from December 2015';
summary(TT)

Description:  Weather Data from December 2015

RowTimes:

    Time: 3x1 datetime
        Values:
            Min           18-Dec-2015 
            Median        19-Dec-2015 
            Max           20-Dec-2015 
            TimeStep      24:00:00    

Variables:

    Temp: 3x1 double

        Values:

            Min        37.3 
            Median     39.1 
            Max        42.3 

    Pressure: 3x1 double

        Values:

            Min          29.9   
            Median      30.03   
            Max          30.1   

    WindSpeed: 3x1 double

        Values:

            Min           6.5    
            Median        7.3    
            Max          13.4    

Дополнительная информация расписания, указанная как массив. Можно присоединить данные любого вида к расписанию с помощью этого свойства.

Пример

Создайте расписание. Измените имена переменных. Присоедините анонимную функцию как часть пользовательских данных, которые сопоставлены с расписанием.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3]);
TT.Properties.VariableNames = {'Temp','Pressure','WindSpeed'};
Fahrenheit2Celsius = @(x) (5.0/9.0).*(x - 32);
TT.Properties.UserData = Fahrenheit2Celsius;
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: @(x)(5.0/9.0).*(x-32)
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temp'  'Pressure'  'WindSpeed'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: 1d
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

Времена строки, заданные как вектор datetime или вектор длительности. Должно быть время строки для каждой строки расписания. Однако расписание может иметь времена строки, которые являются копиями, не в порядке, или значениями NaN или NaT.

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

Другой способ получить доступ ко временам строки состоит в том, чтобы использовать точечный синтаксис и имя первой размерности таблицы.

Пример

Создайте расписание. Затем замените его времена строки с помощью свойства Properties.RowTimes.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3])

TT=3×4 timetable
       Time        Var1    Var2     Var3
    ___________    ____    _____    ____

    18-Dec-2015    37.3     30.1    13.4
    19-Dec-2015    39.1    30.03     6.5
    20-Dec-2015    42.3     29.9     7.3

Dates = datetime(2017,1,1:3);
TT.Properties.RowTimes = Dates

TT=3×4 timetable
       Time        Var1    Var2     Var3
    ___________    ____    _____    ____

    01-Jan-2017    37.3     30.1    13.4
    02-Jan-2017    39.1    30.03     6.5
    03-Jan-2017    42.3     29.9     7.3

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

TT.Properties.DimensionNames

ans = 1x2 cell array
    {'Time'}    {'Variables'}

TT.Time

ans = 3x1 datetime array
   01-Jan-2017
   02-Jan-2017
   03-Jan-2017

Время начала времен строки, заданных как скаляр datetime или скаляр длительности. Время начала равно времени строки для первой строки расписания и имеет совпадающий тип данных.

Если расписание пусто, то временем начала является NaN.

Пример

Создайте расписание. В этом расписании временной шаг между последовательными строками не является тем же самым, таким образом, расписание неправильно.

TT = timetable(datetime({'2015-12-18';'2015-12-20';'2015-12-21'}), ...
               [37.3;39.1;42.3],[13.4;6.5;7.3],{'N';'SE';'NW'});
TT.Properties.VariableNames = {'Temperature','WindSpeed','WindDirection'}

TT=3×4 timetable
       Time        Temperature    WindSpeed    WindDirection
    ___________    ___________    _________    _____________

    18-Dec-2015       37.3          13.4           'N'      
    20-Dec-2015       39.1           6.5           'SE'     
    21-Dec-2015       42.3           7.3           'NW'     

Отобразите его свойства. Значение свойства StartTime равно первому разу строки. Обычно ли расписание или неправильно, оно всегда имеет время начала, если это не пусто.

TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temperature'  'WindSpeed'  'WindDirection'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: NaN
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

Измените свойство StartTime. Обратите внимание на то, что все времена строки имеют новые значения. В течение каждого раза строки изменение в значении равно различию между исходным значением первого раза строки и новым временем начала.

TT.Properties.StartTime = datetime('2018-04-09')

TT=3×4 timetable
            Time            Temperature    WindSpeed    WindDirection
    ____________________    ___________    _________    _____________

    09-Apr-2018 00:00:00       37.3          13.4           'N'      
    11-Apr-2018 00:00:00       39.1           6.5           'SE'     
    12-Apr-2018 00:00:00       42.3           7.3           'NW'     

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

Если времена строки не являются регулярными, или расписание пусто, то частотой дискретизации является NaN.

Пример

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

Если времена строки не являются регулярными, или расписание пусто, то временным шагом является NaN.

Пример

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

Intensity = [100;98.7;95.2;101.4;99.1];
TT = timetable(Intensity,'TimeStep',seconds(0.01))

TT=5×2 timetable
      Time      Intensity
    ________    _________

    0 sec           100  
    0.01 sec       98.7  
    0.02 sec       95.2  
    0.03 sec      101.4  
    0.04 sec       99.1  

Отобразите его свойства. Свойство TimeStep хранит временной шаг как длительность.

TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Intensity'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [5x1 duration]
               StartTime: 0 sec
              SampleRate: 100
                TimeStep: 0.01 sec
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

Измените свойство TimeStep. Время начала является тем же самым, но все другие времена строки отличаются, потому что временной шаг больше. Однако переменная Intensity остается то же самое.

TT.Properties.TimeStep = seconds(0.04)

TT=5×2 timetable
      Time      Intensity
    ________    _________

    0 sec           100  
    0.04 sec       98.7  
    0.08 sec       95.2  
    0.12 sec      101.4  
    0.16 sec       99.1  

Типы данных: duration | calendarDuration

Имена переменных, заданные как массив ячеек из символьных векторов или массив строк, с именами, которые непусты и отличны. Имена переменных должны быть допустимыми идентификаторами MATLAB^®. Можно определить допустимые имена переменной с помощью функционального isvarname. MATLAB удаляет любое продвижение или запаздывающий пробел от векторов символов. Количество векторов символов должно равняться количеству переменных.

Если вы не задаете имена переменных, или вы задаете недопустимые идентификаторы, то MATLAB использует массив ячеек векторов символов N формы {'Var1' ... 'VarN'}, где N является количеством переменных.

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

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

Пример

Создайте расписание с именами переменных по умолчанию. Затем измените имена с помощью свойства Properties.VariableNames.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3])

TT=3×4 timetable
       Time        Var1    Var2     Var3
    ___________    ____    _____    ____

    18-Dec-2015    37.3     30.1    13.4
    19-Dec-2015    39.1    30.03     6.5
    20-Dec-2015    42.3     29.9     7.3

TT.Properties.VariableNames = {'Temp','Pressure','WindSpeed'}

TT=3×4 timetable
       Time        Temp    Pressure    WindSpeed
    ___________    ____    ________    _________

    18-Dec-2015    37.3      30.1        13.4   
    19-Dec-2015    39.1     30.03         6.5   
    20-Dec-2015    42.3      29.9         7.3   

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

TT.Temp

ans = 3×1

   37.3000
   39.1000
   42.3000

TT.Pressure(3) = 30

TT=3×4 timetable
       Time        Temp    Pressure    WindSpeed
    ___________    ____    ________    _________

    18-Dec-2015    37.3      30.1        13.4   
    19-Dec-2015    39.1     30.03         6.5   
    20-Dec-2015    42.3        30         7.3   

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

Описания переменной видимы при использовании функции summary.

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

Пример

Создайте расписание. Измените имена переменных и описания. Отобразите сводные данные результата.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3]);
TT.Properties.VariableNames = {'Temp','Pressure','WindSpeed'};
TT.Properties.VariableDescriptions = {'Temperature (external)', ...
                                      'Pressure in Hg', ...
                                      'Wind speed at sensor 123'};
summary(TT)

RowTimes:

    Time: 3x1 datetime
        Values:
            Min           18-Dec-2015 
            Median        19-Dec-2015 
            Max           20-Dec-2015 
            TimeStep      24:00:00    

Variables:

    Temp: 3x1 double

        Properties:
            Description:  Temperature (external)
        Values:

            Min        37.3 
            Median     39.1 
            Max        42.3 

    Pressure: 3x1 double

        Properties:
            Description:  Pressure in Hg
        Values:

            Min          29.9   
            Median      30.03   
            Max          30.1   

    WindSpeed: 3x1 double

        Properties:
            Description:  Wind speed at sensor 123
        Values:

            Min           6.5    
            Median        7.3    
            Max          13.4    

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

Переменные модули видимы при использовании функции summary.

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

Пример

Создайте расписание. Измените имена переменных и модули. Отобразите сводные данные результата.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[30.1;30.03;29.9],[13.4;6.5;7.3]);
TT.Properties.VariableNames = {'Temp','Pressure','WindSpeed'};
TT.Properties.VariableUnits = {'degrees F','mm Hg','mph'};
summary(TT)

RowTimes:

    Time: 3x1 datetime
        Values:
            Min           18-Dec-2015 
            Median        19-Dec-2015 
            Max           20-Dec-2015 
            TimeStep      24:00:00    

Variables:

    Temp: 3x1 double

        Properties:
            Units:  degrees F
        Values:

            Min        37.3 
            Median     39.1 
            Max        42.3 

    Pressure: 3x1 double

        Properties:
            Units:  mm Hg
        Values:

            Min          29.9   
            Median      30.03   
            Max          30.1   

    WindSpeed: 3x1 double

        Properties:
            Units:  mph
        Values:

            Min           6.5    
            Median        7.3    
            Max          13.4    

Состояние как непрерывные или дискретные переменные, заданные как массив ячеек из символьных векторов или массив строк. Это свойство может быть пустым массивом, который является значением по умолчанию. Если массив не пуст, то он должен содержать столько же элементов, сколько существуют переменные. Каждым элементом может быть или 'unset', 'continuous', 'step' или 'event'.

Значения в VariableContinuity влияют, как retime или функции synchronize работают. Если вы задаете VariableContinuity и вызываете retime или synchronize, то вы не должны задавать метод. Вместо этого retime и synchronize заполняют выходные переменные расписания с помощью следующих методов по умолчанию:

Если вы действительно задаете метод как входной параметр к retime или synchronize, то тот метод заменяет значения, которые вы задаете в VariableContinuity.

Для получения дополнительной информации об использовании свойства VariableContinuity смотрите, Повторно синхронизируют и Синхронизируют Переменные Расписания Используя Различные Методы.

Пример

Создайте расписание. Задайте значение matlab.tabular.Continuity для каждой переменной.

TT = timetable(datetime({'2015-12-18';'2015-12-19';'2015-12-20'}), ...
               [37.3;39.1;42.3],[13.4;6.5;7.3],{'N';'SE';'NW'});
TT.Properties.VariableNames = {'Temperature','WindSpeed','WindDirection'};
TT.Properties.VariableContinuity = {'continuous','event','event'};
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temperature'  'WindSpeed'  'WindDirection'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: [continuous    event    event]
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: 1d
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

Индивидуально настраиваемые метаданные расписания и его переменных, заданных как объект CustomProperties.

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

Примечание: можно добавить или удалить только свойства для индивидуально настраиваемых метаданных с помощью addprop и rmprop. Вы не можете добавить или удалить свойства объекта timetableName.Properties.

TT = timetable(datetime({'2015-12-18';'2015-12-20';'2015-12-21'}), ...
               [37.3;39.1;42.3],[13.4;6.5;7.3],{'N';'SE';'NW'});
TT.Properties.VariableNames = {'Temperature','WindSpeed','WindDirection'}

TT=3×4 timetable
       Time        Temperature    WindSpeed    WindDirection
    ___________    ___________    _________    _____________

    18-Dec-2015       37.3          13.4           'N'      
    20-Dec-2015       39.1           6.5           'SE'     
    21-Dec-2015       42.3           7.3           'NW'     

TT = addprop(TT,{'Instruments','OutputFile'},{'variable','table'});
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temperature'  'WindSpeed'  'WindDirection'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: NaN

   Custom Properties (access using t.Properties.CustomProperties.<name>):
              OutputFile: []
             Instruments: []

TT.Properties.CustomProperties.Instruments = ["thermometer","anemometer","wind vane"];
TT.Properties.CustomProperties.OutputFile = 'weatherReadings.csv';
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temperature'  'WindSpeed'  'WindDirection'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: NaN

   Custom Properties (access using t.Properties.CustomProperties.<name>):
              OutputFile: 'weatherReadings.csv'
             Instruments: ["thermometer"    "anemometer"    "wind vane"]

TT = rmprop(TT,'OutputFile');
TT.Properties

ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Time'  'Variables'}
           VariableNames: {'Temperature'  'WindSpeed'  'WindDirection'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [3x1 datetime]
               StartTime: 18-Dec-2015
              SampleRate: NaN
                TimeStep: NaN

   Custom Properties (access using t.Properties.CustomProperties.<name>):
             Instruments: ["thermometer"    "anemometer"    "wind vane"]