Main Content


Visualize UAV mission

Since R2022b



    AX = show(mission) visualizes the UAV mission in a figure in the local east-north-up (ENU) frame, and returns the axes handle AX that contains the plot.

    AX = show(___,Name=Value) sets additional options specified by one or more name-value pair arguments in addition to all input arguments from the previous syntax. For example, show(mission,ReferenceLocation=[0 0 0]) shows the mission with the reference location set to [0 0 0].


    collapse all

    Create a UAV mission object with a home location at the origin of the local ENU coordinate frame and an initial speed of 5 meters per second.

    m = uavMission(Frame="LocalENU",HomeLocation=[0 0 0],Speed=5)
    m = 
      uavMission with properties:
           HomeLocation: [0 0 0]
             InitialYaw: 0
                  Frame: "LocalENU"
                  Speed: 5
        NumMissionItems: 0

    Add a takeoff mission item to the mission with an altitude of 25 meters, pitch of 15 degrees, and yaw of 0 degrees.


    Add two waypoint mission items to the mission. Between the two waypoints, increase the speed of the UAV to 20 meters per second. After the second waypoint, reduce the speed of the UAV back to 5 meters per second.

    addWaypoint(m,[10 0 30]);
    addWaypoint(m,[20 0 40]);
    addWaypoint(m,[30 0 50])

    Add loiter and hover mission items to the mission, specifying for the UAV to loiter and hover around the second waypoint at a radius of 50 meters for 20 seconds each.

    addLoiter(m,[40 0 60],10,20);
    addHover(m,[50 0 70],10,20);

    Add a landing mission item to the mission to land the UAV.

    addLand(m,[70 0 0],Yaw=0);

    Show the mission item data table.


    Remove the hover action at index 7, and then add another waypoint at index 8 after the hover item moves to index 7. Show the mission details table again to see the changes.

    addWaypoint(m,[65 0 70],InsertAtRow=8);

    Visualize the mission.

    axis equal

    Input Arguments

    collapse all

    UAV mission, specified as a uavMission object.

    Name-Value Arguments

    Specify optional pairs of arguments as Name1=Value1,...,NameN=ValueN, where Name is the argument name and Value is the corresponding value. Name-value arguments must appear after other arguments, but the order of the pairs does not matter.

    Example: show(m,ReferenceLocation=[43 32 55])

    Parent axes for the plot, specified as an Axes object.

    Example: show(m,Parent=ax2)

    Reference location of the plot origin, specified as a three-element row vector of the form [latitude longitude altitude]. The first two elements specify the latitude and longitude, respectively, of the UAV starting location in degrees, and the third specifies the starting altitude of the UAV in meters.

    Example: show(m,ReferenceLocation=[43 32 55])

    Output Arguments

    collapse all

    Axes handle, specified as an Axes object.

    Version History

    Introduced in R2022b