fixedWingSurface

Define aerodynamic or control surface on fixed-wing aircraft

Since R2021b

Syntax

surface = fixedWingSurface(name)

surface = fixedWingSurface(name,controllable)

surface = fixedWingSurface(name,controllable,symmetry)

surface = fixedWingSurface(name,controllable,symmetry,bounds)

surface = fixedWingSurface(Name=Value)

Description

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

Create Fixed-Wing Surface Object

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 Fixed-Wing Asymmetric Control Surface

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 Fixed-Wing Symmetric Control Surface with Specified Bounds

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

name — Fixed-wing aircraft surface name

scalar string

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

Data Types: string

controllable — Option to control surface

'off' (default) | 'on'

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 — Symmetry of control surface

Symmetric (default) | Asymmetric

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

bounds — Lower and upper bounds

[-inf,inf] (default) | two-element numeric vector

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

Surfaces — Aero.FixedWing.Surface objects

vector

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

Coefficients — Aero.FixedWing.Coefficients objects

scalar

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

MaximumValue — Maximum value of control surfaces

infinity (default) | scalar numeric

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.

MinimumValue — Minimum value of control surface

negative infinity (default) | scalar numeric

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 — Controllable control surface

'off' (default) | 'on'

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 — Symmetry of control surface

Symmetric (default) | Asymmetric

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.

Properties — Aero.Aircraft.Properties object

scalar

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

Output Arguments

surface — Aero.FixedWing.Surface object

scalar

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

Version History

Introduced in R2021b