Main Content

Aero.FixedWing Class

Namespace: Aero

Define fixed-wing aircraft

Since R2021a

Description

An object of the Aero.FixedWing class defines a fixed-wing aircraft. Use this object to model and analyze a fixed-wing aircraft. It contains the static data for the aircraft, such as reference values, coefficients, and deflection angles.

To perform static analysis of fixed-wing aircraft, use this object in conjunction with the Aero.FixedWing.State object. The Aero.FixedWing.State object contains the aircraft information at a particular aircraft state.

For more information on fixed-wing aircraft definitions, see More About.

Class Attributes

Sealed
true

For information on class attributes, see Class Attributes.

Creation

Description

example

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

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

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

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

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

Input Arguments

expand all

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

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

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

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

Properties

expand all

Public Properties

Unit system, specified as a scalar string or character vector.

Attributes:

GetAccess
public
SetAccess
public

Data Types: string | char

Angle system, specified as 'Radians' or 'Degrees'.

Attributes:

GetAccess
public
SetAccess
public

Data Types: string | char

Temperature system, specified as 'Kelvin', 'Celsius', 'Rankine', or 'Fahrenheit'.

Attributes:

GetAccess
public
SetAccess
public

Data Types: string | char

Reference area, specified as a scalar numeric, commonly denoted as 'S', in units of:

UnitsUnitSystem
meters squared (m2) 'Metric'
feet squared (ft2)'English (kts)' or 'English (ft/s)'

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Reference span, specified as a scalar numeric, commonly denoted as 'b', in units of:

UnitsUnitSystem
meters squared (m) 'Metric'
feet squared (ft)'English (kts)' or 'English (ft/s)'

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Reference length, specified as a scalar numeric, commonly denoted as 'c', in units of:

UnitsUnitSystem
meters squared (m) 'Metric'
feet squared (ft)'English (kts)' or 'English (ft/s)'

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Aero.FixedWing.Coefficients class instance, specified as a scalar that contains the coefficients defining the fixed-wing aircraft. This object ignores this property if no value is set.

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Degrees of freedom, specified as a string or character vector.

Degrees of FreedomDescription
'6DOF'

Six degrees of freedom. Describes

translational and rotational movement

in 3-D space.

'3DOF'

Three degrees of freedom. Describes

translational and rotational movement

in 2-D space.

'PM4'

Fourth order point-mass. Describes

translational movement in 2-D space.

'PM6'

Sixth order point-mass. Describes

translational movement in 3-D space.

Attributes:

GetAccess
public
SetAccess
public

Data Types: string | char

Aero.FixedWing.Surface definitions, specified as a vector that contains the definitions of the surfaces on the fixed-wing aircraft. The object ignores this property if no value is set.

Attributes:

GetAccess
public
SetAccess
public

Data Types: double

Aero.FixedWing.Thrust definitions, specified as a vector that contains the definitions of the thrust on the fixed-wing aircraft. The object ignores this property if no value is set.

Attributes:

GetAccess
public
SetAccess
public

Data Types:

Protected Properties

Aspect ratio, specified as a scalar numeric, commonly denoted as 'AR'. This value depends on the values of ReferencedArea and ReferenceSpan, with this equation:

AspectRatio = ReferenceSpan2/ReferencedArea

The object ignores this property if no value is set.

Attributes:

GetAccess
Restricts access
SetAccess
protected

Data Types: double

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 the aircraft's 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.

More About

expand all

Version History

Introduced in R2021a