カスタム プロパティを table および timetable に追加する

ライブ スクリプトを開く

この例では、カスタム プロパティの table および timetable への追加、値の設定とアクセス、そして削除の方法を説明します。

すべての table および timetable には、それらに関するメタデータやそれらの変数が含まれるプロパティがあります。これらのプロパティは、T.Properties オブジェクトを通じてアクセスできます。ここで T は table または timetable の名前です。たとえば、T.Properties.VariableNames は、T の変数の名前を含む cell 配列を返します。

T.Properties を通じてアクセスするプロパティは、table や timetable のデータ型の定義の一部です。これらの事前定義されたプロパティは追加または削除できません。ただし、R2018b 以降では、table または timetable の T.Properties.CustomProperties オブジェクトを変更して、独自の "カスタム" プロパティを追加または削除できます。

プロパティの追加

停電データを table に読み取ります。日付と時刻を含む最初の変数 OutageTime を使用してそのデータを並べ替えます。次に、最初の 3 行を表示します。

T = readtable('outages.csv');
T = sortrows(T,'OutageTime');
head(T,3)
       Region           OutageTime        Loss     Customers     RestorationTime          Cause      
    _____________    ________________    ______    __________    ________________    ________________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'}
    {'MidWest'  }    2002-03-05 17:53    96.563    2.8666e+05    2002-03-10 14:41    {'wind'        }
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'}

そのプロパティを表示します。これらは、すべての table に共通して含まれているプロパティです。CustomProperties オブジェクトもありますが、既定ではプロパティが含まれていません。

T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'Region'  'OutageTime'  'Loss'  'Customers'  'RestorationTime'  'Cause'}
           VariableTypes: ["cell"    "datetime"    "double"    "double"    "datetime"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

カスタム プロパティを追加するには、関数 addprop を使用します。プロパティの名前を指定します。また、プロパティごとに、table 全体 (Description プロパティと同様) またはその変数 (VariableNames プロパティと同様) のどちらのメタデータがあるか指定します。プロパティに変数メタデータがある場合、その値は長さが変数の数と同じベクトルにしなければなりません。

出力ファイル名、ファイルのタイプ、およびプロットする変数のインジケーターを含むカスタム プロパティを追加します。ベスト プラクティスとして、入力 table を addprop の出力引数として割り当てて、カスタム プロパティが同じテーブルの一部になるようにすることをお勧めします。出力ファイル名とファイル タイプが table メタデータであることを 'table' オプションを使用して指定します。プロット インジケーターが変数メタデータであることを 'variable' オプションを使用して指定します。

T = addprop(T,{'OutputFileName','OutputFileType','ToPlot'}, ...
              {'table','table','variable'});
T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'Region'  'OutageTime'  'Loss'  'Customers'  'RestorationTime'  'Cause'}
           VariableTypes: ["cell"    "datetime"    "double"    "double"    "datetime"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

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

カスタム プロパティの値の設定とアクセス

addprop を使用してカスタム プロパティを追加すると、それらの値は既定では空の配列になります。カスタム プロパティの値の設定と値へのアクセスはドット構文を使用して可能です。

出力ファイルの名前とタイプを設定します。これらのプロパティには table のメタデータが含まれています。次に、logical 配列を ToPlot プロパティに割り当てます。このプロパティには、変数のメタデータが含まれます。この例で、ToPlot プロパティの値の要素は、プロットに含む各変数については true、除外する各変数については false です。

T.Properties.CustomProperties.OutputFileName = 'outageResults';
T.Properties.CustomProperties.OutputFileType = '.mat';
T.Properties.CustomProperties.ToPlot = [false false true true true false];
T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'Region'  'OutageTime'  'Loss'  'Customers'  'RestorationTime'  'Cause'}
           VariableTypes: ["cell"    "datetime"    "double"    "double"    "datetime"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

   Custom Properties (access using t.Properties.CustomProperties.<name>):
          OutputFileName: 'outageResults'
          OutputFileType: '.mat'
                  ToPlot: [0 0 1 1 1 0]

関数 stackedplot を使用して、積み上げプロットで T からの変数をプロットします。Loss、Customers、および RestorationTime の値のみプロットするには、ToPlot カスタム プロパティを 2 番目の入力引数として使用します。

stackedplot(T,T.Properties.CustomProperties.ToPlot);

Figure contains an object of type stackedplot.

table 変数を移動または削除すると、事前定義されたプロパティとカスタム プロパティの両方が並べ替えられてそれらの値が同じ変数に対応します。この例では、ToPlot カスタム プロパティの値は、VariableNames の事前定義されたプロパティの値が整合するのと同様に、プロット用にマークされた変数と整合します。

Customers 変数を削除し、プロパティを表示します。

T.Customers = [];
T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'Region'  'OutageTime'  'Loss'  'RestorationTime'  'Cause'}
           VariableTypes: ["cell"    "datetime"    "double"    "datetime"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}

   Custom Properties (access using t.Properties.CustomProperties.<name>):
          OutputFileName: 'outageResults'
          OutputFileType: '.mat'
                  ToPlot: [0 0 1 1 0]

停電時間を行時間として使用して、table を timetable に変換します。関数 movevars を使用して、Region を table の終わりに移動させ、RestorationTime を最初の変数の前に移動させます。プロパティは適切に並べ替えられています。変数 RestorationTime と変数 Loss には、プロット内に含めることを示すインジケーターもあります。

T = table2timetable(T);
T = movevars(T,'Region','After','Cause');
T = movevars(T,'RestorationTime','Before',1);
T.Properties
ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'OutageTime'  'Variables'}
           VariableNames: {'RestorationTime'  'Loss'  'Cause'  'Region'}
           VariableTypes: ["datetime"    "double"    "cell"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [1468×1 datetime]
               StartTime: 2002-02-01 12:18
              SampleRate: NaN
                TimeStep: NaN
                  Events: []

   Custom Properties (access using t.Properties.CustomProperties.<name>):
          OutputFileName: 'outageResults'
          OutputFileType: '.mat'
                  ToPlot: [1 1 0 0]

プロパティの削除

関数 rmprop を使用して table のカスタム プロパティのいずれかまたはすべてを削除できます。ただし、事前定義されたプロパティは table データ型の定義の一部であるため、T.Properties からそれらのプロパティを削除するためには使用できません。

OutputFileName および OutputFileType カスタム プロパティを削除します。残りの table プロパティを表示します。

T = rmprop(T,{'OutputFileName','OutputFileType'});
T.Properties
ans = 
  TimetableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'OutageTime'  'Variables'}
           VariableNames: {'RestorationTime'  'Loss'  'Cause'  'Region'}
           VariableTypes: ["datetime"    "double"    "cell"    "cell"]
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowTimes: [1468×1 datetime]
               StartTime: 2002-02-01 12:18
              SampleRate: NaN
                TimeStep: NaN
                  Events: []

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

参考

| | | | | | | |

トピック