array2timetable

同種配列の timetable への変換

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

構文

TT = array2timetable(X,'RowTimes',rowTimes)

TT = array2timetable(X,'SampleRate',Fs)

TT = array2timetable(X,'TimeStep',dt)

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

T = array2timetable(X,Name,Value)

説明

TT = array2timetable(X,'RowTimes',rowTimes) は入力配列を timetable に変換します。入力配列 X は M 行 N 列の配列であり、ベクトル rowTimes は datetime 値または duration 値の M 行 1 列のベクトルです。X の各列は TT の 1 つの変数になります。rowTimes の時間値が timetable の行にラベル付けされます。TT は M 行 N 列の timetable です。

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

例

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

例

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

例

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

例

T = array2timetable(X,Name,Value) は、1 つ以上の Name,Value ペアの引数で指定された追加のオプションを使用して、配列 X から timetable を作成します。

たとえば、timetable に含める変数名を指定できます。

例

すべて折りたたむ

配列から timetable への変換

ライブスクリプトを開く

配列を timetable に変換します。期間のベクトルを行時間として追加します。

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

timetable のサイズを返します。TT には 5 行と 3 つの変数が含まれます。行時間のセットが 1 つのテーブルプロパティです。行時間は、テーブル変数に含まれません。

size(TT)

ans = 1×2

     5     3

サンプルレートの指定

ライブスクリプトを開く

サンプルレート 500 Hz を指定し、配列を timetable に変換します。

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 秒のタイムステップを指定し、配列を timetable に変換します。

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

変数名の指定

ライブスクリプトを開く

配列を timetable に変換します。行時間を datetime ベクトルとして指定します。timetable の変数名を指定します。

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

入力引数

すべて折りたたむ

`X` — 入力行列
行列

入力行列。

`rowTimes` — timetable の行に関連付けられた時間
datetime ベクトル | duration ベクトル

timetable の行に関連付けられた時間。datetime ベクトルまたは duration ベクトルとして指定します。各時間は、出力 timetable の行にラベルを付けます。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

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: TT = array2timetable(X,'RowTimes',Time,'VariableNames',{'Latitude','Longitude'}) は、入力配列 X から Time で指定された行時間で timetable を作成し、対応する timetable 変数の名前を Latitude および Longitude に設定します。

`VariableNames` — 変数名
文字ベクトルの cell 配列 | string 配列

変数名。要素が空ではない一意の文字ベクトルの cell 配列または string 配列として指定します。変数名の数は、入力配列の列数と等しくなければなりません。

変数名には、スペースや非 ASCII 文字を含め、どんな Unicode^® 文字でも使用することができます。ただし、変数名は、table の次元名や予約名 'Properties'、'RowNames'、'VariableNames'、または ':' と同じであってはなりません。

`DimensionNames` — 次元名
文字ベクトルの 2 要素 cell 配列 | 2 要素 string 配列

R2021a 以降

次元名。要素が空ではない一意の文字ベクトルの 2 要素 cell 配列または 2 要素 string 配列として指定します。

次元名には、スペース、非 ASCII 文字を含む任意の Unicode 文字を使用できます。ただし、次元名は、table 変数名や予約名 'Properties'、'RowNames'、'VariableNames'、または ':' と同じであってはなりません。

代わりに、すべてのリリースで、table の DimensionNames プロパティを設定することで次元名を指定できます。

出力引数

すべて折りたたむ

`TT` — 出力 timetable
timetable

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

ヒント

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

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

TT =

  3×1 timetable

       Time        X
    ___________    _

    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 配列
メモリの許容量を超えるような多数の行を含む配列を計算します。

array2timetable 関数は tall 配列を完全にサポートしています。詳細については、tall 配列を参照してください。

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

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

生成されたコードでは、この関数を使用する際に名前と値のペアの引数 'VariableNames' を指定しなければなりません。
'SampleRate'、'TimeStep'、または 'StartTime' の名前と値のペア引数を使用して規則的な行時間を指定する場合、行時間を規則的にするにはコンパイル時に値は定数でなければなりません。そうしない場合、行時間は生成されたコードで不規則であると見なされます。

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

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

バージョン履歴

R2016b で導入

すべて展開する

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

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

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

R2019b: 変数名の先頭と末尾には空白文字を含めることが可能

先頭または末尾に空白文字を含む table および timetable の変数名は変更されません。

以前のリリースでは、名前と値のペアの引数 'VariableNames' を使用して指定した場合や、VariableNames プロパティに割り当てた場合、変数名から先頭と末尾の空白文字が削除されていました。

そのような文字を手動で削除するには、まず名前に関数 strtrim を使用してから、変数名として table または timetable に割り当てます。

参考

table2timetable | timetable | isvarname | summary | uitable

array2timetable

構文

説明

例

配列から timetable への変換

サンプル レートの指定

タイム ステップの指定

開始時間の指定

変数名の指定

入力引数

X — 入力行列 行列

rowTimes — timetable の行に関連付けられた時間 datetime ベクトル | duration ベクトル

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

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

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

名前と値の引数

VariableNames — 変数名 文字ベクトルの cell 配列 | string 配列

DimensionNames — 次元名 文字ベクトルの 2 要素 cell 配列 | 2 要素 string 配列

出力引数

TT — 出力 timetable timetable

ヒント

拡張機能

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

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

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

バージョン履歴

R2021a: 'SamplingRate' は削除予定

R2019b: 変数名の先頭と末尾には空白文字を含めることが可能

参考

トピック

サンプルレートの指定

タイムステップの指定

`X` — 入力行列
行列

`rowTimes` — timetable の行に関連付けられた時間
datetime ベクトル | duration ベクトル

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

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

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

`VariableNames` — 変数名
文字ベクトルの cell 配列 | string 配列

`DimensionNames` — 次元名
文字ベクトルの 2 要素 cell 配列 | 2 要素 string 配列

`TT` — 出力 timetable
timetable

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

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

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

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