main Content

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

groundTruth

グラウンド トゥルース ラベル データ

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

说明

groundTruthオブジェクトにのグラウンドラベルの，ラベル，およびマークさされたラベルのの注釈に关する关する情报情报情报。groundTruthオブジェクトは，イメージ ラベラーアプリおよびビデオラベラーアプリからまたはインポートでき。。

  • groundTruthオブジェクトのからの学习データをするには，关数ObjectDetectorTrainingDataを使用します。

  • groundTruthオブジェクトの配列からセマンティック セグメンテーション ネットワークの学習データを作成するには、関数PixellabelTrainingDataを使用します。

作成

ラベル付けアプリからgroundTruthオブジェクトをするは，のツールストリップで，[ラベルを]，[ワークスペースへ]を选択ます。アプリがオブジェクトをを®ワークスペースにエクスポートします。プログラムでgroundTruthオブジェクトをするには关数关数groundTruthを使用ます（ここでし）。

构文

gTruth = groundTruth(dataSource,labelDefs,labelData)

说明

例

gTruth=地面图（dataSource，，，，Labeldefs，，，，labelData）は，イメージ ラベラーアプリおよびビデオラベラーアプリにインポートできるグラウンド トゥルース ラベルを含むオブジェクトを返します。

  • dataSourceでは，トゥルースのソースを指定，，DataSourceプロパティを设定ます。

  • Labeldefsでは，データラベル，サブラベル，の定义を指定，，LabelDefinitionsプロパティを设定ます。

  • labelDataでは，れたの识别情报位置およびタイムスタンプを指定し，LabelDataプロパティを设定ます。

プロパティ

すべて展開する

グラウンドトゥルースデータソース。groundTruthDataSourceオブジェクトとして指定します。オブジェクトには、ビデオ、イメージ シーケンス、またはグラウンドトゥルース データがラベル付けされたカスタムのデータ ソースを記述する情報が含まれます。

元のデータ ソースからイメージにアクセスするには、VideoReaderまたはimageDatastoreを使用します。また、カスタム読み取り関数を使用することもできます。詳細は、ラベル付けのカスタムソースリーダーの使用を参照してください。

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

ラベル定義。table として指定します。このテーブルを作成するには、次のいずれかの方法を使用します。

  • ラベル付けのかラベル定义をし，それをgroundTruthオブジェクトの一部としてエクスポートします。

  • labelDefinitionCreatorオブジェクトを使用して、ラベル定義テーブルを生成します。このテーブルを MAT ファイルに保存すると、ラベル定義をラベル付けアプリのセッションに読み込めます。アプリのツールストリップで、[読み込み]，[ラベルの定義]を选択しください。

  • ラベル定義テーブルを MATLAB コマンド ラインで作成します。

次の表に、LabelDefinitionsプロパティに指定するテーブルの必須およびオプションの列を示します。

列 说明 必须またはオプション
name 各ラベル定義の名前を指定する文字列または文字ベクトル。

必须
Type 各ラベルのタイプをするするlabelType列挙。Rectangle，场景など。

必须
LabelColor ラベル定義の色を指定する RGB 3 成分の 1 行 3 列の行ベクトル。値は [0, 1] の範囲内です。黄色 (RGB 3 成分 [1 1 0]) は、ラベル付けアプリにおける選択ラベルの色として予約されています。

オプション

ラベル付けアプリでラベルを定義する場合、色を指定しなければなりません。そのため、エクスポートされるラベル定義テーブルには必ずこの列が含まれます。

labelDefinitionCreatorオブジェクト使用，色を指定せにラベルをする场合，，返さ返されるれるれるラベルラベル定义テーブルテーブルはこの列列がが含ま含まれれます
Pixellabelid スカラー、列ベクトル、または整数値ラベル ID の M 行 3 列の行列。Pixellabelidは，ラベル定義を表すために使用されるピクセル ラベル値を指定します。ピクセル ラベル ID の値は 0 ～ 255 の範囲でなければなりません。

オプション

ラベル付けアプリまたはlabelDefinitionCreatorオブジェクトでを定义场合生成さラベル定义にはこの列列が含ま含ま。。。

ラベル定義テーブルを MATLAB コマンド ラインで作成するときに、いずれかのラベルのTypeをlabelType.PixelLabelに設定した場合、この列は必須になります。
Group 各ラベル定義が属するグループを指定する文字列または文字ベクトル。

オプション

ラベル定義テーブルを MATLAB コマンド ラインで作成する場合、Group列を含める必要はありません。

ラベル付けアプリからラベル定義をエクスポートする場合や、labelDefinitionCreatorオブジェクトをて定义を作成するするグループをしてていなくなくててももも，，定义定义テーブルににはははこのこのこの列列がGroupの値として'None'を割り当てます。
Description 各ラベルについてする文字または文字ベクトル。

オプション

ラベル定義テーブルを MATLAB コマンド ラインで作成する場合、Description列を含める必要はありません。

ラベル付けアプリからラベル定義をエクスポートする場合や、labelDefinitionCreatorオブジェクトを使用してラベル定義を作成する場合、説明を指定していなくても、ラベル定義テーブルにはこの列が含まれます。こうしたラベル定義のDescriptionは空文字ベクトルに。。
Hierarchy 各ラベル定義のサブラベルと属性データを含む構造体。Hierarchyの形式例については，イメージラベラー入门またはビデオラベラー入門を参照してください。

オプション

ラベル付けアプリでサブラベルまたは属性を定義する場合、エクスポートされるgroundTruthオブジェクトにはこの列が含まれます。

たとえば、天空，植被，Lanes，StopSign，および车辆という名前定义をテーブルについて考え。がががビデオラベラーアプリからさたものとし。。

  • ラベル定义はが含まれてため，テーブルにはPixellabelid列があります。

  • 2つにつにつにがためため，ははHierarchy列をまし。これがのラベルにされててます。

  • ラベル定义グループ割り当てられてい，すべてのラベルののGroup列が'None'になっています。

メモ

ラベラー アプリは、ピクセル ID が 1 ～ 255 のピクセル データのみを読み込むことができます。

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

roi roiとシーンのラベル。イメージコレクションはははは桌子，ビデオイメージシーケンスのははtimetableとして指定します。LabelDataの各列がつの定义のをを，，，LabelDefinitionsの各行のnameの値に対応します。これらのLabelDataはテーブル要素表します。ラベルははlabelType列挙値として指定されます。

または，ごとにグループ化されたたラベルラベルデータの场合，，ROILabelDataという付いたの列をし，，，矩形，PolygonData，线Data，ProjcuboidDataのうち少なくともつのタイプ含む构造体指定でき。。

各ラベル タイプのストレージ形式を表に示します。

ラベルのタイプ 各タイムでのラベル形式形式
labelType.Rectangle

[X，Y，W，H]形式のm行 4 列の数値行列。ここで、

  • mは，にれるラベルの数。。

  • Xとyは四角形の左上隅を指定します。

  • wは四角形の幅、つまり x 軸に沿った長さを指定します。

  • Hは四角形の高さ、つまり y 軸に沿った長さを指定します。

labeltype.cuboid

[xctr, yctr, zctr, xlen, ylen, zlen, xrot, yrot, zrot]形式の行もつm9列列行列。で，，，

  • mは，にれるラベルの数。。

  • Xctr，yctr，およびzctrは直方体の中心を指定します。

  • Xlen，ylen，およびzlenはにおけるにおけるにおけるx x y yおよびおよびおよびおよびおよび轴に沿っ直方直方体のの长ささ指定し

  • Xrot，yrot，およびzrotはそれぞれ、x 軸、y 軸、および z 軸に沿った直方体の回転角度を指定します。これらの角度は、それぞれが対応する軸の正方向を見たときに、時計回りが正となります。

次の図は、これらの値で直方体の位置がどのように決定されるかを示しています。

labelType.ProjectedCuboid

[x1, y1, w1, h1, x2, y2, w2, h2]形式のm行 8 列の数値ベクトル。ここで、

  • mは，にれるラベルの数。。

  • X1, y1は投影れ直方体のののx，y x，y座标座标指定し。。。。。

  • w1は，れた体の前面幅指定指定ますます。

  • H1は，れ直方体の前面さを指定し。。

  • X2, y2は投影れ直方体のののx，y x，y座标座标指定し。。。。。

  • w2は，投影された直方体の背面の幅を指定します。

  • H2は，投影された直方体の背面の高さを指定します。

次の図は、これらの値で直方体の位置がどのように決定されるかを示しています。

标记为投影的长方体
labelType.line

细胞配列のm行 1 列のベクトル。ここで、mは，含まれるラベルの数です各各配列配列配列，ポリラインののn个の点关する[x1 y1; x2 y2; ... ; xN yN]形式のn行 2 列の数値行列が含まれています。
labelType.PixelLabel

すべての定义のデータはは，，个のまたはフレームについて，，，，，，，，，，Pixellabeldata列に格納されます。各要素には、ピクセル ラベル イメージのファイル名が含まれます。ピクセル ラベル イメージは、対応するイメージに含まれる 1 つ以上のラベルを表します。ラベルは、1 チャネルまたは 3 チャネルのラベル行列で表すことができます。ラベラー アプリのいずれかでPixellabeldataを使用には，ががuint8型である単一チャネルのラベル行列を使用しなければなりません。3 チャネルのピクセル ラベル データ行列をプログラムで単一チャネルのラベル行列に変換して、ラベラー アプリで使用できます。
labelType.Polygon

细胞配列のm行 1 列のベクトル。ここで、mはラベル数。各各配列配列に，，のののn个の点关する[x1 y1; x2 y2; ... ; xN yN]形式のn行 2 列の数値行列が含まれます。
labelType.Custom 时间表的时间表ででさているに正确にされます。groundTruthMultisignalオブジェクトをグラウンド トゥルース ラベラーアプリインポート，このデータはアプリインポートさません。用のののラベルデータデータデータをを收集しし，アプリアプリででラベルさされたデータデータ

サポートされるれる

ビデオラベラー アプリ イメージ ラベラー アプリ
データソース ビデオファイルイメージシーケンスフォルダーリーダーリーダー イメージファイル
ラベル定義 Rectangle，线，Pixellabel，または场景ラベルタイプ Rectangle，线，Pixellabel，または场景ラベルタイプ
ラベル データ Rectangle，线，Pixellabel，または场景ラベル时间表 Rectangle，线，Pixellabel，または场景ラベルタイプの桌子（时间表なし）

ROI (Rectangle，线，Pixellabel）または场景ラベル カテゴリではないグラウンド トゥルース データをgroundTruthオブジェクトに追加するには、CustomのlabelTypeを使用するラベル定義を指定します。カスタム データは、ラベル付けアプリに読み込むときに表示されません。

オブジェクト关数

SelectLabelsByGroup 选择地面真相标签由标签组组成
selectLabelsByType Select ground truth labels by label type
SelectLabelsByName Select ground truth labels by label name
changeFilePaths Change file paths in ground truth data
gatherlabeldata Gather label data from ground truth

例

すべて折りたたむ

ライブ スクリプトを開く

イメージのコレクションからデータ ソースを作成します。

数据=负载（'stopSignsAndCars.mat'）；imageFileNames = data.stopsignsandcars.imagefilename（1：2）
ImageFileNames =2x1 cell{'stopSignImages/image001.jpg'} {'stopSignImages/image002.jpg'}
imageFileNames = fullfile（toolboxDir（'想象'），'visiondata'，，，，imageFilenames); dataSource = groundTruthDataSource(imageFilenames);

グラウンドトゥルースするに使用されるをしし。ラベルラベルののののををををを作成するするlabelDefinitionCreatorを使用します。

LDC = labeldefinitionCreator（）;Addlabel（LDC，'停止标志'，，，，labelType.Rectangle）；Addlabel（LDC，“ Carrear”，，，，labelType.Rectangle）；Labeldefs= create(ldc)
Labeldefs=2×5桌name Type LabelColor Group Description ____________ _________ __________ ________ ___________ {'stopSign'} Rectangle {0x0 char} {'None'} {' '} {'carRear' } Rectangle {0x0 char} {'None'} {' '}

四角形 ROI のラベル データを初期化します。

stopSignTruth = {[856 318 39 41];[445 523 52 54]}; carRearTruth = {[398 378 315 210];[332 633 691 287]};

table tableををします。。。

labelNames = {'停止标志';“ Carrear”};labelData = table(stopSignTruth,carRearTruth,'VariableNames'，，，，labelNames)
labelData=2×2 tablestopsign carrear _________________ ___________________ {[856 318 39 41]}} {[398 378 315 210]} {[445 523 52 54]} {[332 633 691 287]}

グラウンドトゥルースを作成し。。

gTruth = groundTruth(dataSource,labelDefs,labelData)
gTruth = groundTruth with properties: DataSource: [1x1 groundTruthDataSource] LabelDefinitions: [2x5 table] LabelData: [2x2 table]
ライブ スクリプトを開く

マークした車線を表すデータを格納するgroundTruthオブジェクトを作成します。

イメージからソースを作成。。

dataSource = groundTruthDataSource({'stopSignTest.jpg'}）；

グラウンドトゥルースするに使用されるをしし。ラベルラベルののののををををを作成するするlabelDefinitionCreatorを使用します。

LDC = labeldefinitionCreator（）;Addlabel（LDC，'车道'，，，，labelType.line）；Labeldefs= create(ldc);

イメージに 2 つの車線マーカーを割り当てます。

LANEMARKERTRUTH = {[257 254; 311 180] [327 183; 338 205; 374 250]}};

table tableををします。。。

labelNames = {'车道'};labeldata = table（lanemarkertruth，'VariableNames'，，，，labelNames)
labelData=桌子Lane ____________________________ {2x2 double} {3x2 double}

groundTruth オブジェクトを作成します。

gTruth = groundTruth(dataSource,labelDefs,labelData)
gTruth = groundTruth with properties: DataSource: [1x1 groundTruthDataSource] LabelDefinitions: [1x5 table] LabelData: [1x1 table]
ライブ スクリプトを開く

シーンの各部分を表すデータを格納するgroundTruthオブジェクトを作成します。

データソース作成します。

dataSource = groundTruthDataSource({'visionteam.jpg'}）；

table tableををするには，，，labelDefinitionCreatorを使用し。ラベル'Person'と'Background'を定義します。対応するラベルのタイプをPixellabelとして割り当てます。

ldc =labelDefinitionCreator(); addLabel(ldc,'Person'，labelType.pixellabel）;Addlabel（LDC，'Background'，labelType.pixellabel）;Labeldefs= create(ldc)
Labeldefs=2×6桌name Type LabelColor PixelLabelID Group Description ______________ __________ __________ ____________ ________ ___________ {'Person' } PixelLabel {0x0 char} {[1]} {'None'} {' '} {'Background'} PixelLabel {0x0 char} {[2]} {'None'} {' '}

イメージのピクセル ラベル データの位置を指定します。

datafile = {'VisionTeamPixellabels.png'}
dataFile =1x1 cell array{'visionteamPixelLabels.png'}

ピクセルラベルのラベルのののををし。。。。

labeldata = table（datafile，'VariableNames'，{'Pixellabeldata'}）
labelData=桌子PixelLabelData  _____________________________ {' 力ionteamPixelLabels.png'}

groundTruthオブジェクトを作成します。

gTruth = groundTruth(dataSource,labelDefs,labelData)
gTruth = groundTruth with properties: DataSource: [1x1 groundTruthDataSource] LabelDefinitions: [2x6 table] LabelData: [1x1 table]
ライブ スクリプトを開く

ビデオからソースを作成。。

VideoName ='caltech_cordova1.avi';dataSource = groundTruthDataSource（videoname）;

グラウンドトゥルースするに使用されるをしし。ラベルラベルののののををををを作成するするlabelDefinitionCreatorオブジェクトを使用ます。

LDC = labeldefinitionCreator（）;Addlabel（LDC，'Cars'，，，，labelType.Rectangle）；Addlabel（LDC，“ lanemarkers”，，，，labelType.line）；Labeldefs= create(ldc)
Labeldefs=2×5桌Name Type LabelColor Group Description _______________ _________ __________ ________ ___________ {'Cars' } Rectangle {0x0 char} {'None'} {' '} {'LaneMarkers'} Line {0x0 char} {'None'} {' '}

自動車と車線マーカーのラベル データを作成します。

numRows = numel(dataSource.TimeStamps); carsTruth = cell(numRows,1); laneMarkerTruth = cell(numRows,1);

2 つの自動車ラベルと 2 つの車線マーカーを最初のフレームに追加します。

CARSTRUTH {1} = [182 186 31 22; 404 191 53 34];LANEMARKERTRUTH {1} = {[257 254; 311 180] [327 183; 338 205; 374 250]}};

ラベル データの table を作成します。

labelNames = {'Cars'，，，，“ lanemarkers”};labelData = table(carsTruth,laneMarkerTruth,'VariableNames'，，，，labelNames);

groundTruthオブジェクトを作成します。このオブジェクトをラベル付けアプリにインポートするには、[開く]、[ラベルをインポート]メニューのを选択し。。

gTruth = groundTruth(dataSource,labelDefs,labelData)
gtruth =具有属性的地面图：dataSource：[1x1 theabluthdatasource] labeldefinitions：[2x5 table] labeldata：[250x2时间表]

ヒント

  • ビデオベースのデータ ソースのgroundTruthオブジェクトは，オペレーティング システムのビデオ読み取り機能に依存します。ビデオ データ ソースを使用して作成されたgroundTruthオブジェクトは，そのオブジェクトを作成するために使用された同じプラットフォームでのみ整合性を維持します。プラットフォーム固有のgroundTruthオブジェクトを作成するには、ビデオをイメージのシーケンスに変換し、関連付けられたタイムスタンプをイメージのシーケンスに含めます。

バージョン履歴

R2017Aで导入

参考

アプリ

关数

オブジェクト

トピック