Outline

• Test files
• File Structure
• Metadata Section
• Data Section
  - RU
  - US

A flight records is a text file describing a flight. It contains global information about the flight (flight id, origin,... complete list), as well as parameters values recorded during the flight (GPS coordinates, air speed,... complete list)

Folder full of test files

A record is a file composed of two sections, metadata and flight data separated by an empty line.

Metadata
[Empty Line]
Data

Fig.1 The flight record is composed of two sections

The metadata section of the flight record file contains information relative to the plane and the flight. Header fields are colon-separated key-value pairs in clear-text string format, terminated by a carriage return (CR) and line feed (LF) character sequence. The end of the metadata section is indicated by an empty line, resulting in the transmission of two consecutive CR-LF pairs.

field:value
....
field:value

Fig.2 The metadata section is a list of colon-separated key-value pairs

Parameter name	Presence	Data Type	Unit/format	Description	Example
flight id	required	String		A unique identifier for the flig	601
flight code	required	String		The code name of the fighter jet	F-14A
origin	required	String	US/RU	The origin of the fighter jet (US or RU)	US
date	required	String	yyyy-mm-dd	The date of the flight	2011-06-01
from	required	String		The take off airport name	krasnodar pashkovsky
to	required	String		The landing airport name	tbilissi-lochini
motor(s)	required	Number	none	The number of engines the jet has	2
mass aircraft	Optional	Number	kg in RU files, lbs in US files.	The mass of the fighter jet	41780
mass fuel	Optional	Number	kg in RU files, lbs in US files.	The mass of fuel at take off in the fighter jet	41780
lift coef	Optional	Decimal		The (overall) lift coefficient of the fighter jet	1.9650056483374456
drag coef	Optional	Devimal		The (overall) drag coefficient of the fighter jet	0.010121101720646569
version	Optional	string		Version of the format used. By default v1.1.0	v1.1.0

The Data structure contains the information recorded during the flights. Parameters are recorded in a CSV format. The first line is the header indicating the content of the data lines (column names).

Header
Data record
...
Data record

Fig.4 Data section is a csv table of parameters values describing a flight

The line with column names is located at the top of the data section. It indicates which parameters were recorded for this flight. The complete list of possible parameters can be found there. Some parameters are mandatory and will always be in the same position (e.g. timestamp is always first). Some parameters are optional and depends mostly on the plane (e.g. there will be as many engine thrust columns as there are engine on the plane).

Timestamp,Parameter,...,Parameter

fig.5 The header line

A data line represents one point in time (denoted by the timestamp) during the flight. It is a record of all the parameters at this moment.

Value,Value,...,Value

fig.6 the record structure

RU and US fighter jets do not use the same Units when logging their data.

Parameter name	Presence	Data Type	Unit	Description	Example
timestamp	Required First	Decimal	s	Elapsed time in second since 01/01/1970	1583010425910.56
longitude	Required	Decimal	Decimal Degrees (°)	Location longitude. Positive values are toward the north and east directions.	2.9382915
latitude	Required	Decimal	Decimal Degrees (°)	Location latitude. Positive values are toward the north and east directions.	79.982
altitude	Required	Decimal	Meter (m)	Height above sea level	2985.9909092
roll	Optional	Decimal	Decimal Degrees (°)	Roll is positive when rolling the aircraft to the right	0.8
pitch	Optional	Decimal	Decimal Degrees (°)	Pitch is positive when taking-off	1.5
yaw	Optional	Decimal	Decimal Degrees (°)	Yaw is clockwise relative to the true north	224.8
heading	Optional	Decimal	Decimal Degrees (°)	Heading is the yaw relative to the true north of the flat world. It is required because the native world north usually does not match spherical world north because of projection errors.	224.8
air_speed	Required	Decimal	Meter per second (m/s)	Wind speed reported by external sensors	516.6514247099457
engine_X	Required	Decimal	Watt (W)	Power of engine number X	30565986.61627765
temperature_in	Required	Decimal	Celsius Degree (℃)	Cockpit temperature	27.156045641442
humidity_in	Required	Decimal	Percentage (%)	Relative humidity	45.971654984
pressure_in	Required	Decimal	Pascal (Pa)	Cockpit pressure	27.156045641442
heart_rate	Required	Decimal	Beats per Minute (bpm)	Pilot's heart beats	80.00
oxygen_mask	Required	Decimal	Percentage (%)	Oxygen concentration sent to the pilot	78.3458795665

Parameter name	Presence	Data Type	Unit	Description	Example
timestamp	Required First	Decimal	s	Elapsed time in second since 01/01/1970	1583010425910.56
longitude	Required	Decimal	Decimal Degrees (°)	Location longitude. Positive values are toward the north and east directions.	2.9382915
latitude	Required	Decimal	Decimal Degrees (°)	Location latitude. Positive values are toward the north and east directions.	79.982
altitude	Required	Decimal	Feet (ft)	Height above sea level	2985.9909092
roll	Optional	Decimal	Decimal Degrees (°)	Roll is positive when rolling the aircraft to the right	0.8
pitch	Optional	Decimal	Decimal Degrees (°)	Pitch is positive when taking-off	1.5
yaw	Optional	Decimal	Decimal Degrees (°)	Yaw is clockwise relative to the true north	224.8
heading	Optional	Decimal	Decimal Degrees (°)	Heading is the yaw relative to the true north of the flat world. It is required because the native world north usually does not match spherical world north because of projection errors.	224.8
air_speed	Required	Decimal	Miles per Hour (mph)	Wind speed reported by external sensors	516.6514247099457
engine_X	Required	Decimal	HorsePower (hp)	Power of engine number X	30565986.61627765
temperature_in	Required	Decimal	Kelvin Degree (K)	Cockpit temperature	27.156045641442
humidity_in	Required	Decimal	Percentage (/100)	Relative humidity	0.45971654984
pressure_in	Required	Decimal	Pound-Force per Square Inch (psi)	Cockpit pressure	27.156045641442
heart_rate	Required	Number	Beats per Minute (bpm)	Pilot's heart beats	80
oxygen_mask	Required	Decimal	Percentage (/100)	Oxygen concentration sent to the pilot	0.783458795665