このページの翻訳は最新ではありません。ここをクリックして、英語の最新版を参照してください。
pixelLabelDatastore
ピクセル ラベル データのデータストア
説明
PixelLabelDatastore
オブジェクトを使用して、セマンティック セグメンテーションのピクセル ラベル データを読み取ることができます。
PixelLabelDatastore
からピクセル ラベル データを読み取るには、関数 read
を使用します。この関数は、すべてのピクセル位置 (i,j) またはボクセル位置 (i,j,k) に割り当てられたカテゴリカル ラベルを含む categorical 配列を返します。
作成
ここで説明する関数 pixelLabelDatastore
を使用して PixelLabelDatastore
オブジェクトを作成します。オブジェクトを作成すると、データのアクセスや管理を行う関数を使用できます。ドット表記を使用して、
プロパティと ReadSize
プロパティを変更できます。ReadFcn
構文
説明
pxds = pixelLabelDatastore(
は、gTruth
)groundTruth
オブジェクトまたは groundTruth
オブジェクトの配列から PixelLabelDatastore
オブジェクトを作成します。
pxds = pixelLabelDatastore(
は、ピクセル ラベル データが保存されているイメージ ファイルから location
,classNames
,pixelLabelIDs
)PixelLabelDatastore
オブジェクトを、location
で指定されたフォルダーまたはファイルに作成します。この関数は、イメージ ピクセル ラベルの値をクラス名にマップするピクセル ID を使用してオブジェクトを作成します。
pxds = pixelLabelDatastore(___,Name,Value)
は、名前と値のペアの引数を使用して ReadSize
プロパティと AlternateFileSystemRoots
プロパティのいずれかまたは両方を設定し、PixelLabelDatastore
オブジェクトを作成します。イメージ ファイルの入力では、名前と値のペアの引数を使用して ReadFcn
プロパティを設定するか、データストアに含めるファイルに関するオプションを指定することができます。複数の名前と値のペアを指定できます。各プロパティ名を引用符で囲みます。
たとえば、pixelLabelDatastore(loc,names,ids,'ReadSize',8,'FileExtensions','png')
によって作成されるピクセル ラベル データストアには PNG イメージのみが含まれ、関数 read
の呼び出しごとに 8 個のイメージを読み取ります。
入力引数
プロパティ
オブジェクト関数
combine | 複数のデータストアのデータを統合 |
countEachLabel | Count occurrence of pixel or box labels |
hasdata | Determine if data is available to read from datastore |
numpartitions | Number of partitions for a datastore |
partition | Partition a label datastore |
preview | Read first row of data in datastore |
read | Read data from a datastore |
readall | Read all data in datastore |
readimage | Read specified pixel label data file |
reset | Reset datastore to initial state |
shuffle | Return shuffled version of datastore |
transform | データストアの変換 |
subset | データストアまたは FileSet のサブセットの作成 |
isPartitionable | データストアが分割可能かどうかを判別 |
isShuffleable | データストアがシャッフル可能かどうかを判別 |
例
ヒント
pixelLabelDatastore
は、ファイルを辞書式順序で格納します。たとえば、'file1.jpg'
、'file2.jpg'
、…、'file11.jpg'
、および'file12.jpg'
という名前の 12 個のファイルがある場合、ファイルは次の順序で格納されます。'file1.jpg'
'file10.jpg'
'file11.jpg'
'file12.jpg'
'file2.jpg'
'file3.jpg'
...'file9.jpg'
対照的に、
imageDatastore
は、データストアに追加された順にファイルを格納します。グラウンド トゥルース イメージとピクセル ラベル データを同時に読み取る場合、イメージとラベルの間の不一致が発生する可能性があります。これが発生した場合は、ピクセル ラベル ファイルの名前を変更して、適切な順序になるようにします。たとえば、'file1.jpg'
、…、'file9.jpg'
の名前を'file01.jpg'
、…、'file09.jpg'
に変更します。ビデオ ラベラー アプリを使用して生成された
groundTruth
オブジェクトからセマンティック セグメンテーション データを抽出するには、関数pixelLabelTrainingData
を使用します。
バージョン履歴
R2017b で導入
参考
アプリ
関数
オブジェクト
ImageDatastore
|groundTruth
|semanticSegmentationMetrics
|pixelLabelImageDatastore
|randomPatchExtractionDatastore
トピック
- 深層学習を使用した脳腫瘍の 3 次元セグメンテーション
- 深層学習を使用したセマンティック セグメンテーション入門
- 深層学習用のデータストア (Deep Learning Toolbox)
- MATLAB による深層学習 (Deep Learning Toolbox)
- オブジェクト検出およびセマンティック セグメンテーション用の学習データ