Main Content

fixedWingAircraft

Create fixed-wing aircraft

    Description

    example

    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

    collapse all

    Create a fixed-wing aircraft.

    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"
              AngleSystem: "Radians"
        TemperatureSystem: "Kelvin"

    Create a 4th 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"
              AngleSystem: "Radians"
        TemperatureSystem: "Kelvin"

    Create a fixed-wing aircraft 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)"
              AngleSystem: "Radians"
        TemperatureSystem: "Kelvin"

    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 units of:

    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 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 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.

    Data Types: string

    Name-Value Arguments

    Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

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

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

    Data Types: string | char

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

    Data Types: string | char

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

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

    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.

    Data Types: char | string

    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.

    Introduced in R2021b