analyzeFlyingQualities

Class: Aero.FixedWing
Namespace: Aero

Compare aircraft static and dynamic stability against requirement specification

Since R2025a

expand all in page

Syntax

FlyingQualityResults = analyzeFlyingQualities(aircraft,state,specification)

Description

FlyingQualityResults = analyzeFlyingQualities(aircraft,state,specification) compares aircraft static and dynamic stability against a custom list of specifications, Aero.FixedWing.Specification. It returns FlyingQualityResults, which contains all longitudinal and lateral dynamic modes active in specification. The aircraft must have y-axis symmetry to decouple the longitudinal and lateral dynamics.

Input Arguments

expand all

Aero.FixedWing object, specified as a scalar. aircraft must have y-axis symmetry to decouple the longitudinal and lateral dynamics.

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

Aero.FixedWing.Specification object, specified as a cell array of strings containing quantitative flying quality requirements. Aero.FixedWing.Specification has default values for flying quality requirements that you can customize.

Output Arguments

expand all

Flying quality results, returned as a cell array of flying quality modes, specified as strings and a boolean, IsCompliant.

Mode CategoriesModesProperties

Oscillatory

  • Phugoid

  • ShortPeriod

  • DutchRoll

  • isCompliant — Boolean indicating compliance.

  • nonCompliant — Structure of noncompliant properties.

  • Roots — Eigenvalues of flight mode.

  • DampingRatio — Damping ratio of flight mode

  • NaturalFrequency — Natural frequency of flight mode.

  • DampedFrequency — Damped natural frequency of flight mode.

  • TimeToDouble — Time for flight mode to double in amplitude. If mode is stable, TimeToDouble is negative.

  • RelativeAmplitude — Amplitude relative to first oscillation after NCycles.

  • NCycles — Number of cycles to compute RelativeAmplitude.

Nonoscillatory

  • Spiral

  • RollSubsidence

  • isCompliant — Boolean indicating compliance.

  • nonCompliant — Structure of noncompliant properties.

  • Roots — Eigenvalues of flight mode.

  • TimeConstant — Time constant of flight mode.

  • TimeToDouble — Time for flight mode to double in amplitude. If mode is stable, TimeToDouble is negative.

The analyzeFlyingQualities method returns FlyingQualityResults, which contains the field IsCompliant. IsCompliant is 1 (true) if all dynamic modes meet the requirements provided in the given specification. Otherwise, the method returns 0 (false).

Examples

expand all

Open Live Script

This example shows how to analyze the De Havilland Beaver aircraft against the specification values in a default Aero.FixedWing.Specification object.

Get the aircraft and state values for the De Havilland Beaver aircraft.

[aircraft, state] = astDehavillandBeaver();

Create a Aero.FixedWing.Specification object with default values and set it to FixedWingSpec, and then call the analyzeFlyingQualities method using aircraft, state, and FixedWingSpec.

FixedWingSpec = Aero.FixedWing.Specification();
AnalysisResult = analyzeFlyingQualities(aircraft,state,FixedWingSpec)
AnalysisResult = 
             Modes: ["Phugoid"    "ShortPeriod"    "DutchRoll"    "Spiral"    "RollSubsidence"]
           Phugoid: [1×1 struct]
       ShortPeriod: [1×1 struct]
         DutchRoll: [1×1 struct]
            Spiral: [1×1 struct]
    RollSubsidence: [1×1 struct]
       IsCompliant: 1

Version History

Introduced in R2025a

See Also

| |