subset

データストアまたはファイルセットのサブセットを作成

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

構文

subds = subset(ds,indices)

説明

例

subds = subset(ds,indices) は、indices に対応するファイルを含むサブセットを返します。サブセット subds のタイプは、入力と同じになります。

入力 ds がデータストアの場合、出力 outds は同じタイプのデータストア。
入力 ds が DsFileSet、FileSet または BlockedFileSet オブジェクトの場合、出力 subds もそれぞれ DsFileSet、FileSet または BlockedFileSet オブジェクト。

例

すべて折りたたむ

`ImageDatastore` のサブセットを作成

イメージの datastore オブジェクトを作成してから、そのイメージデータストアのサブセットを作成します。

サンプルフォルダー内のすべてのイメージファイル用のイメージデータストア imds を作成します。次に、imds の Files プロパティを表示します。

folders = fullfile(matlabroot,'toolbox','matlab',{'demos','imagesci'});
exts = {'.jpg','.png','.tif'};
imds = imageDatastore(folders,'LabelSource','foldernames','FileExtensions',exts);
imds.Files

ans =

  8×1 cell array

    {'...\matlab\toolbox\matlab\demos\cloudCombined.jpg'}
    {'...\matlab\toolbox\matlab\demos\example.tif'      }
    {'...\matlab\toolbox\matlab\demos\landOcean.jpg'    }
    {'...\matlab\toolbox\matlab\demos\ngc6543a.jpg'     }
    {'...\matlab\toolbox\matlab\demos\street1.jpg'      }
    {'...\matlab\toolbox\matlab\demos\street2.jpg'      }
    {'...\matlab\toolbox\matlab\imagesci\corn.tif'      }
    {'...\matlab\toolbox\matlab\imagesci\peppers.png'   }

imds の最初の 4 つのファイルを含むサブセットデータストア subimds を作成し、subimds の Files プロパティを確認します。

indices = 1:4; 
subimds = subset(imds,indices); 
subimds.Files

ans =

  4×1 cell array

    {'...\matlab\toolbox\matlab\demos\cloudCombined.jpg'}
    {'...\matlab\toolbox\matlab\demos\example.tif'      }
    {'...\matlab\toolbox\matlab\demos\landOcean.jpg'    }
    {'...\matlab\toolbox\matlab\demos\ngc6543a.jpg'     }

ランダムに選択したファイルを含むサブセットデータストアを作成

イメージデータストアを作成してから、元のデータストアから指定の割合でランダムに選択されたファイルのみを含むサブセットデータストアを作成します。

サンプルフォルダー内のすべてのイメージファイル用に imageDatastore を作成し、Files プロパティを表示します。このデータストアには 8 つのファイルが含まれています。

folders = fullfile(matlabroot,'toolbox','matlab',{'demos','imagesci'});
exts = {'.jpg','.png','.tif'};
imds = imageDatastore(folders,'LabelSource','foldernames','FileExtensions',exts);
imds.Files

ans =

  8×1 cell array

    {'...\matlab\toolbox\matlab\demos\cloudCombined.jpg'}
    {'...\matlab\toolbox\matlab\demos\example.tif'      }
    {'...\matlab\toolbox\matlab\demos\landOcean.jpg'    }
    {'...\matlab\toolbox\matlab\demos\ngc6543a.jpg'     }
    {'...\matlab\toolbox\matlab\demos\street1.jpg'      }
    {'...\matlab\toolbox\matlab\demos\street2.jpg'      }
    {'...\matlab\toolbox\matlab\imagesci\corn.tif'      }
    {'...\matlab\toolbox\matlab\imagesci\peppers.png'   }

ファイルの 60% を含み、ランダムに選択されたサブセットを表すインデックスのセットを作成します。

nFiles = length(imds.Files);
RandIndices = randperm(nFiles);
nSixtyPercent = round(0.6*nFiles);
indices = RandIndices(1:nSixtyPercent)

indices =

     8     6     4     5     1

indices を使用してサブセットデータストア submids を作成し、その Files プロパティを確認します。

subimds = subset(imds,indices); 
subimds.Files

ans =

  5×1 cell array

    {'...\matlab\toolbox\matlab\imagesci\peppers.png'   }
    {'...\matlab\toolbox\matlab\demos\street2.jpg'      }
    {'...\matlab\toolbox\matlab\demos\ngc6543a.jpg'     }
    {'...\matlab\toolbox\matlab\demos\street1.jpg'      }
    {'...\matlab\toolbox\matlab\demos\cloudCombined.jpg'}

入力引数

すべて折りたたむ

`ds` — 入力のデータストアまたはファイルセット
`ImageDatastore` | `DsFileSet` | `FileSet` | `BlockedFileSet`

入力のデータストアまたはファイルセット。ImageDatastore、DsFileSet、FileSet または BlockedFileSet オブジェクトとして指定します。

ImageDatastore オブジェクトを作成するには、imageDatastore を使用。
DsFileSet オブジェクトを作成するには、matlab.io.datastore.DsFileSet を使用。
FileSet オブジェクトを作成するには、matlab.io.datastore.FileSet を使用。
BlockedFileSet オブジェクトを作成するには、matlab.io.datastore.BlockedFileSet を使用。

`indices` — サブセットに含めるファイルのインデックス
インデックスのベクトル | 論理ベクトル

サブセットに含めるファイルのインデックス。インデックスのベクトルまたは logical ベクトルとして指定します。

インデックスのベクトルには、サブセット subds に含めるファイルのインデックスを含めなければならない。
logical ベクトルの長さは、入力 ds のファイル数と同じでなければならない。subset メソッドは、値 true をもつ logical ベクトルの要素に対応するファイルを含むサブセット subds を作成します。

indices の要素は一意でなければなりません。

データ型: double | logical