addDutchRollRequirementFunctions

Class: Aero.FixedWing.Specification
Namespace: Aero

Add custom requirement functions for Dutch roll mode

Since R2025a

expand all in page

Syntax

specificationOut = addDutchRollRequirementFunctions(specificationIn,customFunction)

Description

specificationOut = addDutchRollRequirementFunctions(specificationIn,customFunction) adds custom requirement functions for the Dutch roll mode. Use addDutchRollRequirementFunctions if you want to add custom requirements for your analysis. The Dutch roll mode appends customFunction to the list of existing requirement functions.

Input Arguments

expand all

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

Custom requirements function, specified as a scalar function handle. The function must have these inputs:

  • zeta — Damping ratio.

  • wn — Natural frequency.

  • wd — Damped natural frequency.

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

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

For more information, see Properties.

Output Arguments

expand all

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

Examples

expand all

Open Live Script

Add a custom requirement function for Dutch roll mode.

Create an Aero.FixedWing.Specification object.

spec = Aero.FixedWing.Specification;

Create the custom Dutch roll mode requirement function dutchRollFcn.

dutchRollFcn = @(zeta,wn,wd,T2)zeta*wn>=0.05
dutchRollFcn = function_handle with value:
    @(zeta,wn,wd,T2)zeta*wn>=0.05

Add the dutchRollFcn function to the Aero.FixedWing.Specification object.

spec = addDutchRollRequirementFunctions(spec,dutchRollFcn)
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