Understanding actions:理解动作(Action)

简介: Understanding actions:理解动作(Action)

@[toc]

动作(Action)介绍

动作(Action)是ROS 2中的通信类型之一,旨在用于长期运行的任务。它们由三部分组成:目标(goal)、反馈(feedback)和结果(result)。

动作是建立在话题和服务之上的。它们的功能类似于服务,只是动作可以被取消。它们也提供稳定的反馈,而服务只返回单一的响应。

行动使用一个客户端-服务器(client-server)模型,类似于发布者-订阅者(publisher-subscriber)模型(在Understanding topics:理解话题(Topic)教程中讲过)。一个“动作客户端(action client)”节点向“动作服务器(action server)”节点发送一个目标,该节点确认该目标并返回反馈流和结果。
Action-SingleActionClient.gif

1. 准备工作

打开两个终端,分别运行:

ros2 run turtlesim turtlesim_node
ros2 run turtlesim turtle_teleop_key

2. 使用动作

当你启动 /teleop_turtle 节点时,你会在终端看到以下信息:

Use arrow keys to move the turtle.
Use G|B|V|C|D|E|R|T keys to rotate to absolute orientations. 'F' to cancel a rotation.

让我们关注第二行,它对应的是一个动作。(第一条指令对应于 "cmd_vel " 主题,在前面的主题Understanding topics:理解话题(Topic)教程中讨论过。)

请注意,在美式QWERTY布局的键盘上,字母键 G|B|V|C|D|E|R|T 在 F 键周围形成了一个 "盒子"。每个键在 F 周围的位置与 turtlesim 中的方向相对应。例如, E 键将把乌龟的方向旋转到左上角。

image.png
请注意运行 /turtlesim 节点的终端。每当你按下其中一个键,你就向作为 /turtlesim 节点一部分的动作服务器发送一个目标。这个目标是将乌龟旋转到一个特定的方向。一旦乌龟完成了旋转,就会出现一条转达目标结果的信息:

F 键将取消一个正在执行的目标。

试着按下 C 键,然后在乌龟完成旋转前按下F键。在运行/turtlesim 节点的终端,你会看到这样的信息:

不仅客户端(你在teleop中的输入)可以停止一个目标,而且服务器端( /turtlesim 节点)也可以。当服务器端选择停止处理一个目标时,它被称为“中止(abort)”这个目标。

试着在第一次旋转完成之前按 D 键,然后按 G 键。在运行 /turtlesim 节点的终端中,你会看到这样的信息:

这个动作服务器选择中止第一个目标,因为它得到了一个新的目标。它可以选择其他的方式,比如拒绝新的目标或者在第一个目标完成后执行第二个目标。不要假设每个动作服务器在得到一个新目标时都会选择中止当前目标。

3. ros2 node info 命令

要查看 /turtlesim 节点的动作,请打开一个新的终端并运行命令:

ros2 node info /turtlesim

这将返回一个列表,列出 /turtlesim 的订阅者、发布者、服务、动作服务器和动作客户端:

/turtlesim
  Subscribers:
    /parameter_events: rcl_interfaces/msg/ParameterEvent
    /turtle1/cmd_vel: geometry_msgs/msg/Twist
  Publishers:
    /parameter_events: rcl_interfaces/msg/ParameterEvent
    /rosout: rcl_interfaces/msg/Log
    /turtle1/color_sensor: turtlesim/msg/Color
    /turtle1/pose: turtlesim/msg/Pose
  Service Servers:
    /clear: std_srvs/srv/Empty
    /kill: turtlesim/srv/Kill
    /reset: std_srvs/srv/Empty
    /spawn: turtlesim/srv/Spawn
    /turtle1/set_pen: turtlesim/srv/SetPen
    /turtle1/teleport_absolute: turtlesim/srv/TeleportAbsolute
    /turtle1/teleport_relative: turtlesim/srv/TeleportRelative
    /turtlesim/describe_parameters: rcl_interfaces/srv/DescribeParameters
    /turtlesim/get_parameter_types: rcl_interfaces/srv/GetParameterTypes
    /turtlesim/get_parameters: rcl_interfaces/srv/GetParameters
    /turtlesim/list_parameters: rcl_interfaces/srv/ListParameters
    /turtlesim/set_parameters: rcl_interfaces/srv/SetParameters
    /turtlesim/set_parameters_atomically: rcl_interfaces/srv/SetParametersAtomically
  Service Clients:

  Action Servers:
    /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute
  Action Clients:

请注意,/turtle1/rotate_absolute 的动作是在 Action Servers 下面。这意味着 /turtlesim 对 /turtle1/rotate_absolute 动作做出反应并提供反馈。

ros2 node info /teleop_turtle
/teleop_turtle
  Subscribers:
    /parameter_events: rcl_interfaces/msg/ParameterEvent
  Publishers:
    /parameter_events: rcl_interfaces/msg/ParameterEvent
    /rosout: rcl_interfaces/msg/Log
    /turtle1/cmd_vel: geometry_msgs/msg/Twist
  Service Servers:
    /teleop_turtle/describe_parameters: rcl_interfaces/srv/DescribeParameters
    /teleop_turtle/get_parameter_types: rcl_interfaces/srv/GetParameterTypes
    /teleop_turtle/get_parameters: rcl_interfaces/srv/GetParameters
    /teleop_turtle/list_parameters: rcl_interfaces/srv/ListParameters
    /teleop_turtle/set_parameters: rcl_interfaces/srv/SetParameters
    /teleop_turtle/set_parameters_atomically: rcl_interfaces/srv/SetParametersAtomically
  Service Clients:

  Action Servers:

  Action Clients:
    /turtle1/rotate_absolute: turtlesim/action/RotateAbsolute

/teleop_turtle 节点在动作客户端下有 /turtle1/rotate_absolute 的名字,意味着它为该动作名称发送目标。

4. ros2 action list 命令

要识别ROS图中的所有动作,运行命令:

ros2 action list

返回结果如下:

/turtle1/rotate_absolute

这是目前ROS图中唯一的动作。它控制乌龟的旋转,正如你之前看到的那样。通过使用 ros2 node info \<node_name> 命令,你也已经知道这个动作有一个动作客户端( /teleop_turtle 的一部分)和一个动作服务器( /turtlesim 的一部分)。

4.1. ros2 action list -t 命令

动作有类型,类似于话题和服务。要找到 /turtle1/rotate_absolute 的类型,运行命令:

ros2 action list -t

返回结果如下:

/turtle1/rotate_absolute [turtlesim/action/RotateAbsolute]

在每个动作名称(本例中只有 /turtle1/rotate_absolute )右边的括号里是动作类型,turtlesim/action/RotateAbsolute 。当你想从命令行或代码中执行一个动作时,你会需要它。

5. ros2 action info 命令

你可以用以下命令进一步查看 /turtle1/rotate_absolute 动作:

ros2 action info /turtle1/rotate_absolute

返回结果如下:

Action: /turtle1/rotate_absolute
Action clients: 1
    /teleop_turtle
Action servers: 1
    /turtlesim

/teleop_turtle 节点有一个动作客户端,/turtlesim 节点有一个 /turtle1/rotate_absolute 动作的动作服务器。

6. ros2 interface show 命令

在自己发送或执行动作目标之前,你还需要一个信息,就是动作类型的结构。

在运行命令 ros2 action list -t 时知道了 /turtle1/rotate_absolute 的类型是 turtlesim/action/RotateAbsolute 。在你的终端中输入以下带有动作类型的命令:

ros2 interface show turtlesim/action/RotateAbsolute

返回结果如下:

# The desired heading in radians
float32 theta
---
# The angular displacement in radians to the starting position
float32 delta
---
# The remaining rotation in radians
float32 remaining

这个消息的第一部分,在---之上,是目标(goal)请求的结构(数据类型和名称)。接下来的部分是结果(result)的结构。最后一节是反馈(feedback)的结构。

7. ros2 action send_goal 命令

现在,让我们用下面的语法从命令行发送一个动作目标:

ros2 action send_goal <action_name> <action_type> <values>

\<values> 需要是YAML格式的。

注意观察turtlesim窗口,并在终端输入以下命令:

ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute "{theta: 1.57}"

你应该看到乌龟在旋转,并在你的终端中看到以下信息:

Waiting for an action server to become available...
Sending goal:
   theta: 1.57

Goal accepted with ID: f8db8f44410849eaa93d3feb747dd444

Result:
  delta: -1.568000316619873

Goal finished with status: SUCCEEDED

所有目标都有一个独特的ID,显示在返回信息中。你也可以看到结果,一个名为 delta 的字段,它是到起始位置的位移。

要看到这个目标的反馈,需要在 ros2 action send_goal 命令中添加 --feedback :

ros2 action send_goal /turtle1/rotate_absolute turtlesim/action/RotateAbsolute "{theta: -1.57}" --feedback

你的终端将返回如下信息:

Sending goal:
   theta: -1.57

Goal accepted with ID: e6092c831f994afda92f0086f220da27

Feedback:
  remaining: -3.1268222332000732

Feedback:
  remaining: -3.1108222007751465

…

Result:
  delta: 3.1200008392333984

Goal finished with status: SUCCEEDED

你将继续收到反馈,即剩余的弧度,直到目标完成。

目录
相关文章
|
4月前
|
自然语言处理 机器人
ROS2教程 08 动作Action
本文是关于ROS2(机器人操作系统2)中动作(Action)机制的教程,详细介绍了动作的概念、ros2 action相关命令的使用,包括列出、发送目标、获取动作信息,并通过示例代码展示了如何创建动作服务端(Action Server)和客户端(Action Client),以及如何实现动作的执行、反馈和结果处理。
228 0
|
5月前
|
Web App开发 JavaScript
vue报错【解决方案】 [Violation] Added non-passive event listener to a scroll-blocking <some> event.
vue报错【解决方案】 [Violation] Added non-passive event listener to a scroll-blocking <some> event.
607 0
|
存储 机器学习/深度学习 人工智能
PTPCG: Efficient Document-level Event Extraction via Pseudo-Trigger-aware Pruned Complete Graph论文解读
据我们所知,我们目前的方法是第一项研究在DEE中使用某些论元作为伪触发词的效果的工作,我们设计了一个指标来帮助自动选择一组伪触发词。此外,这种度量也可用于度量DEE中带标注触发词的质量。
136 1
|
自然语言处理 Java 测试技术
Saliency as Evidence: Event Detection with Trigger Saliency Attribution 论文解读
事件检测(ED)是事件抽取的关键子任务,它试图识别文本中特定类型的事件触发词。尽管ED取得了重大进展,但现有方法通常遵循“一个模型适合所有类型”的方法,这种方法认为事件类型之间没有差异,通常会导致相当倾斜的性能。
86 0
|
机器学习/深度学习 人工智能 自然语言处理
DualCor: Event Causality Extraction with Event Argument Correlations论文解读
事件因果关系识别(ECI)是事件因果关系理解的重要任务,其目的是检测两个给定文本事件之间是否存在因果关系。然而,ECI任务忽略了关键的事件结构和因果关系组件信息
111 0
|
机器学习/深度学习 数据挖掘
ACL2023 - An AMR-based Link Prediction Approach for Document-level Event Argument Extraction
最近的工作引入了用于文档级事件论元提取(文档级EAE)的抽象语义表示(AMR),因为AMR提供了对复杂语义结构的有用解释,并有助于捕获长距离依赖关系
202 0
|
JavaScript 开发工具 git
GitHub Actions:从使用action操作到自定义action操作
GitHub Actions:从使用action操作到自定义action操作
317 0
|
JSON Java API