主要内容

imageDatastore

イメージデータのデータストア

このペ，ジをすべて展開する

説明

個々のイメージはメモリに収まるが,イメージの集合全体が必ずしもメモリに収まるとは限らない場合,イメージファイルの集合を管理するにはImageDatastoreオブジェクトを使用します。関数imageDatastoreを使用してImageDatastoreオブジェクトを作成し,そのプロパティを指定すると,オブジェクト関数を使用してデータのインポートおよび処理ができます。

作成

構文

imds = imageDatastore(location)
imds = imageDatastore(位置，名称，值)

説明

洛桑国际管理发展学院= imageDatastore (位置）は,位置で指定されたメジデタの集合からデタストア洛桑国际管理发展学院を作成します。

例

洛桑国际管理发展学院= imageDatastore (位置，名称,值）は，1以上の名前と値のペアの引数を使用して，洛桑国际管理发展学院の追加パラメ，タ，とプロパティを指定します。

入力引数

すべて展開する

デタストアに含めるファルまたはフォルダ。文件集オブジェクト，ファaaplルパス，またはDsFileSetオブジェクトとして指定します。

  • 文件集オブジェクト-位置を文件集オブジェクトとして指定できます。場所を文件集オブジェクトとして指定すると，パスまたはDsFileSetオブジェクトを指定した場合に比べ，デ，タストアの構築時間が短くなります。詳細にいては，matlab.io.datastore.FileSetを参照してください。

  • ファイルパス——単一のファイルパスを文字ベクトルまたは字符串スカラーとして指定できます。複数のファ▪▪ルパスは文字ベクトルのcell配列またはstring配列として指定できます。

  • DsFileSetオブジェクト-DsFileSetオブジェクトを指定できます。詳細にいては，matlab.io.datastore.DsFileSetを参照してください。

ファルまたはフォルダはロカルでもリモトでもかまいません。

  • ロカルのファルまたはフォルダ-ファルまたはフォルダのロカルパスを指定します。現在のフォルダ以外のファルの場合は，絶対パスまたは相対パスを指定します。指定したフォルダのサブフォルダ内にあるファルは，自動ではデタストアに含まれません。ロカルパスを指定するときにワルドカド文字(*)を使用できます。この文字は,一致するフォルダー内にある,すべてのファイルまたは一致するすべてのファイルをデータストアに含めることを指定します。

  • リモトのファルまたはフォルダ-hdfs: / / /path_to_fileの形式の统一资源定位符(URL)として,リモートのファイルまたはフォルダーの絶対パスを指定します。詳細にいては，リモ，トデ，タの操作を参照してください。

フォルダーを指定する場合,データストアにはサポートされているファイル形式のファイルのみが含まれ,その他の形式のファイルは無視されます。デタストアに含めるファル拡張子のカスタムリストを指定するには，FileExtensionsプロパティを参照してください。

関数imageDatastoreは,imformats形式のファ▪▪ルをサポ▪▪トします。

例:“file1.jpg”

例:“. . / dir /数据/ file1.png”

例:[" C: \ dir \ data \ file1.tif”,“C: \ dir \ data \ file2.tif”)

例:“C: \ dir \ \ * . jpg”数据

名前と値の引数

引数のオプションのペアをName1 = Value1,…,以=家として指定します。ここで的名字は引数名で，价值は対応する値です。名前と値の引数は他の引数の後になければなりませんが、ペアの順序は重要ではありません。

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

例:imds = imageDatastore("C:\dir\imagedata"，"FileExtensions"，[".jpg"，".tif"])

サブフォルダ，を含めるかどうかのフラグ。“IncludeSubfolders”と真正的または假で構成される名前と値の引数として指定します。各フォルダ内のすべてのファルとサブフォルダを含めるには真正的を指定し，各フォルダ，内のファ，ルのみを含めるには假を指定します。

“IncludeSubfolders”を指定しない場合，既定値は假です。

例:“IncludeSubfolders”,真的

デ，タ型:逻辑|双

@ @ @ @ @ @ @ @ @ @ @ @ @ @。“FileExtensions”と,文字ベクトル,文字ベクトルの细胞配列,字符串スカラーまたは字符串配列で構成されるコンマ区切りのペアとして指定します。指定された拡張子にimformats型式は不要であり，空の引用符＂＂を使用して，拡張子なしでファ。“FileExtensions”を指定しない場合，imageDatastoreは，指定パス上のimformats拡張子をもすべてのメジを自動的に含めます。imformatsで認識されない拡張子を含める場合は，すべての拡張子を指定します。

例:“FileExtensions”、“jpg”

例:“FileExtensions”(jpg, png”)

デ，タ型:字符|细胞|字符串

代替ファ▪▪ルシステムのル▪▪トパス。“AlternateFileSystemRoots”と字符串ベクトルまたは单元格配列で構成される名前と値の引数として指定します。ローカルマシン上にデータストアを作成するが,別のマシン(異なるオペレーティングシステムの可能性がある)上でデータにアクセスして処理する必要がある場合は,“AlternateFileSystemRoots”を使用します。また，并行计算工具箱™とMATLAB®并行服务器™を使用してデータを処理し,そのデータがローカルマシンに保存され,そのデータのコピーが異なるプラットフォームのクラウドやクラスターマシンにある場合,“AlternateFileSystemRoots”を使用してル，トパスを関連付けなければなりません。

  • 相互に対応する1組のル，トパスを関連付けるには，“AlternateFileSystemRoots”を字符串ベクトルとして指定します。以下に例を示します。

    [" Z: \数据集”、“/ mynetwork /数据集”)

  • デ，タストアに対応する複数の組のル，トパスを関連付けるには，複数行を含むcell配列として“AlternateFileSystemRoots”を指定します。各行は対応するル，トパスの組を表します。细胞配列内の各行を string ベクトル、または文字ベクトルの cell 配列のいずれかとして指定します。以下に例を示します。

    • “AlternateFileSystemRoots”を字符串ベクトルの单元格配列として指定します。

      {[Z: \“数据集”、“/ mynetwork /数据集”);…[" Y: \数据集”、“/ mynetwork2 /数据集”、“年代:\数据集”)}

    • あるいは，“AlternateFileSystemRoots”を文字ベクトルのcell配列からなるcell配列として指定します。

      {{“Z: \数据集”、“mynetwork /数据集”},…{“Y: \数据集”,“mynetwork2 /数据集”,年代:\数据集的}}

“AlternateFileSystemRoots”の値は，次の条件を満たさなければなりません。

  • 1 .行以上の行を含み，各行は1 .組の対応するル，トパスを指定する。

  • 各行は複数のル，トパスを指定し，各ル，トパスは2文字以上を含まなければならない。

  • ル，トパスは一意で，他のル，トパスのサブフォルダ，ではない。

  • ファ▪▪ルの場所を指す1▪▪以上のル▪トパスエントリを含む。

詳細にいては，異なるマシンまたはクラスタ，で処理するためのデ，タストアの設定を参照してください。

例:[" Z: \数据集”、“/ mynetwork /数据集”)

デ，タ型:字符串|细胞

ラベルデ，タを提供するソ，ス。“LabelSource”と“没有”または“foldernames”のいずれかで構成される名前と値の引数として指定します。“没有”を指定した場合，标签プロパティは空になります。“foldernames”を指定した場合，フォルダ，名に従ってラベルが割り当てられ，标签プロパティに格納されます。後で标签プロパティに直接アクセスして，ラベルを変更できます。

名前と値の引数“LabelSource”は,ファイルまたはフォルダーの場所として文件集オブジェクトが使用されている場合は使用できません。

デ，タ型:字符|字符串

これらの名前と値のペアに加えて，このペ，ジの任意のプロパティも名前と値のペアとして指定できます。ただし，文件プロパティを除きます。

プロパティ

すべて展開する

ImageDatastoreプロパティはデ，タを記述し，デ，タストアからデ，タを読み取る方法を指定します。数据存储オブジェクトの作成時に，名前と値の引数を使用してImageDatastoreプロパティの値を指定できます。オブジェクトの作成後にプロパティの表示または変更を行うには、ドット表記を使用します。

たとえば，ImageDatastoreオブジェクトを作成して，“ReadFcn”パラメ，タ，を指定できます。

imds = imageDatastore(“peppers.png”，“ReadFcn”, @customreader);
あるいは，ImageDatastoreの作成後に“ReadFcn”を@customreaderに割り当てることができます。
imds = imageDatastore(“peppers.png”）;洛桑国际管理发展学院。ReadFcn = @customreader;

デタストアに含まれるファル。文字ベクトル、文字ベクトルのcell配列、字符串スカラまたは字符串配列として解決されます。各文字ベクトルまたは string はファイルへの絶対パスです。関数imageDatastoreおよび関数数据存储の位置引数は，デ，タストアの作成時に文件を定義します。

例:{“C: \ dir \ data \ file1.jpg”;“C: \ dir \ data \ file2.jpg”}

デ，タ型:字符|细胞|字符串

このプロパティは読み取り専用です。

デタストアの作成に使用するフォルダ。文字ベクトルのcell配列として返されます。cell 配列は列ベクトルとして方向付けされます。各文字ベクトルは、データ ファイルを含むフォルダーへのパスです。関数imageDatastoreおよび関数数据存储の位置引数は，デ，タストアの作成時に文件夹を定義します。

デ，タ型:细胞

関数读の呼び出しで読み取る▪▪メ▪▪ジファ▪▪ルの数。正の整数スカラ，として指定します。関数读の各呼び出しで，最大ReadSize個の▪▪メ▪▪ジを読み取ります。

デタストア内のファルのラベル。ベクトル，单元格配列または字符串配列として指定します。配列内のラベルの順序は，デ，タストア内の関連付けられたファ，ルの順序に対応します。ImageDatastoreオブジェクトの作成時に“LabelSource”、“foldernames”を指定した場合，ファ@ @ @ @ @ @ @ @ @ @ @ @ @ @ @ @“LabelSource”、“foldernames”を指定しない場合，标签は空のcell配列または字符串配列です。デ，タストアの作成後に文件プロパティを変更した場合，追加されたファ标签プロパティが自動更新されることはありません。

デ，タ型:分类|细胞|逻辑|双|单|字符串

。関数ハンドルとして指定します。関数はイメージ ファイル名を入力として受け取らなければならず、その後に対応するイメージ データを出力します。たとえば、customreaderがイメージデータを読み取る関数として指定された場合,この関数には次のようなシグネチャがなければなりません。

函数data = customreader(filename)…结束
複数の出力引数が存在する場合，imageDatastoreは最初の引数のみを使用して，残りの引数を無視します。

メモ

2次元ReadFcnを使用することは推奨されません。imformatsの認識するファ化学键ル形式に化学键いて，ReadFcnを指定するとimageDatastoreのパフォ，マンスが遅くなります。化学键メ，化学键ジの変換および前処理の効率的な方法の詳細に，化学键いてはメ，ジの深層学習向け前処理(深度学习工具箱)を参照してください。

例:@customreader

デ，タ型:function_handle

このプロパティは読み取り専用です。

書き込みでサポ，トされる形式。字符串の行ベクトルとして返されます。このプロパティは、writeallを使用してデタストアから出力ファルを書き込む際に使用可能な出力形式を指定します。

このプロパティは読み取り専用です。

既定の出力形式。字符串スカラーとして返されます。このプロパティは、writeallを使用してデタストアから出力ファルを書き込む際の既定の形式を指定します。

デ，タ型:字符串

オブジェクト関数

countEachLabel ImageDatastoreラベル内のファeprルをカウントする
hasdata デ，タが読み取り可能かどうかを判別
numpartitions デ，タストアの区画数
分区 デ，タストアを分割する
预览 デタストア内のデタのサブセットをプレビュ
读 デ，タストアのデ，タの読み取り
readall デ，タストアのすべてのデ，タの読み取り
readimage 指定されたメジをデタストアから読み取る
writeall ファ▪▪ルへのデ▪▪タストアの書き込み
重置 デ，タストアの初期状態へのリセット
洗牌 デ，タストア内のすべてのデ，タをシャッフルする
splitEachLabel ImageDatastoreのラベルを比率で分割
子集 デタストアまたはFileSetのサブセットの作成
变换 デ，タストアの変換
结合 複数のデ，タストアのデ，タを統合
isPartitionable デ，タストアが分割可能かどうかを判別
isSubsettable 确定数据存储是否可子集
isShuffleable デ，タストアがシャッフル可能かどうかを判別

例

すべて折りたたむ

Matlab®パスおよびそのサブフォルダ，内にあるすべての.tifファ@ @ルに関連付けられたImageDatastoreオブジェクトを作成します。フォルダ，名をラベル名として使用します。

imds = imageDatastore(fullfile(matlabroot，“工具箱”，“matlab”)，.．.“IncludeSubfolders”,真的,“FileExtensions”，“.tif”，“LabelSource”，“foldernames”）
imd =ImageDatastore的属性:文件:{'…\matlab\toolbox\matlab\demos\example.tif';\matlab\toolbox\matlab\imagesci\corn.tif'}文件夹:{'…\matlab\toolbox\matlab'}标签:[demo;imagesci] AlternateFileSystemRoots: {} ReadSize: 1 万博1manbetxSupportedOutputFormats: ["png" "jpg" "jpeg" "tif" "tiff"] DefaultOutputFormat: "png" ReadFcn: @readDatastoreImage

4 .文件集オブジェクトを作成します。ImageDatastoreオブジェクトを作成します。

fs = matlab.io.datastore.FileSet([“street1.jpg”，“street2.jpg”，“peppers.png”，“corn.tif”])
fs =带有属性的文件集:NumFiles: 4 NumFilesRead: 0 FileInfo:显示所有4个文件的FileInfo
imds = imageDatastore(fs)
imd =ImageDatastore的属性:文件:{'…\matlab\toolbox\matlab\demos\street1.jpg';’……\ matlab \ matlab工具箱\ \ demo \ street2.jpg”;\matlab\toolbox\matlab\imagesci\pepper .png{'…\matlab\toolbox\matlab\demos';“…\matlab\toolbox\matlab\imagesci'} AlternateFileSystemRoots: {} ReadSize: 1 Labels: {} S万博1manbetxupportedOutputFormats: ["png" "jpg" "jpeg" "tif" "tiff"] DefaultOutputFormat: "png" ReadFcn: @readDatastoreImage

最初のメジをプレビュします。

imshow(预览(imd));

街道形象

2番目と3番目の▪▪メ▪ジのみを1▪▪ず▪▪読み取ります。

为I = 2:3 img = readimage(imds, I);结束

④。

Imgs = readall(imds);imshow(一个{3})

蔬菜图片

制限

  • 2次元ReadFcnを使用することは推奨されません。imformatsの認識するファ化学键ル形式に化学键いて，ReadFcnを指定するとimageDatastoreのパフォ，マンスが遅くなります。化学键メ，化学键ジの変換および前処理の効率的な方法の詳細に，化学键いてはメ，ジの深層学習向け前処理(深度学习工具箱)を参照してください。

拡張機能

バ，ジョン履歴

R2015bで導入

参考

||

トピック