inertialsim.examples.nesc

Utilities for working with NASA ESC flight simulation datasets.

See: https://nescacademy.nasa.gov/flightsim/2015

Classes:

Name	Description
FlightData	NESC flight simulation data.

Functions:

Name	Description
load	Load NESC atmospheric flight simulation data.

Attributes:

Name	Type	Description
data_map		Mapping from check case identifier to subdirectory.

data_map module-attribute

data_map = {"13p4": "Atmos_13p4_SubsonicLateralSideStepF16"}

Mapping from check case identifier to subdirectory.

FlightData

NESC flight simulation data.

Flight simulation data from an NESC atmospheric check case. This is a subset of the original data. Not all check cases contain the same variables and only variables relevant to InertialSim are loaded from the source data.

Data from the NASA Engineering and Safety Center (NESC) simulations. See Reference [19] for more information.

Attributes:

Name	Type	Description
time	NDArray	Timestamps (s) from simulation.
attitude	NDArray	Attitude as Euler angles (roll, pitch, yaw) in radians.
position	NDArray	Position in geodetic coordinates (lat, lon, alt) where lat/lon are in radians and altitude MSL is in meters.
velocity	NDArray	Velocity in NED frame (North, East, Down) in m/s.
angular_rate	NDArray	Angular rate of body frame relative to inertial frame in rad/s.
gravitation	NDArray	Local gravitation (excluding centripetal forces) in m/s/s.

time instance-attribute

time: NDArray

attitude instance-attribute

attitude: NDArray

position instance-attribute

position: NDArray

velocity instance-attribute

velocity: NDArray

angular_rate instance-attribute

angular_rate: NDArray

gravitation instance-attribute

gravitation: NDArray

load

load(
    directory: Path | str, check_case: str, simulator: str
) -> FlightData

Load NESC atmospheric flight simulation data.

Data is available from the NASA Engineering and Safety Center (NESC) site at https://nescacademy.nasa.gov/flightsim/2015. Data is organized by atmospheric and orbital categories. Only atmospheric data is supported. Each check case has several available simulators.

Source data is in US customary units (feet, degrees, etc.) and is automatically converted to SI units (meters, radians, etc.) by this function.

Parameters:

Name	Type	Description	Default
directory	Path | str	Top level directory with NESC atmospheric check case data organized in subdirectories with original names.	required
check_case	str	Check case identifier (e.g., "13p4").	required
simulator	str	Simulator number as a string (e.g., "02").	required

Returns:

Name	Type	Description
flight_data	FlightData	Simulated flight data from the requested check case and simulator.