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

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

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

Пример

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

load patients
T = table(Age,Height,Weight,Systolic,Diastolic, ...
          'RowNames',LastName);
T.Properties.DimensionNames

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

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

T.Row(1:5)

ans = 5x1 cell array
    {'Smith'   }
    {'Johnson' }
    {'Williams'}
    {'Jones'   }
    {'Brown'   }

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

T.Variables

ans = 100×5

    38    71   176   124    93
    43    69   163   109    77
    38    64   131   125    83
    40    67   133   117    75
    49    64   119   122    80
    46    68   142   121    70
    33    64   142   130    88
    40    68   180   115    82
    28    68   183   115    78
    31    66   132   118    86
      ⋮

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

T.Properties.DimensionNames = {'Patient','Data'};
T.Properties

ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Patient'  'Data'}
           VariableNames: {'Age'  'Height'  'Weight'  'Systolic'  'Diastolic'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {100x1 cell}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

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

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

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

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

Пример

Составление таблицы. Затем добавьте имена строки и строки доступа их именами.

load patients
T = table(Gender,Age,Height,Weight,Smoker,Systolic,Diastolic);

Добавьте имена строки с помощью свойства Properties.RowNames. По умолчанию таблицы не имеют имен строки, но можно добавить их в любое время.

T.Properties.RowNames = LastName;
head(T,4)

ans=4×7 table
                 Gender     Age    Height    Weight    Smoker    Systolic    Diastolic
                ________    ___    ______    ______    ______    ________    _________

    Smith       'Male'      38       71       176      true        124          93    
    Johnson     'Male'      43       69       163      false       109          77    
    Williams    'Female'    38       64       131      false       125          83    
    Jones       'Female'    40       67       133      false       117          75    

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

T.Properties.DimensionNames

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

T.Row(1:5)

ans = 5x1 cell array
    {'Smith'   }
    {'Johnson' }
    {'Williams'}
    {'Jones'   }
    {'Brown'   }

Индексируйте в таблицу именами строки.

T({'Smith','Williams'},:)

ans=2×7 table
                 Gender     Age    Height    Weight    Smoker    Systolic    Diastolic
                ________    ___    ______    ______    ______    ________    _________

    Smith       'Male'      38       71       176      true        124          93    
    Williams    'Female'    38       64       131      false       125          83    

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

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

Пример

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

load patients
T = table(Gender,Age,Height,Weight);
T.Properties.Description = 'Simulated patient data';
summary(T)

Description:  Simulated patient data

Variables:

    Gender: 100x1 cell array of character vectors

    Age: 100x1 double

        Values:

            Min        25  
            Median     39  
            Max        50  

    Height: 100x1 double

        Values:

            Min          60   
            Median       67   
            Max          72   

    Weight: 100x1 double

        Values:

            Min          111  
            Median     142.5  
            Max          202  

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

Пример

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

load patients
T = table(Gender,Age,Height,Weight,Smoker,Systolic,Diastolic);
formula = @(x) x.^2;
T.Properties.UserData = formula;
T.Properties

ans = 
  TableProperties with properties:

             Description: ''
                UserData: @(x)x.^2
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {1x7 cell}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

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

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

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

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

Пример

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

T = table({'M';'M';'F';'F';'F'},[38;43;38;40;49], ...
          [71;69;64;67;64],[176;163;131;133;119])

T=5×4 table
    Var1    Var2    Var3    Var4
    ____    ____    ____    ____

    'M'      38      71     176 
    'M'      43      69     163 
    'F'      38      64     131 
    'F'      40      67     133 
    'F'      49      64     119 

T.Properties.VariableNames = {'Gender','Age','Height','Weight'}

T=5×4 table
    Gender    Age    Height    Weight
    ______    ___    ______    ______

     'M'      38       71       176  
     'M'      43       69       163  
     'F'      38       64       131  
     'F'      40       67       133  
     'F'      49       64       119  

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

T.Age

ans = 5×1

    38
    43
    38
    40
    49

T.Age(1) = 53

T=5×4 table
    Gender    Age    Height    Weight
    ______    ___    ______    ______

     'M'      53       71       176  
     'M'      43       69       163  
     'F'      38       64       131  
     'F'      40       67       133  
     'F'      49       64       119  

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

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

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

Пример

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

load patients
T = table(Gender,Age,Height,Weight,Smoker,Systolic,Diastolic);
T.Properties.VariableDescriptions = {'','','','', ...
                                     'Has the patient ever been a smoker', ...
                                     'Systolic Pressure','Diastolic Pressure'};
summary(T)

Variables:

    Gender: 100x1 cell array of character vectors

    Age: 100x1 double

        Values:

            Min        25  
            Median     39  
            Max        50  

    Height: 100x1 double

        Values:

            Min          60   
            Median       67   
            Max          72   

    Weight: 100x1 double

        Values:

            Min          111  
            Median     142.5  
            Max          202  

    Smoker: 100x1 logical

        Properties:
            Description:  Has the patient ever been a smoker
        Values:

            True        34   
            False       66   

    Systolic: 100x1 double

        Properties:
            Description:  Systolic Pressure
        Values:

            Min          109    
            Median       122    
            Max          138    

    Diastolic: 100x1 double

        Properties:
            Description:  Diastolic Pressure
        Values:

            Min            68    
            Median       81.5    
            Max            99    

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

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

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

Пример

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

load patients
T = table(Gender,Age,Height,Weight,Smoker,Systolic,Diastolic);
T.Properties.VariableUnits = {'','Yrs','In','Lbs','','mm Hg','mm Hg'};
summary(T)

Variables:

    Gender: 100x1 cell array of character vectors

    Age: 100x1 double

        Properties:
            Units:  Yrs
        Values:

            Min        25  
            Median     39  
            Max        50  

    Height: 100x1 double

        Properties:
            Units:  In
        Values:

            Min          60   
            Median       67   
            Max          72   

    Weight: 100x1 double

        Properties:
            Units:  Lbs
        Values:

            Min          111  
            Median     142.5  
            Max          202  

    Smoker: 100x1 logical

        Values:

            True        34   
            False       66   

    Systolic: 100x1 double

        Properties:
            Units:  mm Hg
        Values:

            Min          109    
            Median       122    
            Max          138    

    Diastolic: 100x1 double

        Properties:
            Units:  mm Hg
        Values:

            Min            68    
            Median       81.5    
            Max            99    

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

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

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

load patients
T = table(Gender,Age,Height,Weight,Smoker,Systolic,Diastolic);

T = addprop(T,{'Instrument','ToPlot','OutputFile'},{'variable','variable','table'});
T.Properties

ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {1x7 cell}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

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

T.Properties.CustomProperties.Instrument = ["","","height rod","scale","","blood pressure cuff","blood pressure cuff"];
T.Properties.CustomProperties.ToPlot = [false false true true false true true];
T.Properties.CustomProperties.OutputFile = 'patientData.csv';
T.Properties

ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {1x7 cell}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

   Custom Properties (access using t.Properties.CustomProperties.<name>):
              OutputFile: 'patientData.csv'
              Instrument: [1x7 string]
                  ToPlot: [0 0 1 1 0 1 1]

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

ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {1x7 cell}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

   Custom Properties (access using t.Properties.CustomProperties.<name>):
              Instrument: [1x7 string]
                  ToPlot: [0 0 1 1 0 1 1]