shuffle

データストア内のすべてのデータをシャッフルする

構文

dsrand = shuffle(ds)

説明

dsrand = shuffle(ds) は、ds のデータをランダムな順序で含む datastore オブジェクトを返します。

例

ファイルをシャッフルする

ImageDatastore オブジェクト imds を作成します。ファイルをシャッフルして、同じファイルをランダムな順序で含む新しいデータストアを作成します。

imds = imageDatastore(["cloudCombined.png","example.tif","landOcean.jpg","street2.jpg","corn.tif"]);
imdsrand = shuffle(imds)

imdsrand = 

  ImageDatastore with properties:

                       Files: {
                              'C:\folder1\landOcean.jpg';
                              'C:\folder1\cloudCombined.png';
                              'C:\folder1\corn.tif'
                               ... and 2 more
                              }
                     Folders: {
                              'C:\folder1'
                              }
    AlternateFileSystemRoots: {}
                    ReadSize: 1
                      Labels: {}
      SupportedOutputFormats: ["png"    "jpg"    "jpeg"    "tif"    "tiff"]
         DefaultOutputFormat: "png"
                     ReadFcn: @readDatastoreImage

入力引数

ds — 入力データストア

オブジェクト

入力データストア。datastore オブジェクトとして指定します。入力データストアには、isShuffleable が true を返す任意のデータストア (imageDatastore など) を指定できます。また、入力データストアには、基となるすべてのデータストアがシャッフル可能な CombinedDatastore、SequentialDatastore、または TransformedDatastore も指定できます。

出力引数

dsrand — 出力データストア

オブジェクト

出力データストア。ds のデータをランダムな順序で含む datastore オブジェクトとして返されます。

拡張機能

スレッドベースの環境

MATLAB® の backgroundPool を使用してバックグラウンドでコードを実行するか、Parallel Computing Toolbox™ の ThreadPool を使用してコードを高速化します。

shuffle 関数はスレッドベースの環境をサポートしますが、次の使用上の注意および制限があります。

• スレッドベースの環境では、次のデータストアでのみ shuffle を使用できます。

  • ImageDatastore オブジェクト

  • combine または transform を使用して ImageDatastore オブジェクトから作成する CombinedDatastore、SequentialDatastore、または TransformedDatastore オブジェクト

  Parallel Computing Toolbox™ がある場合は、他のデータストアで shuffle を使用できます。これを行うには、backgroundPool または ThreadPool を使用する代わりに、プロセスベースの並列プールを使用して関数を実行します (ProcessPool または ClusterPool を使用します)。

詳細については、スレッドベースの環境での MATLAB 関数の実行を参照してください。

バージョン履歴

R2016a で導入

参考

ImageDatastore | datastore | isShuffleable | matlab.io.Datastore