ドキュメンテーション

最新のリリースでは、このページがまだ翻訳されていません。 このページの最新版は英語でご覧になれます。

tall

構文

t = tall(ds)
t = tall(A)

説明

t = tall(ds) は、データ ストア ds に重なる tall 配列を作成します。

  • ds が表形式データのデータ ストアである場合 (これによりデータ ストアの read メソッドおよび readall メソッドが table を返します)、t は tall テーブルです。表形式データとは、各行に同数のエントリをもつ四角形の表として配置されたデータです。

  • それ以外の場合、t は tall cell 配列です。

t = tall(A) は、メモリ内配列 A を tall 配列に変換します。t の基となるデータ型は class(A) と同じです。

すべて折りたたむ

データ ストアを tall 配列に変換します。

最初にデータセットのデータ ストアを作成します。datastore(location) を使用して、データセットのファイルの場所を絶対パスまたは相対パスで指定してデータ ストアを作成できます。location 引数で以下を指定できます。

  • 'airlinesmall.csv' などの単一のファイル

  • '*.csv' などの同じ拡張子をもつ複数のファイル

  • 'C:\MyData' などのファイル フォルダー全体

また、datastore には、データ ストアの作成時にファイルおよびテキスト形式のプロパティを指定するオプションがいくつかあります。

airlinesmall.csv データセットのデータ ストアを作成します。'NA' の値を欠損データとして処理し、NaN 値と置き換えます。使用する変数の小さいサブセットを選択します。

varnames = {'ArrDelay', 'DepDelay', 'Origin', 'Dest'};
ds = datastore('airlinesmall.csv', 'TreatAsMissing', 'NA', ...
    'SelectedVariableNames', varnames);

tall を使用して、データ ストア内のデータの tall 配列を作成します。ds 内のデータが表形式であるため、結果は tall テーブルになります。データが表形式ではない場合、tall は代わりに tall cell 配列を作成します。

T = tall(ds)
T =

  Mx4 tall table

    ArrDelay    DepDelay    Origin    Dest 
    ________    ________    ______    _____

        8          12       'LAX'     'SJC'
        8           1       'SJC'     'BUR'
       21          20       'SAN'     'SMF'
       13          12       'BUR'     'SJC'
        4          -1       'SMF'     'LAX'
       59          63       'LAX'     'SJC'
        3          -2       'SAN'     'SFO'
       11          -1       'SEA'     'LAX'
       :           :          :         :
       :           :          :         :

多くの一般的な MATLAB® 演算子と関数を使用して、tall 配列を処理できます。サポートされている関数の一覧については、次を参照してください。

データ ストアを tall テーブルに変換し、遅延計算を使用してそのサイズを計算してから、計算を実行して結果をメモリに返します。

最初に airlinesmall.csv データセットのデータ ストアを作成します。'NA' の値を欠損データとして処理し、NaN 値と置き換えます。いくつかの列のテキスト形式を設定して、これらが文字ベクトルの cell 配列として読み取られるようにします。データ ストアを tall テーブルに変換します。

ds = datastore('airlinesmall.csv', 'TreatAsMissing', 'NA');
ds.SelectedFormats{strcmp(ds.SelectedVariableNames, 'TailNum')} = '%s';
ds.SelectedFormats{strcmp(ds.SelectedVariableNames, 'CancellationCode')} = '%s';
T = tall(ds)
T =

  Mx29 tall table

    Year    Month    DayofMonth    DayOfWeek    DepTime    CRSDepTime    ArrTime    CRSArrTime    UniqueCarrier    FlightNum    TailNum    ActualElapsedTime    CRSElapsedTime    AirTime    ArrDelay    DepDelay    Origin    Dest     Distance    TaxiIn    TaxiOut    Cancelled    CancellationCode    Diverted    CarrierDelay    WeatherDelay    NASDelay    SecurityDelay    LateAircraftDelay
    ____    _____    __________    _________    _______    __________    _______    __________    _____________    _________    _______    _________________    ______________    _______    ________    ________    ______    _____    ________    ______    _______    _________    ________________    ________    ____________    ____________    ________    _____________    _________________

    1987     10          21            3          642          630         735          727           'PS'           1503        'NA'              53                 57            NaN          8          12       'LAX'     'SJC'      308        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          26            1         1021         1020        1124         1116           'PS'           1550        'NA'              63                 56            NaN          8           1       'SJC'     'BUR'      296        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          23            5         2055         2035        2218         2157           'PS'           1589        'NA'              83                 82            NaN         21          20       'SAN'     'SMF'      480        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          23            5         1332         1320        1431         1418           'PS'           1655        'NA'              59                 58            NaN         13          12       'BUR'     'SJC'      296        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          22            4          629          630         746          742           'PS'           1702        'NA'              77                 72            NaN          4          -1       'SMF'     'LAX'      373        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          28            3         1446         1343        1547         1448           'PS'           1729        'NA'              61                 65            NaN         59          63       'LAX'     'SJC'      308        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10           8            4          928          930        1052         1049           'PS'           1763        'NA'              84                 79            NaN          3          -2       'SAN'     'SFO'      447        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
    1987     10          10            6          859          900        1134         1123           'PS'           1800        'NA'             155                143            NaN         11          -1       'SEA'     'LAX'      954        NaN        NaN          0              'NA'             0            NaN             NaN           NaN            NaN                NaN       
     :        :          :             :           :           :            :           :               :              :           :               :                  :              :          :           :          :         :         :          :          :           :               :               :             :               :             :              :                  :
     :        :          :             :           :           :            :           :               :              :           :               :                  :              :          :           :          :         :         :          :          :           :               :               :             :               :             :              :                  :

tall テーブルの表示は、MATLAB® で table 内にあるデータ行の数が判別していないことを示しています。

tall テーブルのサイズを計算します。tall 配列のサイズの計算では、データを完全に通す必要があるため、MATLAB では値が即座には計算されません。代わりに、tall 配列の多くの操作と同様に、値とサイズが現在不明である未評価の tall 配列が結果になります。

s = size(T)
s =

  1x2 tall double row vector

    ?    ?

関数 gather を使用して、遅延計算を実行して結果をメモリに返します。size で返される結果は非常に小さい 1 行 2 列のベクトルで、メモリに収まります。

sz = gather(s)
Evaluating tall expression using the Local MATLAB Session:
- Pass 1 of 1: Completed in 1.3 sec
Evaluation completed in 1.6 sec
sz = 1×2

      123523          29

gather を縮小されていない tall 配列に対して使用すると、結果がメモリに収まらない場合があります。gather で返される結果がメモリに収まるかどうかが不明な場合、gather(head(X)) または gather(tail(X)) を使用して、計算結果のごく一部だけをメモリに返します。

乱数のメモリ内配列を作成し、tall 配列に変換します。メモリ内配列から tall 配列を作成すると、新しいプログラムのデバッグやプロトタイピングに役立ちます。

A = rand(100,4);
tA = tall(A)
tA =

  100x4 tall double matrix

    0.8147    0.1622    0.6443    0.0596
    0.9058    0.7943    0.3786    0.6820
    0.1270    0.3112    0.8116    0.0424
    0.9134    0.5285    0.5328    0.0714
    0.6324    0.1656    0.3507    0.5216
    0.0975    0.6020    0.9390    0.0967
    0.2785    0.2630    0.8759    0.8181
    0.5469    0.6541    0.5502    0.8175
      :         :         :         :
      :         :         :         :

入力引数

すべて折りたたむ

入力データ ストア。datastore オブジェクトとして指定します。関数 datastore を使用してデータセットに datastore オブジェクトを作成します。

tall 配列で使用できるのは確定的なデータ ストアのみです。つまり、データ ストアで read を使用する場合、reset を使用してデータ ストアをリセットしてから、データ ストアを再度読み込みます。返されるデータはどちらの場合も同じでなければなりません。確定的でないデータ ストアが含まれる tall 配列の計算では、予測できない結果が生じる可能性があります。詳細については、ファイル形式またはアプリケーション用のデータ ストアの選択を参照してください。

例: ds = datastore('airlinesmall.csv') は単一のファイルを指定します。

例: ds = datastore('*.csv').csv ファイルの集合を指定します。

例: ds = datastore('C:\MyData') はファイルのフォルダーを指定します。

例: ds = datastore('hdfs:///data/') は HDFS ファイル システム内のデータセットを指定します。

メモリ内変数。配列として指定します。

データ型: single | double | int8 | int16 | int32 | int64 | uint8 | uint16 | uint32 | uint64 | logical | table | string | cell | categorical | datetime | duration | calendarDuration
複素数のサポート: あり

出力引数

すべて折りたたむ

tall 配列。

  • データ ストアを変換する場合、t は表形式データ ストアの tall テーブルです。それ以外の場合、t は tall cell 配列です。

  • メモリ内配列を変換する場合、t の基となるデータ型は class(A) と同じです。

ヒント

  • 以下で tall 配列を使用する方法については、他の製品による tall 配列の拡張を参照してください。

    • Statistics and Machine Learning Toolbox™

    • Parallel Computing Toolbox™

    • MATLAB® Distributed Computing Server™

    • Database Toolbox™

    • MATLAB Compiler™

拡張機能

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

R2016b で導入