Main Content

fixedWingSurface

Define aerodynamic or control surface on fixed-wing aircraft

    Description

    example

    surface = fixedWingSurface(name) returns a fixed-wing aerodynamic surface object with a specified component, name.

    surface = fixedWingSurface(name,controllable) returns a fixed-wing surface object specifying the controllability, controllable, of the surface.

    surface = fixedWingSurface(name,controllable,symmetry) returns a fixed-wing surface object specifying the symmetry,symmetry, of the surface.

    surface = fixedWingSurface(name,controllable,symmetry,bounds) returns a fixed-wing surface object specifying the bounds, bounds, of the surface.

    surface = fixedWingSurface(Name=Value) returns a fixed-wing surface object with one or more Name=Value arguments.

    Examples

    collapse all

    Create a fixed-wing surface object named MySurface.

    surface = fixedWingSurface("MySurface")
    surface = 
    
      Surface with properties:
    
                Surfaces: [1×0 Aero.FixedWing.Surface]
            Coefficients: [1×1 Aero.FixedWing.Coefficient]
            MaximumValue: Inf
            MinimumValue: -Inf
            Controllable: off
                Symmetry: "Symmetric"
        ControlVariables: [0×0 string]
              Properties: [1×1 Aero.Aircraft.Properties]

    Create a fixed-wing asymmetric control surface named MyCtrl using arguments.

    ctrlsurface = fixedWingSurface("MyCtrl","on","asymmetric")
    ctrlsurface = 
    
      Surface with properties:
    
                Surfaces: [1×0 Aero.FixedWing.Surface]
            Coefficients: [1×1 Aero.FixedWing.Coefficient]
            MaximumValue: Inf
            MinimumValue: -Inf
            Controllable: on
                Symmetry: "Asymmetric"
        ControlVariables: ["MyCtrl_1"    "MyCtrl_2"]
              Properties: [1×1 Aero.Aircraft.Properties]
    

    Create a fixed-wing symmetric control surface named MyCtrl with specified bounds and add it to an aerodynamic surface using a Name=Value argument.

    ctrlsurface = fixedWingSurface("MyCtrl","on","symmetric",[-20, 20]);
    surface = fixedWingSurface("MySurface","Surfaces",ctrlsurface)
    surface = 
    
      Surface with properties:
    
                Surfaces: [1×1 Aero.FixedWing.Surface]
            Coefficients: [1×1 Aero.FixedWing.Coefficient]
            MaximumValue: Inf
            MinimumValue: -Inf
            Controllable: off
                Symmetry: "Symmetric"
        ControlVariables: [0×0 string]
              Properties: [1×1 Aero.Aircraft.Properties]

    Input Arguments

    collapse all

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

    Data Types: string

    Controllable control surface, specified as 'on' or 'off'. To control the control surface, set this property to 'on'. Otherwise, set this property to 'off'.

    Data Types: string

    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. This equation defines the control variable:

    name = (name_1-name_2)/2.

    You cannot set this effective control variable.

    Data Types: string

    Lower and upper bounds of a controllable surface, specified as a two-element numeric vector.

    Data Types: double

    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: "Surfaces",ctrlsurface

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

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

    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.

    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.

    Controllable control surface specified as 'on' or 'off'. To control the control surface, set this property to 'on'. Otherwise, set this property to 'off'.

    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. This equation defines the control variable:

    name = (name_1-name_2)/2.

    You cannot set this effective control variable.

    Aero.Aircraft.Properties object, specified as a scalar.

    Output Arguments

    collapse all

    Aero.FixedWing.State object, returned as a scalar.

    Version History

    Introduced in R2021b