Robot Behaviors

This catalog shows the list of behaviors according to the tasks that they perform.

Note

For more information about what a behavior is, please refer to the Behaviors section, or how they interact with other Aerostack2 components at Architecture section.

Motion Behaviors

Motion Behaviors
Name	Description	Parameters
Take Off	Change the state of the aircraft from landed to flying. For that, the aircraft must be armed and in offboard mode	Height: desired take off height from the starting point, in meters (m) Speed: desired take off speed movement, in meters per second (m/s)
Land	Change the state of the aircraft from flying to landed. Also disarm it	Speed: desired landing speed movement, in meters per second (m/s)
Go To	Move the aircraft to a given position in the desired frame	Yaw: desired mode Target pose: desired position in the desired frame, in meters (m) Max speed: desired speed movement, in meters per second (m/s)
Follow Path	Move the aircraft along a given path in the desired frame	Header: desired frame of the path Yaw: desired mode Path: desired path with a list of poses with id. Max speed: desired speed movement, in meters per second (m/s)
Follow Reference Behavior	Keep the aircraft at given pose reference in the desired frame through a runtime-selectable plugin (position or trajectory).	Yaw: desired yaw mode. Target pose: desired reference point in the given frame (m). Max speed: desired speed per axis (m/s).

Perception Behaviors

Perception Behaviors
Name	Description	Parameters
Object Perception Behavior	Plugin-based perception pipeline that processes camera images and publishes the detected objects (e.g. ArUco markers), including their image location and optional 3D pose.	Threshold: minimum confidence score in the range [0.0, 1.0] for a detection to be accepted. Target classes: list of class ids to detect (e.g. ArUco marker ids). If empty, every detected object is reported.

Trajectory Generation Behaviors

Trajectory Generation Behaviors
Name	Description	Parameters
Generate Polynomial Trajectory Behavior	Convert a list of waypoints into a smooth trajectory through a runtime-selectable plugin (dynamic_mav, mav, jerk_limited or gcopter).	Yaw: desired yaw mode. Path: list of waypoints with id. Max speed: desired speed along the path (m/s). Start on paused: if true, generate the trajectory and stay paused until the client resumes.

Parameter Estimation Behaviors

Parameter Estimation Behaviors
Name	Description	Parameters
Mass Estimation Behavior	Estimate the mass of the platform using the aceleracion in the z axis and the thrust command to the motors.
Force Estimation Behavior	Estimate the difference between the commanded thrust and the thrust being executed by the platform.

Swarm Flocking Behaviors

Swarm Flocking Behaviors
Name	Description	Parameters
Swarm Flocking Behavior	Generates a dynamic Swarm structure around a centroid in order to move the drones in formation.	Virtual Centroid: Desired pose offset of the virtual centroid with respect to the frame it must follow. Swarm Formation: List of desired poses, including the ID of each drone in the swarm, with respect to the virtual centroid. Drone Namespace: List of the drone namespaces in the swarm. It must be in the same order as the swarm formation list.

Payload Behaviors

Payload Behaviors
Name	Description	Parameters
Gripper Behavior	Control a gripper to pick up and release objects.	Gripper request: It is a bool msg where true means to start the closing action and false means to start the opening action.