read

randomPatchExtractionDatastore からデータを読み取る

構文

data = read(patchds)

[data,info] = read(patchds)

data = read(patchds) は、ランダムパッチ抽出データストア patchds からデータのバッチを返します。関数 read の後続の呼び出しでは、直前の呼び出しのエンドポイントから引き続き読み取ります。

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

ランダムパッチ抽出データストア。randomPatchExtractionDatastore オブジェクトとして指定します。データストアは、各バッチの観測値の MiniBatchSize 数および観測値の合計数 numObservations を指定します。

出力データ。MiniBatchSize 行数を含むテーブルとして返されます。

最初の変数は InputImage であり、入力イメージパッチが含まれます。
ネットワーク応答がイメージデータストア内のイメージである場合、2 番目の変数は ResponseImage になります。
ネットワーク応答がピクセルラベルデータストア内のピクセルラベルイメージである場合、2 番目の変数は ResponsePixelLabelImage になります。

各列には、PatchSize とイメージデータのタイプによって決まるサイズのパッチの cell 配列が含まれています。

2 次元シングルチャネルイメージの場合、パッチのサイズは m 行 n 列であり、m はパッチ内の行数を指定し、n は列数を指定します。
2 次元マルチチャネルイメージの場合、パッチのサイズは m x n x c であり、c はパッチ内のカラーチャネル数を指定します。RGB イメージの場合、c は 3 です。
3 次元シングルチャネルボリュームイメージの場合、パッチのサイズは m x n x p であり、p はボリュームの平面の数を指定します。

データストア patchds のデータの最終バッチでは、numObservations が MiniBatchSize できれいに割り切れない場合、read はデータストアに残っているすべての観測値を含む部分バッチを返します。

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

フィールド名	説明
`RandomPatchRectangles`	`MiniBatchSize` 行 4 列の数値行列。各行は、[xywidthheight] の形式でパッチのサイズと位置を指定します。各要素は、パッチの左上隅の x と y 座標、幅と高さで定義されます。
`ImageIndices`	入力データストアの読み取りイメージのインデックスを指定する `MiniBatchSize` 行 1 列の数値ベクトル。
`InputImageFilename`	各入力イメージのパス文字列、ファイル名およびファイル拡張子を含む完全解決済みパスを指定する `MiniBatchSize` 行 1 列の cell 配列。
`ResponseImageFilename`	各応答イメージまたは各ピクセルラベルイメージのパス文字列、ファイル名およびファイル拡張子を含む完全解決済みパスを指定する `MiniBatchSize` 行 1 列の cell 配列。

R2018b で導入