augmentedImageSource

(削除予定) 拡張イメージ データのバッチの生成

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

augmentedImageSource は将来のリリースで削除される予定です。代わりに、関数 augmentedImageDatastore を使用して拡張イメージ データストアを作成してください。詳細については、バージョン履歴を参照してください。

構文

auimds = augmentedImageSource(outputSize,imds)
auimds = augmentedImageSource(outputSize,X,Y)
auimds = augmentedImageSource(outputSize,tbl)
auimds = augmentedImageSource(outputSize,tbl,responseNames)
auimds = augmentedImageSource(___,Name,Value)

説明

auimds = augmentedImageSource(outputSize,imds) は、イメージ データストア imds のイメージを使用して、出力イメージ サイズ outputSize で、分類問題用の拡張イメージ データストア auimds を作成します。

auimds = augmentedImageSource(outputSize,X,Y) は、分類問題および回帰問題用の拡張イメージ データストアを作成します。配列 X には予測子変数が含まれ、配列 Y にはカテゴリカル ラベルまたは数値応答が含まれます。

auimds = augmentedImageSource(outputSize,tbl) は、分類問題および回帰問題用の拡張イメージ データストアを作成します。テーブル tbl には、予測子と応答が含まれます。

auimds = augmentedImageSource(outputSize,tbl,responseNames) は、分類問題および回帰問題用の拡張イメージ データストアを作成します。テーブル tbl には、予測子と応答が含まれます。引数 responseNames は、tbl の応答変数を指定します。

auimds = augmentedImageSource(___,Name,Value) は、拡張イメージ データストアによって実行されるイメージの前処理を構成する名前と値のペアを使用して、拡張イメージ データストアを作成します。複数の名前と値のペアを指定できます。

例

例

すべて折りたたむ

この例では、関数 augmentedImageSource を使用して拡張イメージ データストア オブジェクトを作成します。関数 augmentedImageDatastore を使用して拡張イメージ データストア オブジェクトを作成する推奨ワークフローの例については、拡張イメージを使用したネットワークの学習を参照してください。

サンプル データを読み込みます。サンプル データは、手書き数字の合成イメージで構成されています。

[XTrain,YTrain] = digitTrain4DArrayData;

digitTrain4DArrayData は、数字の学習セットを 4 次元配列データとして読み込みます。XTrain は、28 x 28 x 1 x 5000 の配列です。

  • 28 はイメージの高さと幅。

  • 1 はチャネルの数。

  • 5000 は手書き数字の合成イメージの数。

YTrain は、各観測値のラベルが含まれる categorical ベクトルです。

学習中にイメージを回転させるイメージ オーグメンターを作成します。このイメージ オーグメンターは、ランダムな角度で各イメージを回転させます。

imageAugmenter = imageDataAugmenter('RandRotation',[-180 180])
imageAugmenter = 
  imageDataAugmenter with properties:

           FillValue: 0
     RandXReflection: 0
     RandYReflection: 0
        RandRotation: [-180 180]
           RandScale: [1 1]
          RandXScale: [1 1]
          RandYScale: [1 1]
          RandXShear: [0 0]
          RandYShear: [0 0]
    RandXTranslation: [0 0]
    RandYTranslation: [0 0]

関数 augmentedImageSource を使用して拡張イメージ データストアを作成します。拡張イメージのサイズ、学習データ、およびイメージ オーグメンターを指定します。

imageSize = [28 28 1];
auimds = augmentedImageSource(imageSize,XTrain,YTrain,'DataAugmentation',imageAugmenter)
auimds = 
  augmentedImageDatastore with properties:

         NumObservations: 5000
           MiniBatchSize: 128
        DataAugmentation: [1x1 imageDataAugmenter]
      ColorPreprocessing: 'none'
              OutputSize: [28 28]
          OutputSizeMode: 'resize'
    DispatchInBackground: 0

入力引数

すべて折りたたむ

出力イメージのサイズ。2 つの正の整数のベクトルとして指定します。最初の要素は出力イメージの行数、2 番目の要素は列数を指定します。この値は、返される拡張イメージ データストア auimds の OutputSize プロパティを設定します。

イメージ データストア。ImageDatastore オブジェクトとして指定します。

イメージ。4 次元数値配列として指定します。最初の 3 つの次元は高さ、幅、およびチャネルであり、最後の次元は個々のイメージにインデックスを付けます。

データ型: single | double | uint8 | int8 | uint16 | int16 | uint32 | int32

分類または回帰の応答。次のいずれかに指定します。

  • 分類問題で、Y がイメージ ラベルを含む categorical ベクトル。

  • 回帰問題では、Y は次のいずれかになる。

    • n 行 r 列の数値行列。n は観測値の数、r は応答の数です。

    • h x w x c x n の数値配列。h x w x c は 1 つの応答のサイズ、n は観測値の数です。

応答に NaN が含まれていてはなりません。

データ型: categorical | double

入力データ。テーブルとして指定します。tbl は、最初の列に予測子を、絶対イメージ パス、相対イメージ パス、あるいはイメージとして含まなければなりません。応答の型と場所は、問題によって異なります。

  • 分類問題では、応答はイメージのラベルを含むカテゴリカル変数でなければなりません。augmentedImageSource を呼び出すときに応答変数の名前が指定されていない場合、応答は 2 列目に含まれていなければなりません。tbl の異なる列に応答が含まれている場合、引数 responseNames を使用して応答変数名を指定しなければなりません。

  • 回帰問題では、応答は数値であり、最初の列より後の列に含まれなければなりません。応答は、スカラーとして複数の列に、あるいは数値ベクトルまたは 3 次元数値配列が含まれる cell 配列として 1 つの列に含めることができます。応答変数の名前を指定しない場合、augmentedImageSource は tbl の残りの列を応答変数として受け入れます。引数 responseNames を使用して応答変数名を指定できます。

応答に NaN の値が含まれていてはなりません。予測子データに NaN が含まれる場合、学習全体に伝播されますが、ほとんどの場合に学習が収束しなくなります。

データ型: table

入力テーブルの応答変数の名前。次のいずれかとして指定します。

  • 1 つの応答をもつ分類または回帰タスクの場合、responseNames は、入力テーブルに応答変数が格納された文字ベクトルまたは string スカラーでなければなりません。

    複数の応答をもつ回帰タスクの場合、responseNames は、入力テーブルに応答変数が格納された string 配列または文字ベクトルの cell 配列でなければなりません。

データ型: char | cell | string

名前と値の引数

すべて折りたたむ

オプションの引数のペアを Name1=Value1,...,NameN=ValueN として指定します。ここで、Name は引数名で、Value は対応する値です。名前と値の引数は他の引数の後に指定しなければなりませんが、ペアの順序は重要ではありません。

R2021a より前では、コンマを使用して名前と値をそれぞれ区切り、Name を引用符で囲みます。

例: augmentedImageSource([28,28],myTable,'OutputSizeMode','centercrop') は、中心からのイメージのトリミングを OutputSizeMode プロパティに設定した、拡張イメージ データストアを作成します。

入力イメージのカラー チャネルに対して実行される前処理演算。'none'、'gray2rgb'、または 'rgb2gray' として指定します。この引数は、返される拡張イメージ データストア auimds の ColorPreprocessing プロパティを設定します。ColorPreprocessing プロパティは、拡張イメージ データストアからのすべての出力イメージが inputImageLayer に必要な数のカラー チャネルを持つようにします。

入力イメージに適用される前処理。imageDataAugmenter オブジェクトまたは 'none' として指定します。この引数は、返される拡張イメージ データストア auimds の DataAugmentation プロパティを設定します。DataAugmentation が 'none' である場合、入力イメージには前処理が適用されません。

出力イメージのサイズ変更に使用するメソッド。次のいずれかに指定します。この引数は、返される拡張イメージ データストア auimds の OutputSizeMode プロパティを設定します。

  • 'resize' — 出力サイズに当てはまるようにイメージをスケーリングします。詳細については、imresize を参照してください。

  • 'centercrop' — 学習イメージの中心からトリミングします。トリミングのサイズは、出力サイズと同じです。

  • 'randcrop' — 学習イメージからランダムにトリミングします。ランダムなトリミングのサイズは、出力サイズと同じです。

データ型: char | string

拡張の並列実行。false または true として指定します。この引数は、返される拡張イメージ データストア auimds の DispatchInBackground プロパティを設定します。'BackgroundExecution' が true であり、Parallel Computing Toolbox™ ソフトウェアをインストール済みの場合、拡張イメージ データストア auimds はイメージの拡張を並列実行します。

出力引数

すべて折りたたむ

拡張イメージ データストア。augmentedImageDatastore オブジェクトとして返されます。

バージョン履歴

R2017b で導入

すべて展開する

参考