Main Content

aircraftEnvironment

Create aircraft environment

    Description

    example

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

    example

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

    environment = aircraftEnvironment(___,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.

    Examples

    collapse all

    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.4941
        SpeedOfSound: 1.0369e+03
             Gravity: 32.1850
          Properties: [1×1 Aero.Aircraft.Properties]

    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.4341
             Gravity: 9.8100
          Properties: [1×1 Aero.Aircraft.Properties]

    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 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

    collapse all

    Fixed-wing aircraft, specified as a scalar string.

    Data Types: string

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

    Data Types: string

    Height above sea level, specified as a numeric matrix.

    Data Types: double

    Name-Value Arguments

    Specify optional comma-separated pairs of Name,Value arguments. Name is the argument name and Value is the corresponding value. Name must appear inside quotes. You can specify several name and value pair arguments in any order as Name1,Value1,...,NameN,ValueN.

    Example: "UnitSystem","English (ft/s)"

    Unit system, specified as:

    UnitUnit System

    Meters per second (m/s)

    "Metric"

    Feet per second (ft/s)

    "English (kts)"

    Knots (kts)

    "English (ft/s)"

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

    Data Types: string

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

    Example: "AngleSystem","Degrees"

    Data Types: string

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

    Example: "TemperatureSystem","Rankine"

    Data Types: string

    Output Arguments

    collapse all

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

    Introduced in R2021b