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 of the surface.

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

    surface = fixedWingSurface(name,controllable,symmetry,bounds) returns a fixed-wing surface object specifying the controllability, symmetry, and 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 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 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 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 string.

    Data Types: string

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

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

    Aero.FixedWing.Coefficients objects that define the 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.

    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.

    Introduced in R2021b