Main Content

Aero.FixedWing.Surface class

Package: Aero

Define aerodynamic and control surfaces on Aero.FixedWing aircraft

Since R2021a

expand all in page

Description

Aero.FixedWing.Coefficient defines the dynamic and control surfaces on an Aero.FixedWing aircraft.

Class Attributes

Sealed
true

For information on class attributes, see Class Attributes.

Creation

Description

example

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

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

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

fixedWingSurface = Aero.FixedWing.Surface(size(A)) creates an Aero.FixedWing.Surface object of the same size as A and all Aero.FixedWing.Surface objects.

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

Properties

expand all

Public Properties

Aero.FixedWing.Surface objects providing nested control surfaces, specified as a vector.

Attributes:

GetAccess
public
SetAccess
public

Aero.FixedWing.Coefficients objects that define the control surface, specified as a scalar.

Attributes:

GetAccess
public
SetAccess
public

Maximum value of control surfaces, 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 value of control surface, 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 control surface specified as on or off. To control the control surface, set this property to on. Otherwise, set this property to off.

Attributes:

GetAccess
public
SetAccess
public

Data Types: logical

Symmetry of the control surface, 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 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.Surface.

Version History

Introduced in R2021a

See Also

| |