Main Content

このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。

readall

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

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

構文

data = readall(ds)
data = readall(ds,UseParallel=tf)

説明

例

data = readall(ds) は、ds で指定されたデータストアのすべてのデータを返します。データストアのすべてのデータがメモリに収まらない場合、readall はエラーを返します。

例

data = readall(ds,UseParallel=tf) は、tf が true の場合、データを並列で読み取ります (Parallel Computing Toolbox™ が必要です)。

例

すべて折りたたむ

ライブ スクリプトを開く

4 つのイメージを含む ImageDatastore オブジェクトを作成します。

imds = imageDatastore({'street1.jpg','street2.jpg','peppers.png','corn.tif'});

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

T = readall(imds);

出力を調べます。

imout = imtile(T);
imshow(imout)

Figure contains an axes object. The axes object contains an object of type image.

ライブ スクリプトを開く

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

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

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

ds.SelectedVariableNames = ["DepTime","ArrTime","ActualElapsedTime"];

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

T = readall(ds,UseParallel=true);

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.
ライブ スクリプトを開く

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

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

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

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

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

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

imdsCombined = combine(imds1,imds2);

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

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

入力引数

すべて折りたたむ

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

並列での読み取り。true または false として指定します。true を指定すると、readall はデータストアからすべてのデータを並列で読み取ります (Parallel Computing Toolbox が必要です)。並列読み取りにより、特にリモート データについて、データを読み取る際のパフォーマンスが向上する場合があります。

  • UseParallel プロパティと Parallel Computing Toolbox により、データストアの処理を改善できます。readall は、スレッドベースの並列プールなどのオーバーヘッドが少ない計算環境を使用して、サポートされるデータストアをローカル マシンで高速に読み取ります。スレッドベースの並列プールの詳細については、parpool (Parallel Computing Toolbox) を参照してください。

  • MATLAB ワーカーに基づく並列処理を使用しない場合は、特定のデータストア (imageDatastore など) について、MATLAB の組み込みのマルチスレッド機能によってローカル マシンで高速に処理されます。詳細については、MATLAB Multicore を参照してください。

例: readall(ds,UseParallel=true)

出力引数

すべて折りたたむ

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

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

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

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

SequentialDatastore場合により異なる基となるデータストアのすべてのデータを垂直方向に連結した結果が出力されます。基となるデータストアがすべて空である場合、最初の基となるデータストアに基づき、空の型が出力されます。基となるデータストアがない場合、空の double が出力されます。

拡張機能

バージョン履歴

R2014b で導入

参考

| |