ドキュメンテーション

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

readall

データ ストアのすべてのデータの読み取り

説明

data = readall(ds) は、ds で指定されたデータ ストアのすべてのデータを返します。

データ ストアのすべてのデータがメモリに収まらない場合、readall はエラーを返します。

すべて折りたたむ

表形式データが格納されたサンプル ファイル airlinesmall.csv からデータ ストアを作成します。

ds = tabularTextDatastore('airlinesmall.csv','TreatAsMissing','NA');

SelectedVariableNames プロパティを変更して対象の変数を指定します。

ds.SelectedVariableNames = {'DepTime','ArrTime','ActualElapsedTime'};

データ ストアのすべてのデータを読み取ります。

T = readall(ds);

readall により、すべてのデータが table に返されます。

テーブルに関する情報を表示します。

T.Properties
ans = 
  TableProperties with properties:

             Description: ''
                UserData: []
          DimensionNames: {'Row'  'Variables'}
           VariableNames: {'DepTime'  'ArrTime'  'ActualElapsedTime'}
    VariableDescriptions: {}
           VariableUnits: {}
      VariableContinuity: []
                RowNames: {}
        CustomProperties: No custom properties are set.
      Use addprop and rmprop to modify CustomProperties.

出力テーブルの概要を表示します。

summary(T)
Variables:

    DepTime: 123523x1 double

        Values:

            Min             1      
            Median          1335   
            Max             2505   
            NumMissing      2351   

    ArrTime: 123523x1 double

        Values:

            Min             1      
            Median          1522   
            Max             2608   
            NumMissing      2656   

    ActualElapsedTime: 123523x1 double

        Values:

            Min                  11          
            Median               102         
            Max                  1650        
            NumMissing           2657        

関数 mapreduce の出力ファイルであるサンプル ファイル mapredout.mat からデータ ストアを作成します。

ds = datastore('mapredout.mat');

データ ストアのすべてのデータを読み取ります。

T = readall(ds);

出力テーブルの概要を表示します。

summary(T)
Variables:

    Key: 29x1 cell array of character vectors

    Value: 29x1 cell

基となるデータ ストアのイメージ ペア間のパリティを維持するデータ ストアを作成します。たとえば、2 つのイメージ データ ストアを個別に作成してから、基となる 2 つのデータ ストアを表す統合データ ストアを作成します。

3 つのイメージの集合を表すイメージ データ ストア imds1 を作成します。

imds1 = imageDatastore({'street1.jpg','street2.jpg','peppers.png'}); 

imds1 のイメージをグレースケールに変換してから縮小して、2 番目のデータ ストア imds2 を作成します。

imds2 = transform(imds1,@(x) imresize(rgb2gray(x),0.5));

imds1imds2 から統合データ ストアを作成します。

imdsCombined = combine(imds1,imds2);

統合データ ストアからすべてのデータを読み取ります。出力は 3 行 2 列の cell 配列です。2 つの列は、それぞれ基となる 2 つのデータ ストア imds1 および imds2 から読み取ったすべてのデータを表します。

dataOut = readall(imdsCombined)
dataOut = 3x2 cell array
    {480x640x3 uint8}    {240x320 uint8}
    {480x640x3 uint8}    {240x320 uint8}
    {384x512x3 uint8}    {192x256 uint8}

入力引数

すべて折りたたむ

入力データ ストア。次のデータ ストアを readall メソッドの入力として使用できます。

出力引数

すべて折りたたむ

データ ストア内のすべてのデータ。ds のタイプに応じて table または cell 配列として返されます。

データ ストアの種類data のデータ型説明
TabularTextDatastoreSpreadsheetDatastoreテーブルテーブル変数は SelectedVariableNames プロパティにより決定されます。
ImageDatastorecell 配列 cell 配列の各要素には、1 つのイメージのイメージ データが格納されます。関数 readall は、関数 imread でサポートされるすべてのイメージ タイプをサポートします。サポートされるイメージ タイプの詳細については、imread を参照してください。
KeyValueDatastoreテーブルテーブル変数名は KeyValue です。
FileDatastorecell 配列cell 配列の各要素には、ReadFcn プロパティで指定されたカスタム読み取り関数を使用して 1 つのファイルから読み取られたデータが格納されます。
TransformedDatastoreVaries出力は、UnderlyingDatastore プロパティで指定された、基となるデータ ストアが返す出力と同じです。たとえば、基となるデータ ストアがイメージ データ ストアである場合、data は cell 配列として返され、cell 配列の各要素には 1 つのイメージのイメージ データが格納されます。
CombinedDatastorecell 配列

cell 配列の各要素には、UnderlyingDatastores プロパティで指定された、対応する基のデータ ストアに対して readall を呼び出した結果が格納されます。

基となるデータ ストア内にあるデータのサブセット数が異なる場合、readall は、基となるデータ ストアすべてにデータがあるときのデータのみを返します。たとえば、統合データ ストアには基となる 2 つのデータ ストアがあり、一方のデータのサブセットが m 個、他方のデータのサブセットが n 個で、m > n であるとします。出力は、n 行 2 列の cell 配列になります。

R2014b で導入