Key Features

  • Includes standards-based environmental models for atmosphere, gravity, geoid height, wind, celestial bodies, and magnetic field
  • Converts units and transforms coordinate systems and spatial representations, including rotations to and from Euler-Rodrigues vectors
  • Implements predefined utilities for aerospace parameter calculations, time calculations, and quaternion math
  • Imports aerodynamic coefficients from the U.S. Air Force Digital Data Compendium (Datcom )
  • Provides options for visualizing vehicle dynamics in a 3-D environment, including an interface to FlightGear flight simulator

To ensure design consistency, Aerospace Toolbox provides utilities for unit conversions, coordinate transformations, and quaternion math, as well as standards-based environmental models for the atmosphere, gravity, geoid height, and magnetic field. You can import aerodynamic coefficients from the U.S. Air Force Digital Data Compendium (Datcom) to carry out preliminary control design and vehicle performance analysis.

Visualization of Boeing 777 flight data (top right) achieved by using the Aerospace Toolbox interface to FlightGear flight simulator (bottom left).


Working with Environmental Models

Aerospace Toolbox provides standards-based environmental models for atmosphere, gravity, geoid height, and magnetic field.

The atmospheric models help you calculate ambient flight conditions and normalize flight data. They incorporate the 1976 Committee on Extension to the Standard Atmosphere (COESA) and International Standard Atmosphere (ISA) models, as well as nonstandard day models from U.S. military specifications (MIL-HDBK-310 and MIL-STD-210C).

Additional atmospheric model functions implement mathematical representations from these models: 2001 United States Naval Research Laboratory Mass Spectrometer and Incoherent Scatter Radar Exosphere (NRLMSISE) and 1986 Committee on Space Research (COSPAR) International Reference Atmosphere (CIRA). The NRLMSISE model provides atmospheric temperatures and densities at altitudes from 0 to 1,000 kilometers for a specified location and time. The CIRA model provides mean climatic data for atmospheric temperature, zonal wind, and either geopotential height or pressure for altitudes from 0 to 120 kilometers.

The gravity, geoid height, and magnetic field model functions help you analyze data and develop algorithms for navigation and geodesy applications. The gravity model is based on the 1984 World Geodetic System (WGS84) gravitational model. The geoid height function uses the 1996 Earth Geopotential Model (EGM96) to calculate geoid height for a specified latitude and longitude. The magnetic field model incorporates the 2015 version of the World Magnetic Model (WMM), which both use the National Imagery and Mapping Agency (NIMA) standard to calculate total intensity, horizontal intensity, declination, inclination, and the vector of the Earth's magnetic field for a specified location and time.

Planet ephemeris, Earth nutation, and moon libration model functions use Chebyshev coefficients to let you calculate the position and velocity of celestial bodies. The Chebyshev coefficients are developed by the National Aeronautics and Space Administration (NASA) Jet Propulsion Laboratory (JPL). The Planetary Ephemeris function obtains the position and velocity of celestial bodies relative to a major celestial body or the solar system barycenter. The Earth nutation function calculates longitude, obliquity, and angular rate using the International Astronomical Union (IAU) 1980 nutation series. The Moon libration function calculates the moon attitude described as Euler angles and rates.

A portion of the script (bottom left) built with Aerospace Toolbox utilities to calculate G-forces during flight (top right). The chosen utilities converted units, accessed the Committee on Extension to the Standard Atmosphere (COESA) model, calculated true airspeed, and imported Digital Datcom aerodynamic coefficients.


Converting Units and Transforming Coordinate Systems

Aerospace Toolbox lets you convert units and transform axes representations and coordinate systems. The unit conversion utilities convert physical properties, such as acceleration, density, and temperature, between metric and English units. The axes transformation utilities create direction cosine matrices and convert spatial representations between Euler angles, quaternion vectors, and Euler-Rodregues vectors. The Euler angles can be in any of the twelve standard rotation sequences. The direction cosine (rotation) matrix transfers between coordinate systems, such as body and inertial; body and wind; Earth-centered, Earth-fixed (ECEF) and north-east-down (NED); ECEF and latitude, longitude, and altitude (LLA); and Earth-Centered-Inertial (ECI) and ECEF. Functions for axes transformations between coordinate systems include ECI to Azimuth-Elevation-Range (AER), ECI and LLA, ECEF and LLA, and Flat Earth and LLA. Other representations include geocentric and geodetic latitude.


Performing Parameter Calculations, Time Calculations, and Quaternion Math

Aerospace Toolbox implements utilities for flight parameter calculations, time calculations, and quaternion math operations, such as the conjugate, division, inverse, and modulus.

The flight parameter utilities let you calculate these common parameters: relative pressure, density, and temperature ratios; equivalent airspeed; calibrated airspeed; Mach number; dynamic pressure; and, for a given geocentric latitude, planet radius. With the time calculation utilities, you can compute Julian dates, decimal year, leap year, barycentric dynamical time, and the difference between Coordinated Universal Time (UTC) and Principal Universal Time (UT1).

Parasite, induced, and total drag curves (top right) for a Cessna 172 created by using Aerospace Toolbox unit conversion utilities, atmospheric models, and flight parameter calculations (bottom left). The best glide velocity, indicated by an arrow, corresponds to the minimum value of drag on the total drag curve.


Importing Datcom Aerodynamic Coefficients

Datcom is a series of computer programs that uses flight conditions and aircraft geometry to estimate the aerodynamic stability and control characteristics of aircraft. U.S. Air Force Digital Datcom follows the methods in the U.S. Air Force Stability and Control Datcom. Aerospace Toolbox includes a function for importing output files from Digital Datcom, Datcom 2007, Datcom 2008, Datcom 2011, and Datcom 2014 into MATLAB. This function lets you collect aerodynamic coefficients from static and dynamic analyses and transfer them into MATLAB as a cell array of structures, with each structure containing information about a Datcom output file.

Aerodynamic coefficients imported into MATLAB from a Digital Datcom output file called astdatcom.out. The coefficients are imported as a 1 × 1 structure (top) using Aerospace Toolbox and can be viewed in the MATLAB Array Editor (bottom), where lift coefficient (cl) values are displayed for five angles of attack, two Mach numbers, and two altitudes.


Analyzing and Visualizing Flight Data

Aerospace Toolbox provides functions and standards-based environmental models to help develop algorithms for flight data analysis. Axes transformations let you compute rotation angles for attitude estimation algorithms using methods based on Euler-Rodrigues vectors or quaternions. Coordinate transformations let you convert flat-Earth latitude, longitude, and altitude data to geodesic and geocentric coordinates.

Aerospace Toolbox provides three options for visualizing flight data. First, the interface to FlightGear flight simulator lets you visualize vehicle dynamics in a sophisticated 3-D simulation framework. You can play back flight-test data through FlightGear and quickly reconstruct behavioral anomalies in your flight-test results. Aerospace Toolbox includes functions for controlling the position and attitude of a vehicle in FlightGear flight simulator by using double-precision values of longitude, latitude, altitude, roll, pitch, and yaw from MATLAB. Second, the interface to Simulink 3D Animation lets you use your flight data to control vehicle position and attitude in a virtual-reality scene. You can customize this scene, for example, by adding other vehicles. You can also visualize space flight. Third, MATLAB animation objects let you animate six-degrees-of-freedom motion within the MATLAB environment .

This animation overlays simulated versus actual flight trajectories employing an animation object. You can use Aero.Animation objects to create, configure, visualize and manipulate airframe bodies for flight trajectories.