Main Content

fixedWingAircraft

Create fixed-wing aircraft

Since R2021b

    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.

    example

    Examples

    collapse all

    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: [1x1 Aero.FixedWing.Coefficient]
         DegreesOfFreedom: "6DOF"
                 Surfaces: [1x0 Aero.FixedWing.Surface]
                  Thrusts: [1x0 Aero.FixedWing.Thrust]
              AspectRatio: 7.4483
               Properties: [1x1 Aero.Aircraft.Properties]
               UnitSystem: "Metric"
        TemperatureSystem: "Kelvin"
              AngleSystem: "Radians"
    
    

    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: [3x3 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: [3x3 double]
         BodyToInertialMatrix: [3x3 double]
             BodyToWindMatrix: [3x3 double]
             WindToBodyMatrix: [3x3 double]
        BodyToStabilityMatrix: [3x3 double]
        StabilityToBodyMatrix: [3x3 double]
              DynamicPressure: 2.9711
                  Environment: [1x1 Aero.Aircraft.Environment]
                ControlStates: [1x4 Aero.Aircraft.ControlState]
             OutOfRangeAction: "Limit"
             DiagnosticAction: "Warning"
                   Properties: [1x1 Aero.Aircraft.Properties]
                   UnitSystem: "English (ft/s)"
            TemperatureSystem: "Fahrenheit"
                  AngleSystem: "Radians"
    
    

    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: [1x1 Aero.FixedWing.Coefficient]
         DegreesOfFreedom: "6DOF"
                 Surfaces: [1x0 Aero.FixedWing.Surface]
                  Thrusts: [1x0 Aero.FixedWing.Thrust]
              AspectRatio: 7.4483
               Properties: [1x1 Aero.Aircraft.Properties]
               UnitSystem: "English (kts)"
        TemperatureSystem: "Kelvin"
              AngleSystem: "Radians"
    
    

    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: [1x1 Aero.FixedWing.Coefficient]
         DegreesOfFreedom: "PM4"
                 Surfaces: [1x0 Aero.FixedWing.Surface]
                  Thrusts: [1x0 Aero.FixedWing.Thrust]
              AspectRatio: 7.4483
               Properties: [1x1 Aero.Aircraft.Properties]
               UnitSystem: "Metric"
        TemperatureSystem: "Kelvin"
              AngleSystem: "Radians"
    
    

    Input Arguments

    collapse all

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

    Data Types: string

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

    UnitsUnitSystem
    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

    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)'

    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

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

    UnitsUnitSystem
    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

    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.

    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)"

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

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

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

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

    UnitsUnitSystem
    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

    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)'

    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

    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)'

    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

    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.

    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.

    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.

    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.

    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

    collapse all

    Fixed-wing aircraft, returned as a scalar.

    Version History

    Introduced in R2021b