Main Content

setDutchRollRequirements

Class: Aero.FixedWing.Specification
Namespace: Aero

Set requirements for Dutch roll mode for flying quality analysis

Since R2025a

Syntax

specificationOut = setDutchRollRequirements(specificationIn,Name=Value)

Description

specificationOut = setDutchRollRequirements(specificationIn,Name=Value) sets requirements for Dutch roll mode for flying quality analysis.

Input Arguments

expand all

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

Name-Value Arguments

expand all

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.

Example: MinDampingRatio=10

Minimum damping ratio, specified as a scalar. For more information, see Properties.

Data Types: double

Maximum damping ratio, specified as a scalar. For more information, see Properties.

Data Types: double

Maximum relative amplitude, specified as a scalar. For more information, see Properties.

Data Types: double

N cycles for MaxRelativeAmplitude, specified as a scalar integer. For more information, see Properties.

Maximum time to halve amplitude of flight mode, specified as a scalar, in seconds. For more information, see Properties.

Data Types: double

Maximum time to double amplitude of flight mode, specified as a scalar, in seconds. For more information, see Properties.

Data Types: double

Maximum time to double amplitude of flight mode, specified as a scalar, in seconds. For more information, see Properties.

Data Types: double

Minimum natural frequency of oscillatory mode, specified as a scalar, in rad/s. For more information, see Properties.

Data Types: double

Maximum natural frequency of oscillatory mode, specified as a scalar, in rad/s. For more information, see Properties.

Data Types: double

Output Arguments

expand all

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

Examples

expand all

Set the requirement for the Dutch roll mode MinDampingRatio for flying quality analysis and view DutchRoll mode updates.

Create the Aero.FixedWing.Specfication object.

spec = Aero.FixedWing.Specification;

Set the requirement for Dutch roll mode MinDampingRatio for flying quality analysis.

spec = setDutchRollRequirements(spec,MinDampingRatio=10)
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]

View the DutchRoll mode updates.

spec.DutchRoll
ans = 
  DutchRollMode with properties:

         MinDampingRatio: 10
         MaxDampingRatio: Inf
     MinNaturalFrequency: 0
     MaxNaturalFrequency: Inf
           MaxTimeToHalf: Inf
         MinTimeToDouble: -Inf
    MaxRelativeAmplitude: Inf
                 NCycles: 7
                  Active: 1
                    Name: "Dutch Roll Mode"
    RequirementFunctions: {}

Version History

Introduced in R2025a