主要内容

事实真相

地面真相标签数据

描述

这个事实真相对象包含有关数据源,标签定义和标记标签注释的信息,用于一组地面真实标签。您可以导出或导入事实真相对象来自图片标识视频贴标机应用。

  • 从阵列中创建对象检测器的训练数据事实真相对象,使用对象训练数据作用

  • 从数组中创建语义分段网络的训练数据事实真相对象,使用像素标签训练数据作用

创建

出口A.事实真相对象,在应用程序工具条上,选择出口标签>工作空间。应用程序将对象导出到MATLAB®创建一个事实真相对象,使用事实真相函数(此处描述)。

描述

实例

GTRUTH.=事实真相(数据源,拉贝尔德夫斯,Labeldata.)返回包含可以导入到的地面真理标签的对象图片标识视频贴标机应用。

  • 数据源指定地面实况数据的来源并设置数据来源所有物

  • 拉贝尔德夫斯指定地面真值数据的标签、子标签和属性定义,并设置标签定义所有物

  • Labeldata.指定标记标签的标识信息、位置和时间戳,并设置唇形目所有物

特性

展开全部

地面真理数据的来源,指定为a地面数据源对象。对象包含描述视频、图像序列或自定义数据源的信息,地面真实数据是从这些数据源标记的。

要从原始数据源访问图像,请使用录像机图像数据存储。您也可以使用自定义读取功能。有关详细信息,请参阅使用自定义图像源读写标记.

此属性是只读的。

标签定义,指定为表。若要创建此表,请使用以下选项之一。

  • 在其中一个标签应用程序中,创建标签定义,然后将其作为应用程序的一部分导出事实真相对象

  • 用一个LANENDEFINITIONCREATOR.对象生成标签定义表。如果将此表保存到MAT文件,则可以通过选择将标签定义加载到标签应用程序会话中负载>标签定义从应用程序工具条。

  • 在MATLAB命令行中创建标签定义表。

此表描述了中指定的表的必需列和可选列标签定义所有物

描述 必需或可选
姓名 指定每个标签定义的名称的字符串或字符向量。

要求的

类型 唇形指定每个标签定义类型的枚举,例如长方形场景.

要求的

唇彩 指定标签定义颜色的RGB三元组的1×3行向量。值的范围为[0,1]。黄色(RGB三元组[1 1 0])是为标签应用程序中选定标签的颜色保留的。

可选择的

在标签应用程序中定义标签时,必须指定颜色。因此,导出的标签定义表始终包含此列。

使用创建标签定义时LANENDEFINITIONCREATOR.对象,则返回的标签定义表包含此列,但所有列值均为空。

像素标签 标量,列向量或M-3-3整数值标签ID的矩阵。像素标签指定用于表示标签定义的像素标签值。像素标签ID值必须介于0和255之间。

可选择的

在标签应用程序或中定义像素标签时LANENDEFINITIONCREATOR.对象,生成的标签定义表包括此列。

在MATLAB命令行中创建标签定义表时,如果类型labelType.PixelLabel对于任何标签,则此列是必需的。

指定每个标签定义所属组的字符串或字符向量。

可选择的

如果在MATLAB命令行中创建标签定义表,则不需要包含柱子。

如果从标签应用程序导出标签定义或使用LANENDEFINITIONCREATOR.对象,标签定义表包含此列,即使您未指定组。该应用程序分配每个标签定义a价值'没有任何'.

描述 描述每个标签定义的字符串或字符向量。

可选择的

如果在MATLAB命令行中创建标签定义表,则不需要包含描述柱子。

如果从标签应用程序导出标签定义或使用LANENDEFINITIONCREATOR.对象的标签定义表中包含此列,即使您没有指定说明描述对于这些标签定义,是一个空字符向量。

等级制度 包含每个标签定义的子标签和属性数据的结构等级制度格式,参见开始使用图像标签开始使用视频贴标程序.

可选择的

在标记应用程序中,当您定义子制造或属性时,导出的事实真相对象包括此列。

例如,考虑一个名为标签定义的表,植被,车道,停止标志交通工具,这是从视频贴标机应用程序。

  • 标签定义包括像素标签,因此表中包含像素标签柱子。

  • 其中两个标签包含属性,因此应用程序创建了一个等级制度适用于所有标签定义的列。

  • 标签定义没有指定的组,因此列是'没有任何'用于所有标签定义。

笔记

Labeler应用程序只能加载像素ID介于1和255之间的像素数据。

此属性是只读的。

每个ROI和场景标签的标签数据,指定为a桌子用于图像收集或时间表用于视频或图像序列。每列唇形目保存单个标签定义的标签,并与姓名中每行的值标签定义.这些唇形目描述表的元素。标签类别指定为唇形枚举。

或者,对于由标签类型分组的ROI标签数据,标记为单列罗勒贝达,可以使用并指定为包含至少一个标签类型的结构,矩形数据,远志,线条数据ProjCuboidData.

表中描述了每种标签类型的存储格式。

标签类型 每个时间戳处标签的存储格式
标签类型。矩形

M-形式的by-4数字矩阵[x,y,w,h], 在哪里:

  • M是框架中的标签数。

  • xY指定矩形的左上角。

  • W指定矩形的宽度,即沿矩形的长度x-轴。

  • H指定矩形的高度,即其沿矩形的长度Y-轴。

唇形长方体

M-by-9数字矩阵,具有形式的行[XCTR,YCTR,ZCTR,Xlen,Ylen,Zlen,Xrot,Yrot,Zrot], 在哪里:

  • M是框架中的标签数。

  • XCTR.,yctr.ZCTR.指定长方体的中心。

  • xlen.,ylen.Zlen.指定长方体沿直线的长度x-轴,Y- 轴,和Z旋转之前,分别在旋转之前分别进行速度。

  • 克洛特,yrot.Zrot.指定长方体沿轴的旋转角度x-轴,Y- 轴,和Z-分别为轴。从相应轴的前进方向看,这些角度为顺时针正值。

该图显示了这些值如何确定长方体的位置。

labelType.ProjectedCuboid

M-形式的by-8向量[x1,y1,w1,h1,x2,y2,w2,h2], 在哪里:

  • M是框架中的标签数。

  • x1,y1指定x,Y坐标,用于投影长方体前面的左上位置

  • W1.指定投影长方体正面的宽度。

  • h1指定投影长方体正面的高度。

  • x2,y2指定x,Y投影长方体背面左上方位置的坐标。

  • W2.指定投影多维模型背面的宽度。

  • 指定投影长方体背面的高度。

该图显示了这些值如何确定长方体的位置。

标记投影长方体

标号线

M-单元阵列的by-1向量,其中M是帧中的标签数。每个单元格数组包含一个N-2表格的2个数字矩阵[x1 y1;x2 y2;......xn yn]对于N多段线中的点。

labelType.PixelLabel

所有像素标签定义的标签数据存储在单个中M-By-1像素点M图像或帧。每个元素包含像素标签图像的文件名。像素标签图像描述相应图像中包含的一个或多个标签。标签可以描述为1通道或3通道标签矩阵。若要使用像素点使用任何贴标程序应用程序,您必须使用单声道标签矩阵,其中值为类型uint8..您可以以编程方式将3通道像素标记数据矩阵转换为单声道标签矩阵以与贴标程序应用程序一起使用。

labelType.多边形

M-单元阵列的by-1向量,其中M是标签数。每个单元格数组包含一个N-2表格的2个数字矩阵[x1 y1;x2 y2;......xn yn]对于N多边形中的点。

标签类型。自定义 标签的存储方式与时间表中指定的完全相同。如果导入TroundtruthmultiSignal.对象中包含自定义标签数据地面真理贴标机应用程序,此数据不会导入到应用程序中。收集用于培训的标签数据并将其与应用程序中的标签数据组合时,请使用自定义数据。

金宝app支持的地面实况对象

视频标签应用程序 图像标签应用程序
数据源 视频文件、图像序列文件夹、自定义读取器 图像文件
标签定义 长方形,线,像素标签场景标签类型 长方形,线,像素标签场景标签类型
标签数据 时间表长方形,线,像素标签场景标签类型 表(无时间表)长方形,线,像素标签场景标签类型

添加非投资回报率的基本事实数据(长方形,线,像素标签)或场景标签类别到a事实真相对象,提供带有唇形就是风俗。将自定义数据加载到标签应用程序时,该数据不可见。

目标函数

selectLabelsByGroup 按标签组选择地面真相标签
按类型选择标签 按标签类型选择地面真理标签
选择LabelsByName 按标签名称选择地面真相标签
更改文件路径 更改地面实况数据中的文件路径
合欢 从地面真相收集标签数据

例子

全部崩溃

从图像集合创建数据源。

数据=负载('stopsignsandcars.mat');imageFilename=data.stopSignsAndCars.imageFilename(1:2)
图像文件名=2x1细胞{'stopsignimages / image001.jpg'} {'stopsignimages / image002.jpg'}
imageFilenames=fullfile(toolboxdir(“愿景”),'VisionData',imagefilenames);datasource = toundtreveataSource(imagefilenames);

定义用于指定基本事实的标签。使用LANENDEFINITIONCREATOR.创建标签定义表。

ldc=labelDefinitionCreator();添加标签(ldc,“停车标志”,labeltype.rectangle);addlabel(LDC,“卡雷尔”,labeltype.rectangle);labeldefs = create(LDC)
labeldefs =2×5表名称类型LabelColor组描述____________ _______________________________ {'stopsign'}矩形{0x0 char} {'none'} {''''} {''''} {''''} rentangle {0x0 char} {'none'} {''}

初始化矩形ROI的标签数据。

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

构造标签数据表。

标签名称={“停车标志”;“卡雷尔”};labeldata =表(stopsigntruth,carreartruth,'variablenames',标签名称)
labeldata =2×2表停车标志卡雷尔{[856 318 39 41]{[398 378 315 210]}{[445 523 52]}{[332 633 691 287]}

创建一个地面真相对象。

gtruth = toundtruth(dataSource,labeldefs,labeldata)
GTRUTH =带有属性的地面:DataSource:[1x1 TroundtruthDataSource] LabEldefinitions:[2x5表] Labeldata:[2x2表]

创建一个事实真相对象来存储表示标记道路车道的数据。

从图像创建数据源。

数据源=groundTruthDataSource({'stopsigntest.jpg'});

定义用于指定基本事实的标签。使用LANENDEFINITIONCREATOR.创建标签定义表。

ldc=labelDefinitionCreator();添加标签(ldc,“莱恩”,labelType.Line);labelDefs=create(ldc);

在图像中分配两个车道标记。

laneMarkerTruth={[257254;311180][327183;338205;374250]};

构造标签数据表。

标签名称={“莱恩”};labelData=表格(laneMarkerTruth,'variablenames',标签名称)
labeldata =桌子车道{2x2双倍}{3x2双倍}

创建一个groundTruth对象。

gtruth = toundtruth(dataSource,labeldefs,labeldata)
gtruth =带有属性的地面:DataSource:[1x1 ToundTruthDataSource] LabEledefinitions:[1x5表] Labeldata:[1x1表]

创建一个事实真相对象来存储表示场景部分的数据。

创建一个数据源。

数据源=groundTruthDataSource({“visiontam.jpg”});

使用LANENDEFINITIONCREATOR.创建标签定义表。定义标签,'人'“背景”. 将其相应的标签类型指定为像素标签.

ldc=labelDefinitionCreator();添加标签(ldc,'人',labelType.PixelLabel);addLabel(ldc,“背景”,labelType.PixelLabel);labelDefs=create(ldc)
labeldefs =2×6表名称类型LabelColor Pixellabelid组描述______________ _____________________________________________________________0 char} {[1]} {'none'} pixellabel {0x0 char} {[2]} {'没有任何'} {' '}

指定图像的像素标签数据的位置。

数据文件={“VisionTempixellabels.png”}
数据文件=1x1单元阵列{'visiontampixellabels.png'}

为像素标签数据构建标签数据表。

labelData=表格(数据文件,'variablenames',{“PixelLabelData”})
labeldata =桌子像素标签数据{visiontempixellabels.png}

创建一个事实真相对象

gtruth = toundtruth(dataSource,labeldefs,labeldata)
GTRUTH =带有属性的地面:DataSource:[1x1 ToundTruthDataSource] LabEldefinitions:[2x6表] Labeldata:[1x1表]

从视频创建数据源。

视频名称=“加州理工学院科尔多瓦1.avi”;数据源=groundTruthDataSource(videoName);

定义用于指定基本事实的标签。使用aLANENDEFINITIONCREATOR.对象创建标签定义表。

ldc=labelDefinitionCreator();添加标签(ldc,'汽车',labeltype.rectangle);addlabel(LDC,“LaneMarkers”,labelType.Line);labelDefs=create(ldc)
labeldefs =2×5表名称类型LabelColor组描述

为汽车和车道标记创建标签数据。

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

将两个汽车标签和两个车道标记添加到第一帧。

carsTruth{1}=[182 186 31 22;404 191 53 34];laneMarkerTruth{1}={[257254;311180][327183;338205;374250]};

创建标签数据表。

标签名称={'汽车',“LaneMarkers”};labelData=表格(carsTruth、laneMarkerTruth、,'variablenames',标签名称);

创建一个事实真相对象。要将此对象导入标签应用程序,请从打开>导入标签菜单

gtruth = toundtruth(dataSource,labeldefs,labeldata)
gTruth=具有属性的groundTruth:数据源:[1x1 groundTruthDataSource]LabelDefinitions:[2x5表]LabelData:[250x2时间表]

提示

  • 事实真相基于视频的数据源的对象依赖于操作系统的视频读取功能。A事实真相使用视频数据源创建的对象仅在用于创建它的同一平台上保持一致。要创建独立于平台的事实真相对象,将视频转换为图像序列,并包括与图像序列相关联的时间戳。

R2017a中引入