ラベル付きのグラウンドトゥルースデータの共有と保存

イメージラベラー、ビデオラベラー、グラウンドトゥルースラベラー (Automated Driving Toolbox) アプリを使用すると、イメージ、ビデオ、およびその他のグラウンドトゥルースデータソースにラベルを付けることができます。その後、グラウンドトゥルースラベルを groundTruth オブジェクトとして、またはグラウンドトゥルースラベラー (Automated Driving Toolbox) アプリの場合は groundTruthMultisignal (Automated Driving Toolbox) オブジェクトとしてエクスポートできます。グラウンドトゥルースオブジェクトには、次の情報が含まれます。

1 つ (または複数) のデータソース
ラベル定義
描画済みのグラウンドトゥルースラベル

このオブジェクトを以下と共有できます。

ラベル付けをしている他の同僚。これを使用して、ラベル付けを継続できます。
アルゴリズム開発者。これを使用して、オブジェクト検出器やセマンティックセグメンテーションネットワークなどのアルゴリズムに学習させることができます。
検証エンジニア。これを使用して、アルゴリズムを検証できます。

グラウンドトゥルースの共有

いずれかのラベル付けアプリからラベル付きのグラウンドトゥルースデータをエクスポートして共有するには、[ラベルをエクスポート] 、 [ファイルへ] を選択します。その後、エクスポートした MAT ファイルをチーム内の個人と直接共有するか、共有のネットワークの場所に配置できます。

エクスポートしたグラウンドトゥルースデータがピクセルラベルを含む場合、アプリはそのピクセルラベルデータを含む PixelLabelData フォルダーも生成します。グラウンドトゥルースオブジェクトに保存されたラベルデータ table は、このフォルダーのパスを参照します。このフォルダーをグラウンドトゥルースオブジェクトと共に共有します。

ラベル付けアプリを使用すると、アプリセッション全体の MAT ファイルを保存することもできます。このファイルは共有しません。このセッションファイルはローカルマシン固有のアプリ基本設定を含んでいるため、他のマシンでは機能しない可能性があります。

ピクセルラベルデータを含むグラウンドトゥルースオブジェクトを再エクスポートする場合、アプリは新しい PixelLabelData フォルダーを生成します。元のグラウンドトゥルースオブジェクトを上書きする場合でも、アプリは新しい PixelLabelData フォルダーを生成します。グラウンドトゥルースオブジェクトを再エクスポートした場合、生成されたフォルダーは、そのオブジェクトを同じフォルダーに再エクスポートした回数に応じて、PixelLabelData_1、PixelLabelData_2 のように名前が付けられます。

グラウンドトゥルースオブジェクトを共有するときには、関連付けられた正しい PixelLabelData フォルダーを共有してください。たとえば、元のグラウンドトゥルースオブジェクトを上書きした場合、上書きしたオブジェクトと新しく作成された PixelLabelData_1 フォルダーを共有します。

グラウンドトゥルースオブジェクトを共有することに加えて、1 つ (または複数) のデータソースおよび関連するファイルも共有しなければなりません。次の各表に、共有すべきファイルを各アプリのデータソースごとに示します。

イメージラベラーアプリの共有すべきファイル

データソース	共有するファイル
イメージコレクション	`groundTruth` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) イメージコレクションを含むフォルダー (共有場所にない場合)

ビデオラベラーアプリの共有すべきファイル

データソース	共有するファイル
ビデオ	`groundTruth` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) ビデオソースファイル (共有場所にない場合)
イメージシーケンス	`groundTruth` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) イメージシーケンスを含むフォルダー (共有場所にない場合) タイムスタンプ `duration` ベクトル (指定した場合)
カスタムイメージデータソースリーダー	`groundTruth` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) データソースファイル (共有場所にない場合) カスタムリーダー関数

グラウンドトゥルースラベラーアプリの共有すべきファイル

データソース	共有するファイル
ビデオ	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) ビデオソースファイル (共有場所にない場合)
イメージシーケンス	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) イメージシーケンスを含むフォルダー (共有場所にない場合) タイムスタンプ `duration` ベクトル (指定した場合)
カスタムイメージデータソースリーダー	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) データソースファイル (共有場所にない場合) カスタムリーダー関数
点群シーケンス	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) 点群シーケンスを含むフォルダー (共有場所にない場合) タイムスタンプ `duration` ベクトル (指定した場合)
Velodyne^® パケットキャプチャ (PCAP) ファイル	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) PCAP ソースファイル (共有場所にない場合) PCAP キャリブレーションファイルタイムスタンプ `duration` ベクトル (指定した場合)
rosbag	`groundTruthMultisignal` オブジェクト MAT ファイル `PixelLabelData` フォルダー (ピクセルラベルのみ) rosbag ファイル

グラウンドトゥルースの移動

エクスポートしたグラウンドトゥルースオブジェクトの DataSource プロパティは、データソースファイルの絶対パスを含んでいます。たとえば、イメージラベラーアプリからエクスポートされた groundTruth オブジェクト gTruth のパスを表示したいとします。MATLAB^® コマンドプロンプトで次のコードを入力します。

gTruth.DataSource

ans = 

groundTruthDataSource for an image collection with properties

                      Source: {
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\bigMug.jpg';
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\blueCup.jpg';
                              ' ...\matlab\toolbox\vision\visiondata\imageSets\cups\handMade.jpg'
                               ... and 9 more
                              }

グラウンドトゥルースオブジェクトを新しい場所に移動した場合、1 つ (または複数) のデータソースに保存されているファイルパスの変更が必要な可能性があります。データソースファイルが共有ネットワークにある場合でも、他のユーザーが異なるドライブ文字を自分のネットワークフォルダーにマップしている場合は、ファイルパスが不正確な可能性があります。

これらのパスを更新するには、関数 changeFilePaths を使用します。グラウンドトゥルースオブジェクトをこの関数の入力引数として指定します。パスが変わってもファイル名は変わっていない場合、新旧のパスを含む string ベクトルを指定します。この関数は、解決できなかったパスを返します。たとえば、次のコードサンプルは、イメージフォルダーのドライブ文字を変更する方法を示しています。

alternativePaths = ["C:\Shared\ImgFolder" "D:\Shared\ImgFolder"];
unresolvedPaths = changeFilePaths(gTruth,alternativePaths);

ファイル名も変わった場合は、新旧のパスを含む string ベクトルの cell 配列を指定します。たとえば、次のコードサンプルは、各ファイルのドライブ文字を変更する方法と、各ファイルに接尾辞を付加する方法を示しています。

alternativePaths =  ...
    {["C:\Shared\ImgFolder\Img1.png" "D:\Shared\ImgFolder\Img1_new.png"], ...
     ["C:\Shared\ImgFolder\Img2.png" "D:\Shared\ImgFolder\Img2_new.png"], ...
     .
     .
     .
     ["C:\Shared\ImgFolder\ImgN.png" "D:\Shared\ImgFolder\ImgN_new.png"]};
unresolvedPaths = changeFilePaths(gTruth,alternativePaths);

グラウンドトゥルースオブジェクトにピクセルラベルデータが含まれている場合、関数 changeFilePaths を使用して、PixelLabelData フォルダーに保存されたピクセルラベルデータのパス名を更新することもできます。

グラウンドトゥルースの保存

MATLAB 検索パス上の場所にグラウンドトゥルースオブジェクトを保存します。詳細については、MATLAB 検索パスとはを参照してください。

データソースの内容が 1 つのフォルダーに配置されている場合、グラウンドトゥルースオブジェクトをデータソースの親フォルダーに保存することを検討してください。別のフォルダーのイメージを含むイメージコレクションの場合、オブジェクトの保存先に関する具体的な推奨事項はありません。イメージコレクションにラベルを付ける場合は、イメージラベラーアプリを使用します。

ラベル付きビデオシーンの抽出

ビデオラベラーアプリまたはグラウンドトゥルースラベラー (Automated Driving Toolbox) アプリによって、データストアを使用して読み込める形式でエクスポートされた groundTruth オブジェクトまたは groundTruthMultisignal (Automated Driving Toolbox) オブジェクトから、ラベル付きビデオシーンと対応するラベルを抽出できます。これらのラベル付きビデオシーンは、学習、検証、および評価に使用できます。抽出されたビデオシーンを使用すると、長いビデオの特定の範囲にビデオラベルを採用したり、深層学習技術を適用して異常を検出したり、ビデオ内の特定のアクティビティを認識したりできます。

関数 sceneTimeRanges を使用して、ラベル付けされたシーンの時間範囲をグラウンドトゥルースオブジェクトから取得します。
関数 writeVideoScenes を使用して、グラウンドトゥルースオブジェクト配列とラベル付けされたシーンの時間範囲情報を関数 sceneTimeRanges から取得し、ビデオシーンをフォルダーに書き込みます。このデータは、データストアベース深層学習の学習ワークフローおよび評価ワークフローで直接使用できます。

参考