class AprilTag -- AprilTag 对象
apriltag 对象是由 Image.find_apriltags() 返回的 attrtuple。每个实例描述一个已解码的 AprilTag:其边界框、亚像素质心、家族/id、解码器质量度量、四个检测到的角点,以及——当向 Image.find_apriltags() 提供内参时——在摄像头坐标系下的 6 自由度位姿估计。
字段可通过属性名(tag.id)或索引(tag[0])访问。该对象没有公共构造函数。
apriltag
class image.apriltag
请调用 Image.find_apriltags() 来创建该对象。
边界框与角点
apriltag.x
x
边界框左上角 x 坐标,以像素为单位。整数。索引 [0]。
apriltag.y
y
边界框左上角 y 坐标,以像素为单位。整数。索引 [1]。
apriltag.w
w
边界框宽度,以像素为单位。整数。索引 [2]。
apriltag.h
h
边界框高度,以像素为单位。整数。索引 [3]。
apriltag.cx
cx
质心 x 坐标,四舍五入为整数。整数。索引 [4]。
apriltag.cy
cy
质心 y 坐标,四舍五入为整数。整数。索引 [5]。
apriltag.cxf
cxf
质心 x 坐标,为亚像素浮点数。索引 [9]。
apriltag.cyf
cyf
质心 y 坐标,为亚像素浮点数。索引 [10]。
apriltag.corners
corners
标签四个检测到的角点的 (x, y) 整数元组组成的 4 元组,从左上角开始按顺时针排序。索引 [21]。
apriltag.area
area
边界框的面积(w * h)。整数。索引 [22]。
apriltag.rect
rect
边界框的 (x, y, w, h) 4 元组。适合直接传给诸如 Image.draw_rectangle() 或 Image.crop() 之类的绘制/裁剪方法。索引 [23]。
标识
apriltag.id
id
标签在其家族内的数字 id。有效范围取决于家族(例如 TAG36H11 为 0 到 586)。整数。索引 [6]。
apriltag.family
family
数字家族标识符,为以下之一:
整数。索引 [7]。
apriltag.name
name
家族名称字符串,例如 "TAG36H11"。索引 [8]。
匹配质量
apriltag.decision_margin
decision_margin
标签匹配的质量,范围为 0.0 到 1.0,其中 1.0 最佳。可用它来剔除低置信度的检测结果。浮点数。索引 [12]。
apriltag.hamming
hamming
解码器为此标签接受的位错误数量。受家族的纠错能力限制:
TAG36H11-> 最多 4 个位错误
越低越好。整数。索引 [13]。
apriltag.goodness
goodness
标签的图像质量,范围为 0.0 到 1.0,其中 1.0 最佳。在已发布的固件中目前始终为 0.0(底层解码器不再计算此度量)。浮点数。索引 [14]。
位姿估计
下面的平移和旋转字段仅在以 fx、fy、cx 和 cy 摄像头内参调用 Image.find_apriltags() 时才会被填充。没有内参时它们为 0.0。标签被假定为 1 个单位宽,因此平移以“标签宽度”为单位——乘以真实世界的标签尺寸即可得到以米制为单位的距离。
apriltag.x_translation
x_translation
相对摄像头的 X 平移(左右),以标签宽度为单位。浮点数。索引 [15]。
apriltag.y_translation
y_translation
相对摄像头的 Y 平移(上下),以标签宽度为单位。浮点数。索引 [16]。
apriltag.z_translation
z_translation
相对摄像头的 Z 平移(前后),以标签宽度为单位。浮点数。索引 [17]。
apriltag.x_rotation
x_rotation
绕 X 轴的旋转(俯仰),以弧度为单位。浮点数。索引 [18]。
apriltag.y_rotation
y_rotation
绕 Y 轴的旋转(偏航),以弧度为单位。浮点数。索引 [19]。
apriltag.z_rotation
z_rotation
绕 Z 轴的旋转(翻滚),以弧度为单位。与 rotation 值相同——为与 x_rotation 和 y_rotation 对称而重复。浮点数。索引 [20]。
apriltag.rotation
rotation
标签在图像平面内的旋转,以弧度为单位。等于 z_rotation。浮点数。索引 [11]。