メインコンテンツ

readByIndex

インデックスで指定されたデータを augmentedImageDatastore から読み取る

説明

data = readByIndex(auimds,ind) は、拡張イメージ データストア auimds から観測値のサブセットを返します。目的の観測値はインデックス ind で指定されます。

[data,info] = readByIndex(auimds,ind) は、メタデータを含む観測値に関する情報も info に返します。

すべて折りたたむ

サンプル データを読み込みます。サンプル データは、手書き数字の合成イメージで構成されています。XTrain は 28×28×1×5000 の配列です。ここで、以下のようになります。

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

  • 1 はチャネルの数。

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

load DigitsDataTrain

サイズ変更、回転、平行移動、反転など、イメージ拡張の前処理オプションを指定する imageDataAugmenter オブジェクトを作成します。イメージを、水平方向および垂直方向に最大 3 ピクセルまでのランダムな平行移動をさせたり、最大 20 度までの回転をさせたりします。

imageAugmenter = imageDataAugmenter( ...
    RandRotation=[-20,20], ...
    RandXTranslation=[-3 3], ...
    RandYTranslation=[-3 3]);

拡張されたイメージ データを使用して augmentedImageDatastore を作成します。たとえば、trainnet 関数を使用してネットワークに学習させているときにデータストアから読み取りを行うと、データストアはイメージの拡張を実行し、イメージのサイズを変更します。データストアは、イメージをメモリに保存せずにイメージを拡張します。

imageSize = [64 64 1];
augimds = augmentedImageDatastore(imageSize,XTrain,labelsTrain,DataAugmentation=imageAugmenter);

データストアから最後の 9 つのイメージを読み取ります。

numObservations = augimds.NumObservations;
imagesToRead = numObservations-8:numObservations
imagesToRead = 1×9

        4992        4993        4994        4995        4996        4997        4998        4999        5000

minibatch = readByIndex(augimds,imagesToRead)
minibatch=9×2 table
        input         response
    ______________    ________

    {64×64 single}       2    
    {64×64 single}       3    
    {64×64 single}       9    
    {64×64 single}       9    
    {64×64 single}       8    
    {64×64 single}       9    
    {64×64 single}       8    
    {64×64 single}       9    
    {64×64 single}       3    

拡張されたイメージを表示します。

imshow(imtile(minibatch.input));

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

入力引数

すべて折りたたむ

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

観測値のインデックス。正の整数のベクトルとして指定します。

出力引数

すべて折りたたむ

データストアからの観測値。length(ind) 行数を含む table として返されます。

読み取りデータに関する情報。次のフィールドをもつ構造体配列として返されます。

フィールド名説明
MiniBatchIndicesインデックスの数値ベクトル。

バージョン履歴

R2018a で導入