move

Move Parrot drone in all six directions

Add-On Required: This feature requires the MATLAB Support Package for Parrot Drones add-on.

Syntax

move(parrotObj,Name,Value)

move(parrotObj,duration,Name,Value)

Description

move(parrotObj,Name,Value) moves the Parrot^® drone, represented by parrotObj, in all six directions based on attitude angles, rotation speed, and vertical speed specified as Name,Value pair arguments.

The following schematic shows the quadcopter axis characteristics :

The quadcopter body axis is centered in the center of gravity.

• The x-axis starts at the center of gravity and points in the direction along the nose of the quadcopter.

• The y-axis starts at the center of gravity and points to the right of the quadcopter.

• The z-axis starts at the center of gravity and points downward from the quadcopter, following the right-hand rule.

move(parrotObj,duration,Name,Value) moves the Parrot drone, represented by parrotObj, in all six directions based on attitude angles, rotation speed, and vertical speed specified as Name,Value pair arguments for the duration specified as duration.

Examples

Move Parrot Drone Diagonally Forward

Connect to a Parrot drone.

parrotObj = parrot('Mambo')

parrotObj = 
          parrot with properties:

                    Name: "Mambo"
                      ID: "Mambo_564853"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]

Use the parrot object to initiate takeoff of the Parrot drone.

takeoff(parrotObj)

While the Parrot drone is in flight, move the drone diagonally forward with a Pitch and Roll of -10 degrees and +10 degrees respectively for the default duration of 0.5 seconds.

move(parrotObj,'pitch',deg2rad(-10),'roll',deg2rad(10));

Move Parrot Drone Diagonally Backward For a Specified Duration

Connect to a Parrot drone.

parrotObj = parrot('Mambo')

parrotObj = 
          parrot with properties:

                    Name: "Mambo"
                      ID: "Mambo_564853"
                   State: "landed"
            BatteryLevel: 50%
        AvailableCameras: ["FPV"]

Use the parrot object to initiate takeoff of the Parrot drone.

takeoff(parrotObj)

While the Parrot drone is in flight, move the drone diagonally backward for 2 seconds with a Pitch and Roll of +10 degrees and +10 degrees respectively

move(parrotObj,2,'pitch',deg2rad(10),'roll',deg2rad(10));

Input Arguments

parrotObj — Parrot drone connection

parrot object

Parrot drone connection object, specified as a parrot object.

duration — Duration in seconds

0.5 seconds (default) | positive real scalar

The time for which the Parrot drone moves in the specified direction for the specified time. The default value is 0.5 seconds.

Data Types: double

Name-Value Arguments

Example: move(parrotObj,3,'VerticalSpeed',-2);

Specify at least one comma-separated pair of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN

Pitch — Movement of drone along x-axis

0 radians (default)

The pitch angle in which the Parrot drone moves along the x-axis, specified in radians. The drone moves forward, if the Pitch is negative. If the Pitch is positive, the drone moves backward.

The following Pitch values are valid for the Parrot drones

Parrot Drone	Pitch value
Parrot Mambo	-0.436 rad (-25degrees) to 0.436 rad (25 degrees)
Parrot Bebop 2	-0.6109 rad (-35degrees) to 0.6109 rad (35 degrees)

Example: move(parrotObj,3,'Pitch',deg2rad(2));

Data Types: double

Roll — Movement of drone along y-axis

0 radians (default)

The roll angle in which the Parrot drone, moves along the y-axis, specified in radians. The drone moves to the left if the Roll is negative. If the Roll is positive, the drone moves right.

The following Roll values are valid for the Parrot drones

Parrot Drone	Roll value
Parrot Mambo	-0.436 rad (-25degrees) to 0.436 rad (25 degrees)
Parrot Bebop 2	-0.6109 rad (-35degrees) to 0.6109 rad (35 degrees)

Example: move(parrotObj,3,'Roll',deg2rad(2));

Data Types: double

RotationSpeed — Speed of drone around z-axis

0 rad/s (default)

The speed at which the Parrot drone moves around the z-axis, specified in radians/s. The drone moves in the counterclockwise direction if the RotationSpeed is negative. If the RotationSpeed is positive, the drone moves in the clockwise direction.

The following RotationSpeed values are valid for the Parrot drones

Parrot Drone	RotationSpeed value
Parrot Mambo	-pi rad/s (-180 deg/s) to +pi rad/s (180 deg/s)
Parrot Bebop 2	-3.4907 rad/s (-200 deg/s) to 3.4907 rad/s (200 deg/s)

Example: move(parrotObj,3,'RotationSpeed',deg2rad(2));

Data Types: double

VerticalSpeed — Speed of the drone along z-axis

0 m/s (default)

The speed at which the Parrot drone moves along z-axis, specified in m/s. The drone ascends, if the VerticalSpeed is negative. If the VerticalSpeed is positive, the drone descends.

The following VerticalSpeed values are valid for the Parrot drones

Parrot Drone	VerticalSpeed value
Parrot Mambo	-2 m/s to +2 m/s.
Parrot Bebop 2	-6 m/s to +6 m/s.

For Parrot Mambo drones, the valid values for VerticalSpeed is between -2 m/s to +2 m/s.

Example: move(parrotObj,3,'VerticalSpeed',-2);

Data Types: double

Version History

Introduced in R2019a