Main Content

Aero.FixedWing.Thrust class

Package: Aero

Define thrust vector on fixed-wing aircraft

Description

Aero.FixedWing.Thrust creates an Aero.FixedWing thrust vector that describes the thrust of an aircraft.

Class Attributes

Sealed
true

For information on class attributes, see Class Attributes.

Creation

Description

example

fixedWingThrust = Aero.FixedWing.Thrust creates a single Aero.FixedWing.Thrust object with default property values.

fixedWingThrust = Aero.FixedWing.Thrust(N) creates an N-by-N matrix of Aero.FixedWing.Thrust objects with default property values.

fixedWingThrust = Aero.FixedWing.Thrust(M,N,P,...) or Aero.FixedWing.Thrust([M N P ...]) creates an M-by-N-by-P-by-... array of Aero.FixedWing.Thrust objects with default property values.

fixedWingThrust = Aero.FixedWing.Thrust(size(A)) creates an Aero.FixedWing.Thrust object that is the same size as A and all Aero.FixedWing.Thrust objects.

fixedWing.Thrust = Aero.FixedWing.Thrust(__,property,propertyValue) creates an array of Aero.FixedWing.Thrust objects with property, propertyValue pairs applied to each of the Aero.FixedWing.Thrust array objects. For a list of properties, see Properties.

Input Arguments

expand all

Number of fixed-wing thrust objects, specified as a scalar.

Number of fixed-wing thrust objects, specified as a scalar.

Number of fixed-wing thrust objects, specified as a scalar.

Size of fixed-wing thrust object, specified as a scalar.

Properties

expand all

Public Properties

Aero.FixedWing.Coefficients object, specified as a scalar, that defines the thrust vector.

Attributes:

GetAccess
public
SetAccess
public

Maximum thrust value, specified as a scalar numeric.

Dependencies

If Symmetry is set to Asymmetric, then this value applies to both control variables.

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Minimum thrust value, specified as a scalar numeric.

Dependencies

If Symmetry is set to Asymmetric, then this value applies to both control variables.

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Controllable thrust value, specified as on or off. To control the thrust value, set this property to on. Otherwise, set this property to off.

Attributes:

GetAccess
public
SetAccess
public

Data Types: logical

Symmetry of the thrust control, specified as Symmetric or Asymmetric.

The Asymmetric option creates two control variables, denoted by the name on the properties and appended by _1 and _2. These control variables can be independently controlled, but also produce an effective control variable specified by the name on the properties. You cannot set this effective control variable. This equation defines the control variable:

name = (name_1-name_2)/2.

You cannot set this effective control variable.

Attributes:

GetAccess
public
SetAccess
public

Data Types: char | string

Aero.Aircraft.Properties object, specified as a scalar.

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Protected Properties

Control variable names, specified as a vector. This property depends on Properties.Name, Controllable, and Symmetry.

Attributes:

GetAccess
Restricts access
SetAccess
protected

Data Types: char | string

Methods

expand all

Examples

collapse all

Create and set up dynamic behavior and the current state for the fixed-wing object aircraft.

Create a fixed-wing object:

aircraft = Aero.FixedWing()
aircraft = 

  FixedWing with properties:

        ReferenceArea: 0
        ReferenceSpan: 0
      ReferenceLength: 0
         Coefficients: [1×1 Aero.FixedWing.Coefficient]
     DegreesOfFreedom: "6DOF"
             Surfaces: [1×0 Aero.FixedWing.Surface]
              Thrusts: [1×0 Aero.FixedWing.Thrust]
          AspectRatio: NaN
           UnitSystem: "Metric"
          AngleSystem: "Radians"
    TemperatureSystem: "Kelvin"
           Properties: [1×1 Aero.Aircraft.Properties]

To define the aircraft dynamic behavior, set a coefficient for it:

aircraft = setCoefficient(aircraft, "CD", "Zero", 0.27)
aircraft = 

  FixedWing with properties:

        ReferenceArea: 0
        ReferenceSpan: 0
      ReferenceLength: 0
         Coefficients: [1×1 Aero.FixedWing.Coefficient]
     DegreesOfFreedom: "6DOF"
             Surfaces: [1×0 Aero.FixedWing.Surface]
              Thrusts: [1×0 Aero.FixedWing.Thrust]
          AspectRatio: NaN
           UnitSystem: "Metric"
          AngleSystem: "Radians"
    TemperatureSystem: "Kelvin"
           Properties: [1×1 Aero.Aircraft.Properties]

Define aircraft current state:

state = Aero.FixedWing.State("Mass", 500)
state = 

  State with properties:

                   Alpha: 0
                    Beta: 0
                AlphaDot: 0
                 BetaDot: 0
                    Mass: 500
                 Inertia: [3×3 table]
         CenterOfGravity: [0 0 0]
        CenterOfPressure: [0 0 0]
             AltitudeMSL: 0
            GroundHeight: 0
                      XN: 0
                      XE: 0
                      XD: 0
                       U: 50
                       V: 0
                       W: 0
                     Phi: 0
                   Theta: 0
                     Psi: 0
                       P: 0
                       Q: 0
                       R: 0
                  Weight: 4905
             AltitudeAGL: 0
                Airspeed: 50
             GroundSpeed: 50
              MachNumber: 0.1469
            BodyVelocity: [50 0 0]
          GroundVelocity: [50 0 0]
                      Ur: 50
                      Vr: 0
                      Wr: 0
         FlightPathAngle: 0
             CourseAngle: 0
    InertialToBodyMatrix: [3×3 double]
    BodyToInertialMatrix: [3×3 double]
        BodyToWindMatrix: [3×3 double]
        WindToBodyMatrix: [3×3 double]
         DynamicPressure: 1.5312e+03
             Environment: [1×1 Aero.Aircraft.Environment]
              UnitSystem: "Metric"
             AngleSystem: "Radians"
       TemperatureSystem: "Kelvin"
           ControlStates: [1×0 Aero.Aircraft.ControlState]
        OutOfRangeAction: "Limit"
        DiagnosticAction: "Warning"
              Properties: [1×1 Aero.Aircraft.Properties]

Calculate the forces and moments on the aircraft:

[F, M] = forcesAndMoments(aircraft, state)
F =

           0
           0
        4905


M =

     0
     0
     0

Limitations

You cannot subclass Aero.FixedWing.Thrust.

Introduced in R2021a