主要内容

このページの翻訳は最新ではありません。ここをクリックして,英語の最新版を参照してください。

imageDatastore

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

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

説明

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

作成

構文

imd = imageDatastore(位置)
imd = imageDatastore(位置、名称、值)

説明

imds=图像数据存储(位置)は、位置で指定されたイメージ データの集合からデータ ストアimdsを作成します。

例

imds=图像数据存储(位置,名称、值)は、1.つ以上の名前と値のペアの引数を使用して、imdsの追加パラメーターとプロパティを指定します。

入力引数

すべて展開する

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

  • パス — ローカルやリモートのファイルまたはフォルダーの場所を含む文字ベクトル、文字ベクトルの 单间牢房配列、一串スカラー、または 一串配列としてパスを指定します。

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

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

  • 数据文件集オブジェクト —位置を数据文件集オブジェクトとして指定することもできます。詳細については,matlab.io.datastore.DsFileSetを参照してください。

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

関数imageDatastoreは、imformats形式のファイルをサポートします。

例:“file1.jpg”

例:“../dir/data/file1.png”

例:{'C:\dir\data\file1.tif'，'C:\dir\data\file2.tif'}

例:'C:\dir\data\*.jpg'

名前と値のペアの引数

オプションの名称、值の引数ペアをコンマ区切りで指定します。的名字は引数名で、价值は対応する値です。的名字は引用符で囲まなければなりません。Name1, Value1,…,的家のように、複数の名前と値のペアの引数を任意の順序で指定できます。

例:imds=imageDatastore（'C:\dir\imagedata'，'FileExtensions'，{.jpg'，'.tif'}）

サブフォルダーを含めるかどうかのフラグ。“包含子文件夹”と、符合事实的または错误的のいずれかで構成されるコンマ区切りのペアとして指定します。各フォルダー内のすべてのファイルとサブフォルダーを含めるには符合事实的を指定し,各フォルダー内のファイルのみを含めるには错误的を指定します。

“包含子文件夹”を指定しない場合、既定値は错误的です。

例:“IncludeSubfolders”,真的

データ型:必然的|双

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

例:“FileExtensions”、“jpg”

例:FileExtensions, {jpg, png的}

データ型:字符|单间牢房|字符串

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

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

    [“Z:\datasets”，“/mynetwork/datasets”]

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

    • “AlternateFileSystemRoots”を 一串ベクトルの 单间牢房配列として指定します。

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

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

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

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

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

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

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

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

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

例:[“Z:\datasets”，“/mynetwork/datasets”]

データ型:字符串|单间牢房

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

データ型:字符|字符串

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

プロパティ

すべて展開する

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

たとえば,图像数据存储オブジェクトを作成して,“ReadFcn”パラメーターを指定できます。

imds=图像数据存储(“peppers.png”,“ReadFcn”, @customreader);
あるいは、图像数据存储の作成後に“ReadFcn”を@客户阅读器に割り当てることができます。
imds=图像数据存储(“peppers.png”）;洛桑国际管理发展学院。ReadFcn = @customreader;

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

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

データ型:字符|单间牢房|字符串

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

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

データ型:单间牢房

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

データ ストア内のファイルのラベル。ベクトル、单间牢房配列または 一串配列として指定します。配列内のラベルの順序は、データ ストア内の関連付けられたファイルの順序に対応します。图像数据存储オブジェクトの作成時に“LabelSource”、“foldernames”を指定した場合、ファイルのラベル名はそのファイルを含むフォルダーの名前になります。“LabelSource”、“foldernames”を指定しない場合,标签は空の 单间牢房配列または 一串配列です。データ ストアの作成後に文件プロパティを変更した場合、追加されたファイルを含めるように标签プロパティが自動更新されることはありません。

データ型:分类|单间牢房|必然的|双|单|字符串

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

函数数据=customreader（文件名）…结束
複数の出力引数が存在する場合,imageDatastoreは最初の引数のみを使用して、残りの引数を無視します。

メモ

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

例:@客户阅读器

データ型:功能手柄

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

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

データ型:字符串

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

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

データ型:字符串

オブジェクト関数

计数标签 ImageDatastoreラベル内のファイルをカウントする
hasdata データが読み取り可能かどうかを判別
numpartitions データストアの区画数
分区 データ ストアを分割する
预览 データストア内のデータのサブセットをプレビュー
阅读 データストアのデータの読み取り
readall データストアのすべてのデータの読み取り
readimage 指定されたイメージをデータ ストアから読み取る
书面语 ファイルへのデータストアの書き込み
重置 データ ストアの初期状態へのリセット
洗牌 データストア内のすべてのデータをシャッフルする
拆分标签 ImageDatastoreのラベルを比率で分割
子集 データストアまたはファイルセットのサブセットを作成
使改变 データ ストアの変換
结合 複数のデータストアのデータを統合
可分割 データストアが分割可能かどうかを判別
易怒 データストアがシャッフル可能かどうかを判別

例

すべて折りたたむ

スクリプトを開く

MATLAB®パスおよびそのサブフォルダー内にあるすべての.tifファイルに関連付けられた图像数据存储オブジェクトを作成します。フォルダー名をラベル名として使用します。

imd = imageDatastore (fullfile (matlabroot“工具箱”,matlab的),．..“包含子文件夹”符合事实的“FileExtensions”,“.tif”,“标签源”,“foldernames”)
imds=ImageDatastore，具有以下属性：文件：{'.\matlab\toolbox\matlab\demos\example.tif'；'.''.\matlab\toolbox\matlab\imagesci\corn.tif'}标签：[demos；imagesci]ReadSize:1 ReadFcn:@readDatastoreImage
スクリプトを開く

4つのイメージを含む图像数据存储オブジェクトを作成し,最初のイメージをプレビューします。

imd = imageDatastore ({“street1.jpg”,“street2.jpg”,“peppers.png”,“corn.tif”}）
imds=ImageDatastore，属性为：文件：{'.\matlab\toolbox\matlab\demos\street1.jpg'；'.'.\matlab\toolbox\matlab\demos\street2.jpg'；'.\matlab\toolbox\matlab\imagesci\peppers.png'.'和1个以上的}ReadSize:1标签：{}ReadFcn:@readDatastoreImage
imshow(预览(imd));

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

对于i=2:3 img=readimage（imds，i）；终止

イメージを4つすべて読み取り,3番目のイメージを表示します。

一个= readall (imd);imshow(一个{3})

制限

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

参考

||

トピック

R2015bで導入

MATLABドキュメンテーション

サポート

MATLABで始めるディープラーニング

MATLABで始めるディープラーニング

电子书をダウンロードする