table2timetable

table の timetable への変換

ページ内をすべて折りたたむ

構文

TT = table2timetable(T)

TT = table2timetable(T,'RowTimes',timeVarName)

TT = table2timetable(T,'RowTimes',rowTimes)

TT = table2timetable(T,'SampleRate',Fs)

TT = table2timetable(T,'TimeStep',dt)

TT = table2timetable(___,'StartTime',t0)

説明

TT = table2timetable(T) は、入力 table を timetable に変換します。T 内の最初の datetime または duration 変数が、TT の行時間のベクトルになります。T の残りの変数が TT の変数になります。

T が行名のない M 行 N 列の table の場合、TT は M 行 (N-1) 列の timetable です。
T が行名のある M 行 N 列の table の場合、table2timetable は T の行名を TT の変数に割り当てます。その結果、TT は M 行 N 列の timetable となります。

timetable の作成および使用の詳細については、timetableを参照してください。

テキストファイルまたはスプレッドシートファイルのデータから timetable を作成するには、関数 readtimetable を使用します。

例

TT = table2timetable(T,'RowTimes',timeVarName) は、table 変数 timeVarName を出力 timetable の行時間のベクトルとして割り当てます。timeVarName は datetime または duration 値を含む T 内の任意の変数の名前またはインデックスにすることができます。T の残りの変数が TT の変数になります。

例

TT = table2timetable(T,'RowTimes',rowTimes) は、ベクトル rowTimes を出力 timetable の行時間のベクトルとして割り当てます。T のすべての変数が TT の変数になります。

例

TT = table2timetable(T,'SampleRate',Fs) は、サンプルレート Fs を使用して等間隔の行時間を計算します。Fs は 1 秒あたりのサンプル数 (Hz) を指定する数値スカラーです。最初の行時間はゼロ秒です。

例

TT = table2timetable(T,'TimeStep',dt) はタイムステップ dt を使用して等間隔の行時間を計算します。dt は連続する行時間の間の時間の長さを指定する期間またはカレンダー期間の値です。最初の行時間はゼロ秒です。

例

TT = table2timetable(___,'StartTime',t0) は最初の行時間としてゼロ秒ではなく開始時間 t0 を指定します。この構文は、前述の 2 つの構文にある名前と値のペアの引数 'SampleRate' または 'TimeStep' のいずれかを使用して規則的な timetable を作成する場合に使用できます。

例

すべて折りたたむ

table の timetable への変換

ライブスクリプトを開く

日付と時刻を含む table を timetable に変換します。

ファイル outages.csv から停電データを table に読み取ります。table には停電と復旧の両方の時刻が含まれています。

T = readtable('outages.csv');
T(1:5,:)

ans=5×6 table
       Region           OutageTime        Loss     Customers     RestorationTime            Cause       
    _____________    ________________    ______    __________    ________________    ___________________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }
    {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05                 NaT    {'winter storm'   }
    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }
    {'West'     }    2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }

table を timetable に変換します。時刻のある最初の変数 OutageTime が TT の時間ベクトルになります。

TT = table2timetable(T);
TT(1:5,:)

ans=5×5 timetable
       OutageTime          Region         Loss     Customers     RestorationTime            Cause       
    ________________    _____________    ______    __________    ________________    ___________________

    2002-02-01 12:18    {'SouthWest'}    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }
    2003-01-23 00:49    {'SouthEast'}    530.14    2.1204e+05                 NaT    {'winter storm'   }
    2003-02-07 21:15    {'SouthEast'}     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }
    2004-04-06 05:44    {'West'     }    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}
    2002-03-16 06:18    {'MidWest'  }    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }

その時間ベクトルの行時間を TT のインデックスとして使用します。行時間は、行を指定するラベルとして扱うことができます。

TT('2003-02-07 21:15',:)

ans=1×5 timetable
       OutageTime          Region        Loss     Customers     RestorationTime          Cause      
    ________________    _____________    _____    __________    ________________    ________________

    2003-02-07 21:15    {'SouthEast'}    289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'}

停電の継続期間を計算します。ドット構文を使用して、行時間をベクトルとして抽出します。

TT.OutageDuration = TT.RestorationTime - TT.OutageTime;
TT(1:5,:)

ans=5×6 timetable
       OutageTime          Region         Loss     Customers     RestorationTime            Cause           OutageDuration
    ________________    _____________    ______    __________    ________________    ___________________    ______________

    2002-02-01 12:18    {'SouthWest'}    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }      148:32:00   
    2003-01-23 00:49    {'SouthEast'}    530.14    2.1204e+05                 NaT    {'winter storm'   }            NaN   
    2003-02-07 21:15    {'SouthEast'}     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }      226:59:00   
    2004-04-06 05:44    {'West'     }    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}       00:26:00   
    2002-03-16 06:18    {'MidWest'  }    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }       65:05:00

table 変数を行時間として指定

ライブスクリプトを開く

table を timetable に変換し、timetable の時間ベクトルになる table 変数を指定します。

ファイル outages.csv から停電データを table に読み取ります。table には停電と復旧の両方の時刻が含まれています。

T = readtable('outages.csv');
T(1:5,:)

ans=5×6 table
       Region           OutageTime        Loss     Customers     RestorationTime            Cause       
    _____________    ________________    ______    __________    ________________    ___________________

    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    2002-02-07 16:50    {'winter storm'   }
    {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05                 NaT    {'winter storm'   }
    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    2003-02-17 08:14    {'winter storm'   }
    {'West'     }    2004-04-06 05:44    434.81    3.4037e+05    2004-04-06 06:10    {'equipment fault'}
    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    2002-03-18 23:23    {'severe storm'   }

table を timetable に変換します。日付と時刻のある 2 番目の変数 RestorationTime を、timetable の時間ベクトルとして指定します。

TT = table2timetable(T,'RowTimes','RestorationTime');
TT(1:5,:)

ans=5×5 timetable
    RestorationTime        Region           OutageTime        Loss     Customers            Cause       
    ________________    _____________    ________________    ______    __________    ___________________

    2002-02-07 16:50    {'SouthWest'}    2002-02-01 12:18    458.98    1.8202e+06    {'winter storm'   }
    NaT                 {'SouthEast'}    2003-01-23 00:49    530.14    2.1204e+05    {'winter storm'   }
    2003-02-17 08:14    {'SouthEast'}    2003-02-07 21:15     289.4    1.4294e+05    {'winter storm'   }
    2004-04-06 06:10    {'West'     }    2004-04-06 05:44    434.81    3.4037e+05    {'equipment fault'}
    2002-03-18 23:23    {'MidWest'  }    2002-03-16 06:18    186.44    2.1275e+05    {'severe storm'   }

個別の時間ベクトルで table を変換

ライブスクリプトを開く

行時間を含む個別の時間ベクトルを追加して、table を timetable に変換します。すべての table 変数が timetable の変数になります。

Reading1 = [98;97.5;97.9;98.1;97.9];
Reading2 = [120;111;119;117;116];
T = table(Reading1,Reading2)

T=5×2 table
    Reading1    Reading2
    ________    ________

        98        120   
      97.5        111   
      97.9        119   
      98.1        117   
      97.9        116

Time = [seconds(1):seconds(1):seconds(5)];
TT = table2timetable(T,'RowTimes',Time)

TT=5×2 timetable
    Time     Reading1    Reading2
    _____    ________    ________

    1 sec        98        120   
    2 sec      97.5        111   
    3 sec      97.9        119   
    4 sec      98.1        117   
    5 sec      97.9        116

サンプルレートの指定

ライブスクリプトを開く

table を作成します。

Reading1 = [98;97.5;97.9;98.1;97.9];
Reading2 = [120;111;119;117;116];
T = table(Reading1,Reading2)

T=5×2 table
    Reading1    Reading2
    ________    ________

        98        120   
      97.5        111   
      97.9        119   
      98.1        117   
      97.9        116

500 Hz のサンプルレートを指定します。そのサンプルレートと 0 秒の行の開始行時間を使用して、T を timetable に変換します。

TT = table2timetable(T,'SampleRate',500)

TT=5×2 timetable
      Time       Reading1    Reading2
    _________    ________    ________

    0 sec            98        120   
    0.002 sec      97.5        111   
    0.004 sec      97.9        119   
    0.006 sec      98.1        117   
    0.008 sec      97.9        116

タイムステップの指定

ライブスクリプトを開く

table を作成します。

Reading1 = [98;97.5;97.9;98.1;97.9];
Reading2 = [120;111;119;117;116];
T = table(Reading1,Reading2)

T=5×2 table
    Reading1    Reading2
    ________    ________

        98        120   
      97.5        111   
      97.9        119   
      98.1        117   
      97.9        116

関数 seconds を使用して、10 秒のタイムステップを指定します。そのサンプリングレートと 0 秒の行の開始行時間を使用して、T を timetable に変換します。

TT = table2timetable(T,'TimeStep',seconds(10))

TT=5×2 timetable
      Time      Reading1    Reading2
    ________    ________    ________

    00:00:00        98        120   
    00:00:10      97.5        111   
    00:00:20      97.9        119   
    00:00:30      98.1        117   
    00:00:40      97.9        116

開始時間の指定

ライブスクリプトを開く

table を作成します。

Reading1 = [98;97.5;97.9;98.1;97.9];
Reading2 = [120;111;119;117;116];
T = table(Reading1,Reading2)

T=5×2 table
    Reading1    Reading2
    ________    ________

        98        120   
      97.5        111   
      97.9        119   
      98.1        117   
      97.9        116

10 秒のタイムステップと 5 秒の開始時間を指定して timetable に変換します。

dt = seconds(10);
t0 = seconds(5);
TT = table2timetable(T,'TimeStep',dt,'StartTime',t0)

TT=5×2 timetable
     Time     Reading1    Reading2
    ______    ________    ________

    5 sec         98        120   
    15 sec      97.5        111   
    25 sec      97.9        119   
    35 sec      98.1        117   
    45 sec      97.9        116

入力引数

すべて折りたたむ

`T` — 入力 table
table

入力 table。

`timeVarName` — 入力 table からの変数
文字ベクトル | string スカラー | 数値インデックス

入力 table からの変数。文字ベクトル、string スカラー、または数値インデックスとして指定します。

`rowTimes` — 出力 timetable に割り当てられる行時間
datetime ベクトル | duration ベクトル

出力 timetable に割り当てられる行時間。datetime ベクトルまたは duration ベクトルとして指定します。rowTimes の要素数は、入力 table の行数と等しくなければなりません。rowTimes の時間値は、一意であったり、並べ替えられていたり、規則的な値である必要はありません。

`Fs` — サンプルレート
数値スカラー

サンプルレート。数値スカラーとして指定します。Fs は 1 秒あたりのサンプル数 (Hz) を指定します。

`dt` — タイムステップ
duration スカラー | カレンダー期間スカラー

タイムステップ。duration スカラーまたはカレンダー期間スカラーとして指定します。

データ型: duration | calendarDuration

`t0` — 開始時間
datetime スカラー | duration スカラー

開始時間。datetime スカラーまたは duration スカラーとして指定します。

t0 が datetime 値である場合、TT の行時間は datetime 値です。
t0 が duration である場合、行時間は duration です。

タイムステップ dt がカレンダー期間の値である場合、t0 は datetime 値でなければなりません。

データ型: datetime | duration

出力引数

すべて折りたたむ

`TT` — 出力 timetable
timetable

出力 timetable。timetable には、説明、変数の単位、変数名、行時間などのメタデータを保存できます。詳細については、timetable プロパティの節を参照してください。

ヒント

場合によっては、行時間の間の一定のタイムステップを指定する構文を使用して table2timetable を呼び出すこともできますが、それでも table2timetable は不規則な timetable を返します。タイムステップをカレンダーの時間単位を使用して指定し、不規則なステップを発生させる行時間が存在する場合に、このような結果が発生します。たとえば、2019 年 1 月 31 日から始まり、タイムステップが 1 カレンダー月の timetable を作成した場合、月に関して不規則になります。

stime = datetime(2019,1,31);
tstep = calmonths(1);
T = table([1:3]');
TT = table2timetable(T,'TimeStep',tstep,'StartTime',stime)

TT =

  3×1 timetable

       Time        Var1
    ___________    ____

    31-Jan-2019     1  
    28-Feb-2019     2  
    31-Mar-2019     3

夏時間 (DST) からの移行、またはうるう秒である datetime 値が原因で不規則性が発生する場合もあります。次の表は、予期しない不規則な結果が発生する可能性がある日付、時刻、およびタイムステップを示しています。

行時間値	タイムステップ
月の 29 日、30 日または 31 日として指定する開始時間。	カレンダー月または四半期の数。
2 月 29 日として指定する開始時間。	カレンダー年の数。
DST から標準時間に移行する日の午前 1 時と午前 2 時の間に発生するすべての `datetime` 値 (それらの値のタイムゾーンで DST が適用される場合)。	カレンダー日またはカレンダー月の数。
うるう秒であるすべての `datetime` 値 (それらの値のタイムゾーンが `UTCLeapSeconds` タイムゾーンである場合)。うるう秒のリストについては、`leapseconds` を参照してください。	任意のカレンダー単位 (日、週、月、四半期、年) で指定されているタイムステップ。

拡張機能

すべて展開する

tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。

table2timetable 関数は tall 配列をサポートしていますが、以下の使用上の注意および制限があります。

名前と値の引数 'SampleRate'、'TimeStep'、および 'StartTime' はサポートされません。

詳細については、tall 配列を参照してください。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

使用上の注意および制限:

'SampleRate'、'TimeStep'、または 'StartTime' の名前と値の引数を使用して規則的な行時間を指定する場合、行時間を規則的にするにはコンパイル時に値は定数でなければなりません。そうしない場合、行時間は生成されたコードで不規則であると見なされます。
入力 table の UserData プロパティの値が空でない場合、その値は出力には含まれません。出力 timetable の UserData プロパティは常に空です。

詳細については、timetable のコード生成 (MATLAB Coder)とコード生成における timetable の制限事項 (MATLAB Coder)を参照してください。

スレッドベースの環境
MATLAB® の `backgroundPool` を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の `ThreadPool` を使用してコードを高速化します。

分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

使用上の注意および制限:

名前と値の引数 'SampleRate'、'TimeStep'、および 'StartTime' はサポートされません。

詳細については、分散配列を使用した MATLAB 関数の実行 (Parallel Computing Toolbox)を参照してください。

バージョン履歴

R2016b で導入

すべて展開する

R2021a: `'SamplingRate'` は削除予定

'SamplingRate' の名前と値の引数は将来のリリースで削除される予定です。代わりに 'SampleRate' を使用してください。対応する timetable プロパティも SampleRate という名前になります。

下位互換性のため、引き続き 'SamplingRate' を名前と値の引数の名前として指定できます。ただし、値は SampleRate プロパティに割り当てられます。

参考

array2timetable | timetable | isvarname | summary | uitable

table2timetable

構文

説明

例

table の timetable への変換

table 変数を行時間として指定

個別の時間ベクトルで table を変換

サンプル レートの指定

タイム ステップの指定

開始時間の指定

入力引数

T — 入力 table table

timeVarName — 入力 table からの変数 文字ベクトル | string スカラー | 数値インデックス

rowTimes — 出力 timetable に割り当てられる行時間 datetime ベクトル | duration ベクトル

Fs — サンプル レート 数値スカラー

dt — タイム ステップ duration スカラー | カレンダー期間スカラー

t0 — 開始時間 datetime スカラー | duration スカラー

出力引数

TT — 出力 timetable timetable

ヒント

拡張機能

tall 配列 メモリの許容量を超えるような多数の行を含む配列を計算します。

C/C++ コード生成 MATLAB® Coder™ を使用して C および C++ コードを生成します。

スレッドベースの環境 MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

分散配列 Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

バージョン履歴

R2021a: 'SamplingRate' は削除予定

参考

トピック

サンプルレートの指定

タイムステップの指定

`T` — 入力 table
table

`timeVarName` — 入力 table からの変数
文字ベクトル | string スカラー | 数値インデックス

`rowTimes` — 出力 timetable に割り当てられる行時間
datetime ベクトル | duration ベクトル

`Fs` — サンプルレート
数値スカラー

`dt` — タイムステップ
duration スカラー | カレンダー期間スカラー

`t0` — 開始時間
datetime スカラー | duration スカラー

`TT` — 出力 timetable
timetable

tall 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。

C/C++ コード生成
MATLAB® Coder™ を使用して C および C++ コードを生成します。

スレッドベースの環境
MATLAB® の `backgroundPool` を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の `ThreadPool` を使用してコードを高速化します。

分散配列
Parallel Computing Toolbox™ を使用して、クラスターの結合メモリ上で大きなアレイを分割します。

R2021a: `'SamplingRate'` は削除予定