主要内容

gatherLabelData

从地面实况收集标签数据

描述

例子

labelData= gatherLabelData (gTruthtypeOfLabel返回从地面真实数据收集的标签数据,gTruth.函数返回指定的标签数据typeOfLabel

labelData时间戳= gatherLabelData(___另外,使用前面语法中的参数返回与收集的标签数据关联的图像时间戳。

___= gatherLabelData(___名称,值使用名称,值对参数指定如何收集数据。

例子

全部折叠

从groundtruth图像中收集所有的多边形标签。

数据=负载(“groundtruthVisionTeam.mat”);gtruth = data.groundtruthVisionTeam;

收集所有多边形对象。

labelData = gatherLabelData(gtruth, labelType(“多边形”),“GroupLabelData”“LabelType”);polygondata {1}.PolygonData{1}(:,1);polygonLabels = labelData{1}.PolygonData{1}(:,2);

可视化多边形标签。

Im = imread(“visionteam.jpg”);imshow (im);showShape (“多边形”、多边形“标签”, polygonLabels);

输入参数

全部折叠

地面真相数据,指定为agroundTruth的对象或向量groundTruth对象。

要从中收集标签数据的标签类型,指定为的向量labelType对象。的gatherLabelData函数从中收集标签数据groundTruth由input指定的。gTruth属性指定的标签名称或标签类型将标签数据分组到列中GroupLabelData名称-值参数。

有效枚举类型

您可以指定这些枚举类型中的一个或多个。

  • labelType。矩形-矩形ROI标签

  • labelType。长方体-长方体ROI标签(点云)

  • labelType。ProjectedCuboid-投影的长方体ROI标签(图像和视频数据)

  • labelType。行-线ROI标签

  • labelType。PixelLabel-像素ROI标签

  • labelType。多边形-像素ROI标签

  • labelType。场景-场景标签

若要为场景收集标签数据,必须指定labelTypes随着labelType。场景枚举标量。不能指定任何其他标签类型labelType。场景

名称-值参数

的可选逗号分隔对名称,值参数。的名字参数名称和价值对应的值。的名字必须出现在引号内。您可以以任意顺序指定多个名称和值对参数Name1, Value1,…,的家

例子:SampleFactor5每5帧掉落一次。

抽样因子用于子抽样标签数据,指定为正整数。的抽样因子K包括每一个K框架。增加采样因子以从高采样率的信号(如视频)中删除冗余帧。

根据标签数据对列进行分组,指定为“LabelName”“LabelType”

  • “LabelName”—根据标签定义对标签数据进行分组。

  • “LabelType”—根据标签类型对标签数据进行分组。此选项可用于收集标签数据,标签类型保留感兴趣的区域(ROI)堆叠顺序。

输出参数

全部折叠

标签数据,返回为——- - - - - -1表的单元格数组,其中:groundTruth对象gTruth.表的列表示按标签名称或标签类型分组的标签数据,标签类型由GroupLabelData名称-值参数。

对于表中的每个单元格,返回的标签数据的格式取决于标签的类型。

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

-by-4数值矩阵的形式[x, y, w, h],地点:

  • 是帧中标签的数量。

  • x而且y指定矩形的左上角。

  • w指定矩形的宽度,即矩形沿x设在。

  • h指定矩形的高度,即矩形沿y设在。

labelType。长方体

-by-9数字矩阵的行形式[xctr, yctr, zctr, xlen, ylen, zlen, xrot, yrot, zrot],地点:

  • 是帧中标签的数量。

  • xctryctr,zctr指定长方体的中心。

  • xlenylen,zlen指定长方体沿的长度x设在,y设在,z-轴,在应用旋转之前。

  • xrotyrot,zrot指定长方体沿的旋转角度x设在,y设在,z分别设在。当观察它们对应轴的正向时,这些角是顺时针正的。

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

labelType。ProjectedCuboid

这个形式的- × 8向量[x1, y1, w1, h1, x2, y2, w2, h2],地点:

  • 是帧中标签的数量。

  • (x1, y1)指定了xy投影长方体正面左上角位置的坐标

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

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

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

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

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

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

标记投影长方体

labelType。行

单元格数组的-by-1向量,其中是帧中标签的数量。每个单元格数组包含一个N-by-2数值矩阵的形式[(x1, y1;x2 y2;...;xN yN)N折线上的点。

labelType。PixelLabel

所有像素标签定义的标签数据存储在单个标签中1PixelLabelData图像或框架。每个元素都包含像素标签图像的文件名。像素标签图像描述了对应图像中包含的标签。标签可以描述为1通道或3通道标签矩阵。使用PixelLabelData对于任何标签应用程序,都必须使用单通道标签矩阵,其中的值为类型uint8.您可以通过编程方式将3通道像素标签数据矩阵转换为单通道标签矩阵,以便与标签器应用程序一起使用。

labelType。多边形

单元格数组的-by-1向量,其中是标签的数量。每个单元格数组包含一个N-by-2数值矩阵的形式[(x1, y1;x2 y2;...;xN yN)N多边形上的点。

labelType。场景 逻辑1真正的)如果应用了场景标签,否则符合逻辑0

返回的时间戳——- - - - - -1单元格阵列持续时间向量,地点:

  • groundTruth对象gTruth

  • labelData {m}控件中的时间戳thgroundTruth的对象gTruth

限制

  • gatherLabelData函数不为子标签或属性收集标签数据。如果标签包含子标签或属性,则在labelData输出时,函数只返回父标签的位置。

R2021a中引入