groundTruthDataSource
グラウンド トゥルース データ ソースを格納するオブジェクト
説明
groundTruthDataSource オブジェクトは、グラウンド トゥルース データのソースを定義します。このオブジェクトを使用して、groundTruth オブジェクトのデータ ソースを指定します。データ ソースにラベルを付けるには、groundTruthDataSource オブジェクトをラベル付けアプリに読み込みます。
作成
構文
説明
イメージ データストアのソース
gtSource = groundTruthDataSource(imds)imds によって指定された imageDatastore のグラウンド トゥルース データ ソース オブジェクトを返します。
イメージ コレクションのソース
gtSource = groundTruthDataSource(imageFiles)imageFiles によって指定されたイメージ コレクションのグラウンド トゥルース データ ソース オブジェクトを返します。イメージは imread で読み取り可能なファイル形式でなければなりません。
ビデオ ファイルのソース
gtSource = groundTruthDataSource(videoName)videoName によって指定されたビデオ ファイルのグラウンド トゥルース データ ソース オブジェクトを返します。ビデオは VideoReader で読み取り可能なファイル形式でなければなりません。
イメージのシーケンスであるビデオのソース
gtSource = groundTruthDataSource(imageSeqFolder)imageSeqFolder によって指定されたフォルダー内に配置されたイメージ シーケンスのグラウンド トゥルース データ ソース オブジェクトを返します。
gtSource = groundTruthDataSource(imageSeqFolder,timestamps)timestamps は TimeStamps プロパティを設定します。
入力引数
プロパティ
例
イメージ コレクションのファイル名を読み込みます。
imageDir = fullfile(matlabroot,'toolbox','vision','visiondata','bookCovers'); imds = imageDatastore(imageDir);
イメージ データストアからデータ ソースを作成します。
dataSource = groundTruthDataSource(imds);
データストアからのイメージを読み取って表示します。
I = read(dataSource.Source); figure,imshow(I)
groundTruthDataSource オブジェクトを使用してデータ ソースを作成します。
ビデオ ファイルを読み取り、データ ソースを作成します。
videoName = 'vipunmarkedroad.avi';
dataSource = groundTruthDataSource(videoName)dataSource =
groundTruthDataSource for a video file with properties
Source: ...tlab/toolbox/vision/visiondata/vipunmarkedroad.avi
TimeStamps: [84×1 duration]
VideoReader を作成して、ビデオ フレームを読み取ります。
reader = VideoReader(videoName);
ビデオ内の 5 番目のフレームを読み取って表示します。
timeStamp = seconds(dataSource.TimeStamps(5)); reader.CurrentTime = timeStamp; I = readFrame(reader); figure imshow(I)
指定されたフォルダーに格納されているイメージ シーケンスからグラウンド トゥルース データ ソースを作成します。
イメージのシーケンスが含まれているフォルダーを指定します。
imageDir = fullfile(matlabroot,'toolbox','vision',... 'visiondata','building');
imageDir フォルダー内に存在するイメージのデータ ソースを作成します。
dataSource = groundTruthDataSource(imageDir)
dataSource =
groundTruthDataSource for a video as an image sequence with properties
Source: {
' .../runnable/matlab/toolbox/vision/visiondata/building/building1.JPG';
' .../runnable/matlab/toolbox/vision/visiondata/building/building2.JPG';
' .../runnable/matlab/toolbox/vision/visiondata/building/building3.JPG'
... and 2 more
}
TimeStamps: [5×1 duration]
シーケンス内の 5 番目のフレームを読み取ります。
I = imread(dataSource.Source{5});
figure
imshow(I)
カスタム リーダー関数を使用してグラウンド トゥルース データ ソースを作成します。
道路のイメージのシーケンスが含まれるイメージ フォルダーを指定します。
imgFolder = fullfile(matlabroot,'toolbox','vision','visiondata','building');
イメージ データストアをカスタム データ ソースとして使用します。
imgDataStore = imageDatastore(imgFolder);
データストアからイメージを読み取るリーダー関数 readerFcn を記述します。最初の入力引数 sourceName は使用されません。2 番目の入力引数 currentTimestamp は現在のタイムスタンプです。この関数は currentTimestamp を、duration スカラーから、データストアからのイメージの読み取りに適した 1 ベースのインデックスに変換します。
readerFcn = @(~,idx)readimage(imgDataStore,seconds(idx));
カスタム リーダー関数を使用して、イメージ フォルダー内にあるイメージのデータ ソースを作成します。
dataSource = groundTruthDataSource(imgFolder,readerFcn,1:5)
dataSource =
groundTruthDataSource for a custom data source with properties
Source: ...runnable/matlab/toolbox/vision/visiondata/building
TimeStamps: [5×1 duration]
シーケンス内の 5 番目のフレームを読み取ります。
I = readerFcn(imgFolder,seconds(5)); figure imshow(I)
ヒント
ビデオベースの
groundTruthDataSourceオブジェクトのgroundTruthオブジェクトは、オペレーティング システムのビデオ読み取り機能に依存します。ビデオ データ ソースを使用して作成されたgroundTruthオブジェクトは、そのオブジェクトを作成するために使用された同じプラットフォームでのみ整合性を維持します。プラットフォーム固有のgroundTruthオブジェクトを作成するには、ビデオをイメージのシーケンスに変換します。
バージョン履歴
R2017a で導入
