fixedWingAircraft

Create fixed-wing aircraft

Since R2021b

Syntax

aircraft = fixedWingAircraft(name)

aircraft = fixedWingAircraft(name,referencearea,referencespan,referencelength)

aircraft = fixedWingAircraft(name,referencearea,referencespan,referencelength,degreesoffreedom)

aircraft = fixedWingAircraft(___,Name=Value)

Description

aircraft = fixedWingAircraft(name) returns a fixed-wing aircraft object, aircraft, specified by the aircraft name.

aircraft = fixedWingAircraft(name,referencearea,referencespan,referencelength) returns a fixed-wing aircraft object, aircraft, specified by the aircraft name, name, reference area, referencearea, reference span, referencespan, and reference length, referencelength.

aircraft = fixedWingAircraft(name,referencearea,referencespan,referencelength,degreesoffreedom) returns a fixed-wing aircraft object created with the specified degrees of freedom, degreesoffreedom.

aircraft = fixedWingAircraft(___,Name=Value) returns a fixed-wing aircraft object created with one or more name-value arguments.

Examples

Create Fixed-Wing Aircraft Object

Create a fixed-wing aircraft object.

aircraft = fixedWingAircraft("MyPlane",174,36,4.9)

aircraft = 
  FixedWing with properties:

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

Create Fixed-Wing Aircraft State Object from Fixed-Wing Aircraft Object and Mass

Create a fixed-wing aircraft state object from a fixed-wing aircraft object and specify the mass using positional arguments.

aircraft = astC182();
state = fixedWingState(aircraft,"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: 1.6093e+04
              AltitudeAGL: 0
                 Airspeed: 50
              GroundSpeed: 50
               MachNumber: 0.0448
             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]
    BodyToStabilityMatrix: [3×3 double]
    StabilityToBodyMatrix: [3×3 double]
          DynamicPressure: 2.9711
              Environment: [1×1 Aero.Aircraft.Environment]
            ControlStates: [1×4 Aero.Aircraft.ControlState]
         OutOfRangeAction: "Limit"
         DiagnosticAction: "Warning"
               Properties: [1×1 Aero.Aircraft.Properties]
               UnitSystem: "English (ft/s)"
        TemperatureSystem: "Fahrenheit"
              AngleSystem: "Radians"

Create Fixed-Wing Aircraft Object Unit System

Create a fixed-wing aircraft by specifying the unit system as a name-value argument.

aircraft = fixedWingAircraft("MyPlane",174,36,4.9,"UnitSystem","English (kts)")

aircraft = 
  FixedWing with properties:

        ReferenceArea: 174
        ReferenceSpan: 36
      ReferenceLength: 4.9000
         Coefficients: [1×1 Aero.FixedWing.Coefficient]
     DegreesOfFreedom: "6DOF"
             Surfaces: [1×0 Aero.FixedWing.Surface]
              Thrusts: [1×0 Aero.FixedWing.Thrust]
          AspectRatio: 7.4483
           Properties: [1×1 Aero.Aircraft.Properties]
           UnitSystem: "English (kts)"
    TemperatureSystem: "Kelvin"
          AngleSystem: "Radians"

Create Fourth Order Point Mass Fixed-Wing Aircraft Object

Create a fourth order point-mass fixed-wing aircraft using positional arguments.

aircraft = fixedWingAircraft("MyPlane",174,36,4.9,"PM4")

aircraft = 
  FixedWing with properties:

        ReferenceArea: 174
        ReferenceSpan: 36
      ReferenceLength: 4.9000
         Coefficients: [1×1 Aero.FixedWing.Coefficient]
     DegreesOfFreedom: "PM4"
             Surfaces: [1×0 Aero.FixedWing.Surface]
              Thrusts: [1×0 Aero.FixedWing.Thrust]
          AspectRatio: 7.4483
           Properties: [1×1 Aero.Aircraft.Properties]
           UnitSystem: "Metric"
    TemperatureSystem: "Kelvin"
          AngleSystem: "Radians"

Input Arguments

name — Fixed-wing aircraft name

scalar string

Fixed-wing aircraft name, specified as a scalar string.

Data Types: string

referencearea — Reference area

0 (default) | scalar numeric

Reference area, specified as a scalar numeric, commonly denoted as 'S', in these units.

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

Tip

This argument also exists as the name-value argument ReferenceArea. If you specify the ReferenceArea name-value argument, its value supersedes the referencearea positional argument.

Data Types: double

referencespan — Reference span

0 (default) | scalar numeric

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

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

Tip

This argument also exists as the name-value argument ReferenceSpan. If you specify the ReferenceSpan name-value argument, its value supersedes the referencespan positional argument.

Data Types: double

referencelength — Reference length

0 (default) | scalar numeric

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

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

Tip

This argument also exists as the name-value argument ReferenceLength. If you specify the ReferenceLength name-value argument, its value supersedes the referencelength positional argument.

Data Types: double

degreesoffreedom — Degrees of freedom

'6DOF' (default) | '3DOF' | 'PM4' | 'PM6'

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

Degrees of Freedom	Description
'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.

Tip

This argument also exists as the name-value argument DegreesOfFreedom. If you specify the DegreesOfFreedom name-value argument, its value supersedes the degreesoffreedom positional argument.

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.

Before R2021a, use commas to separate each name and value, and enclose Name in quotes.

Example: "UnitSystem","English (kts)"

UnitSystem — Unit system

'Metric' (default) | 'English (kts)' | 'English (ft/s)' | scalar | character vector

Unit system, specified as 'Metric', 'English (kts)', or 'English (ft/s)'.

AngleSystem — Angle system

'Radians' (default) | 'Degrees'

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

TemperatureSystem — Temperature system

'Kelvin' (default) | 'Celsius' | 'Rankine' | 'Fahrenheit'

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

ReferenceArea — Reference area

0 (default) | scalar numeric

Reference area, specified as a scalar numeric, commonly denoted as 'S', in these units.

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

Tip

This argument also exists as the referencearea positional argument. If you specify the ReferenceArea name-value argument, its value supersedes the referencearea positional argument.

Data Types: double

ReferenceSpan — Reference span

0 (default) | scalar numeric

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

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

Tip

This argument also exists as the referencespan positional argument. If you specify the ReferenceSpan name-value argument, its value supersedes the referencespan positional argument.

Data Types: double

ReferenceLength — Reference length

0 (default) | scalar numeric

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

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

Tip

This argument also exists as the referencelength positional argument. If you specify the ReferenceLength name-value argument, its value supersedes the referencelength positional argument.

Data Types: double

Coefficients — Aero.FixedWing.Coefficients class instance

scalar

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.

DegreesOfFreedom — Degrees of freedom

'6DOF' (default) | '3DOF' | 'PM4' | 'PM6'

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

Degrees of Freedom	Description
'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.

Tip

This argument also exists as the degreesoffreedom positional argument. If you specify the DegreesOfFreedom name-value argument, its value supersedes the degreesoffreedom positional argument.

Surfaces — Aero.FixedWing.Surface definitions

vector

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.

Thrusts — Aero.FixedWing.Thrust definitions

vector

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.

Data Types: double

Output Arguments

aircraft — Fixed-wing aircraft

scalar

Fixed-wing aircraft, returned as a scalar.

Version History

Introduced in R2021b