aircraftEnvironment

Create aircraft environment

Since R2021b

Syntax

environment = aircraftEnvironment(atmosphere,height)

environment = aircraftEnvironment(atmosphere,height,Name=Value)

environment = aircraftEnvironment(aircraft,atmosphere,height)

Description

environment = aircraftEnvironment(atmosphere,height) creates an aircraft environment object, environment, specified by the atmospheric model atmosphere that is above sea level, height, for a default aircraft.

environment = aircraftEnvironment(atmosphere,height,Name=Value) creates an aircraft environment, environment. Specify one or more Name=Value arguments after any of the input argument combinations in the previous syntaxes.

environment = aircraftEnvironment(aircraft,atmosphere,height) creates an aircraft environment object, environment, specified by the atmospheric model, atmosphere, that is above sea level, height, aircraft using the aircraft unit system defined in the aircraft, aircraft.

Examples

Create Aircraft Environment Objects

Create Aircraft Environment Object Using Fixed-Wing Aircraft

Create an aircraft environment object using a fixed-wing aircraft and English units at 20,000 feet.

aircraft = fixedWingAircraft("myplane","UnitSystem","English (ft/s)");
environment = aircraftEnvironment(aircraft,"ISA",20000)

environment = 
  Environment with properties:

    WindVelocity: [0 0 0]
         Density: 0.0013
     Temperature: 248.5260
        Pressure: 972.4935
    SpeedOfSound: 1.0368e+03
         Gravity: 32.1850
      Properties: [1×1 Aero.Aircraft.Properties]

Create Aircraft Environment Object with ISA Model

Create an aircraft environment object using the ISA model.

environment = aircraftEnvironment("ISA",1000)

environment = 
  Environment with properties:

    WindVelocity: [0 0 0]
         Density: 1.1116
     Temperature: 281.6500
        Pressure: 8.9875e+04
    SpeedOfSound: 336.4340
         Gravity: 9.8100
      Properties: [1×1 Aero.Aircraft.Properties]

Create Aircraft Environment Object with COESA Model

Create an aircraft environment object using the COESA model at 0, 100, and 1,000 meters.

environment = aircraftEnvironment("COESA",[0,100,1000])

environment=1×3 Environment array with properties:
    WindVelocity
    Density
    Temperature
    Pressure
    SpeedOfSound
    Gravity
    Properties

Create Aircraft Environment Object with ISA Model Using English Units

Create an aircraft environment object using English units at 500 feet.

environment = aircraftEnvironment("ISA",500,"UnitSystem","English (ft/s)")

environment = 
  Environment with properties:

    WindVelocity: [0 0 0]
         Density: 0.0023
     Temperature: 287.1594
        Pressure: 2.0783e+03
    SpeedOfSound: 1.1145e+03
         Gravity: 32.1850
      Properties: [1×1 Aero.Aircraft.Properties]

Input Arguments

aircraft — Aero.FixedWing object

scalar (default)

Aero.FixedWing object, specified as a scalar.

atmosphere — Atmospheric model

"ISA" | "COESA"

Atmospheric model to calculate the aircraft environment, specified as "ISA" or "COESA".

The input geopotential altitude ranges for these models are

• "COESA" — 0m to 84852m

• "ISA" — -5000m to 84852m

height — Height above sea level

numeric matrix

Height above sea level, specified as a numeric matrix.

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: "UnitSystem","English (ft/s)"

UnitSystem — Unit system

'Metric' (default) | "English (kts)"

Unit system, specified as a string based on these units:

Unit	Unit System
Meters per second (m/s)	"Metric"
Feet per second (ft/s)	"English (kts)"
Knots (kts)	"English (ft/s)"

Example: "UnitSystem","English (kts)"

AngleSystem — Angle system

"Radians" (default) | "Degrees"

Angle system, specified as "Radians" or "Degrees".

Example: "AngleSystem","Degrees"

TemperatureSystem — Temperature system

"Kelvin" (default) | "Celsius" | "Rankine" | "Fahrenheit"

Temperature system, specified as "Kelvin", "Celsius", "Rankine", or "Fahrenheit".

Example: "TemperatureSystem","Rankine"

Output Arguments

environment — Aero.Aircraft.Environment objects

matrix

Aero.Aircraft.Environment objects, returned as a matrix of the same size as height.

Version History

Introduced in R2021b

R2025a: aircraftEnvironment function Changes

The valid altitude range for aircraftEnvironment is now -5000m to 84852m.