ドキュメンテーション

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

read

データ ストアのデータの読み取り

構文

data = read(ds)
[data,info] = read(ds)

説明

data = read(ds) は、データ ストアからデータを返します。後続の関数 read の呼び出しでは、前回の呼び出しの終点から読み取りが続行されます。

[data,info] = read(ds) は、抽出されたデータに関する情報 (メタデータを含む) も info で返します。

すべて折りたたむ

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

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

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

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

読み取り可能なデータがなくなるまで、データ ストアのデータを一度に 1 ブロックずつ読み取り、データを解析します。この例では、実際の経過時間の合計を求めます。

sumElapsedTime = 0;
while hasdata(ds)
    T = read(ds);
    sumElapsedTime = sumElapsedTime + sum(T.ActualElapsedTime);
end

実際の経過時間の合計を表示します。

sumElapsedTime
sumElapsedTime = 14531797

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

ds = datastore('mapredout.mat');

データ ストアのデータのサブセットを読み取ります。

T = read(ds)
T=1×2 table
    Key      Value 
    ____    _______

    'AA'    [14930]

データ ストアの ReadSize プロパティを変更して、一度に読み取るキーと値のペアの数を変更します。

ds.ReadSize = 5;

データ ストアから次の 5 組のキーと値のペアを読み取ります。

T = read(ds)
T=5×2 table
    Key      Value 
    ____    _______

    'AS'    [ 2910]
    'CO'    [ 8138]
    'DL'    [16578]
    'EA'    [  920]
    'HP'    [ 3660]

入力引数

すべて折りたたむ

入力データ ストア。関数 datastore を使用して、データから datastore オブジェクトを作成できます。

出力引数

すべて折りたたむ

出力データ。ds の種類に従ってテーブルまたは配列として返されます。

データ ストアの種類data のデータ型説明
TabularTextDatastoreSpreadsheetDatastoreテーブルテーブル変数は SelectedVariableNames プロパティにより決定されます。
ImageDatastore整数配列 整数配列の次元はイメージのタイプによって決まります。
  • グレースケール イメージの場合、data は m 行 n 列です。

  • トゥルーカラー イメージの場合、data は m x n x 3 です。

  • CMYK Tiff イメージの場合、data は m x n x 4 です。

ReadSize プロパティが 1 より大きい場合、data は各イメージに対応するイメージ データの cell 配列です。関数 read は、関数 imread でサポートされるすべてのイメージ タイプをサポートします。サポートされるイメージ タイプの詳細については、imread を参照してください。
KeyValueDatastoreテーブルテーブル変数名は KeyValue です。
FileDatastoreVaries出力は、'ReadFcn' 値で指定されるカスタム読み取り関数が返す出力と同じです。

読み取ったデータに関する情報。構造体配列として返されます。この構造体配列には、次のフィールドを含めることができます。

フィールド名データ ストアの種類説明
FilenameすべてFilename は、パス文字列、ファイル名、およびファイル拡張子を含む、完全に解決されたパスです。ReadSize プロパティが 1 より大きい ImageDatastore オブジェクトの場合、Filename は各イメージに対応するファイル名の cell 配列です。
FileSizeすべて

ファイルの合計サイズ (バイト単位)。MAT ファイルの場合、FileSize はファイル内のキーと値のペアの合計数です。ReadSize プロパティが 1 より大きい ImageDatastore オブジェクトの場合、FileSize は各イメージに対応するファイル サイズのベクトルです。

FileTypeKeyValueDatastore のみ

データを読み取るファイルの種類。MAT ファイルの場合は 'mat'、シーケンス ファイルの場合は 'seq' です。

LabelImageDatastore のみ

イメージのラベル名。ReadSize プロパティが 1 より大きい場合、Label は各イメージに対応するラベル名のベクトルです。Labels プロパティが空の場合、Label は空の cell 配列です。

NumCharactersReadTabularTextDatastore のみ

読み取られた文字数。

NumDataRowsSpreadsheetDatastore のみ

各シートから読み取った行数を含むベクトル。

OffsetKeyValueDatastore および TabularTextDatastore のみ

読み取り操作の開始位置 (バイト単位)。MAT ファイルの場合、Offset は読み取る最初のキーと値のインデックスになります。

SheetNamesSpreadsheetDatastore のみ

読み取ったシートの名前。

SheetNumbersSpreadsheetDatastore のみ

読み取ったシートに関連付けられている番号。

R2014b で導入