setDutchRollRequirementFunctions

Class: Aero.FixedWing.Specification
Namespace: Aero

Set list of custom requirement functions for Dutch roll modes

Since R2025a

expand all in page

Syntax

specificationOut = setShortPeriodRequirementFunctions(specificationIn,customFunction)

Description

specificationOut = setShortPeriodRequirementFunctions(specificationIn,customFunction) sets a list of one or more custom requirement functions for short period modes. This function overwrites the existing list of requirement functions, if one exists. The resulting list of requirement functions includes only the functions that this method sets.

Input Arguments

expand all

Aero.FixedWing.Specification object, specified as a scalar.

List of one or more custom requirements functions, specified as a scalar or cell array of function handles. The functions must have these inputs:

  • zeta — Damping ratio.

  • wn — Natural frequency.

  • wd — Damped natural frequency.

  • T2 — Time to double or negative time to halve.

The functions must return a logical, true (1) or false (0).

Example: @(zeta,wn,wd,T2) wn*wd >= 0.1 is an example of one function

Example: {@(zeta,wn,wd,T2) wn*wd >= 0.1,@(zeta,wn,wd,T2) zeta*wd >= 0.07} is an example of a cell array of functions

Output Arguments

expand all

Aero.FixedWing.Specification object, returned as the modified Aero.FixedWing.Specification object.

Examples

expand all

Open Live Script

Set a list custom requirement functions for Dutch roll mode.

Create an Aero.FixedWing.Specification object.

spec = Aero.FixedWing.Specification;

Create the list of custom Dutch roll mode requirement functions dutchRollFcnlist.

dutchRollFcnlist = {@(zeta,wn,wd,T2)wn*wd>=0.1,...
   @(zeta,wn,wd,T2)zeta*wd>=0.07}
dutchRollFcnlist=1×2 cell array
    {@(zeta,wn,wd,T2)wn*wd>=0.1}    {@(zeta,wn,wd,T2)zeta*wd>=0.07}

Add the dutchRollFcnlist function list to the Aero.FixedWing.Specification object.

spec = setPhugoidRequirementFunctions(spec,dutchRollFcnlist)
spec = 
  Specification with properties:

           Phugoid: [1×1 Aero.FixedWing.FlyingQuality.PhugoidMode]
       ShortPeriod: [1×1 Aero.FixedWing.FlyingQuality.ShortPeriodMode]
         DutchRoll: [1×1 Aero.FixedWing.FlyingQuality.DutchRollMode]
            Spiral: [1×1 Aero.FixedWing.FlyingQuality.SpiralMode]
    RollSubsidence: [1×1 Aero.FixedWing.FlyingQuality.RollSubsidenceMode]
        Properties: [1×1 Aero.Aircraft.Properties]

Version History

Introduced in R2025a

See Also