两个点位之间求距离

功能描述

该算子用于计算两点之间的欧氏距离,可以计算三维空间中的直线距离(XYZ),也可以只考虑特定轴或轴平面上的投影距离(如仅X轴距离、仅Y轴距离、仅Z轴距离、XY平面距离、XZ平面距离、YZ平面距离)。

支持多种输入模式:计算两个点列表之间对应点的距离、计算一个点与一个点列表中所有点的距离,或者计算一个点列表中的所有点与一个在参数中定义的固定点之间的距离。

使用场景

  • 距离测量 : 计算两个定位点、特征点或物体中心之间的空间距离。

  • 条件判断 : 根据两个物体或特征点之间的距离是否满足特定条件(例如,小于安全距离、大于抓取距离)来进行决策。

  • 相对定位 : 分析一个点相对于另一个点(或固定参考点)在特定轴向上的距离。

输入输出

输入项

位置一: 包含一个或多个三维点坐标 [X, Y, Z] 的列表,可以由拆分抓取点或抓取物位姿节点获取。

位置二 : 包含一个或多个三维点坐标 [X, Y, Z] 的列表。当参数“是否求取跟固定点距离”的开关为开启状态时,此输入端口无效。

输出项

两点距离: 包含计算得到的距离值的列表。列表长度取决于输入模式:

  • 如果输入列表长度相等(N vs N),则输出 N 个距离值。

  • 如果一个输入是单个点,另一个是 N 个点,则输出 N 个距离值。

参数说明

输入列表长度匹配 :

如果求取到固定点距离开关状态为关闭,则位置一和位置而二的长度必须相等(例如,都包含N个点,计算N对点之间的距离),或者其中一个列表只包含1个点(计算这1个点与另一个列表中所有N个点之间的距离)。如果长度不匹配且都不是1,算子会报错。

指定轴或轴组合求距离方式

参数说明

选择在计算距离时考虑哪些坐标轴。

调参说明

  • XYZ (默认) : 计算三维空间中的直线距离。

  • X / Y / Z : 只计算在单个轴上的距离。

  • XY / XZ / YZ : 计算在指定二维平面上的投影距离。

是否求取跟固定点距离

参数说明

控制是计算两个输入列表之间的距离,还是计算输入列表位置一与一个固定点之间的距离。

调参说明

  • 关闭(默认): 计算位置一和位置二之间的距离。

  • 开启: 忽略位置二输入端口,计算位置一中的每个点与“固定点位置”参数定义的那个固定点之间的距离。

固定点位置

参数说明

当“是否求取跟固定点距离”开关为开启状态时生效,定义用于计算距离的固定参考点的三维坐标 [X, Y, Z]。

调参说明

在此输入一个固定的三维坐标值,例如 [100, 200, 300],位置一中的每个点都将与这个点计算距离。