flight_performance.cfg
The flight_performance.cfg
file is an optional aircraft file for checking the performance characteristics of an aircraft for use with tuning the flight model and for correctly configuring flight plans and other applications. Below you can find information on the different sections used in the flight_performance.cfg
file as well as what parameters and values are expected within them. However it should be noted that that the information contained in this file has no influence on the aircraft flight behavior, and is instead used to compare computed performance versus expected performance (which can be found in the POH or from industrial or academic data).
IMPORTANT! Currently this file and debug window are only usable by planes with turbine / turbofan engines.
This file is initially created using the Debug Aircraft Flight Performance window, and in this window you can create various configurations. In the generated file, the data for each configuration will be contained in the corresponding numbered section, and there will also be a common section. For example, if you have two configurations, you will have a [AIRCRAFT_CONFIGURATION.0]
which is the common section, then you will have [AIRCRAFT_CONFIGURATION.0]
(configuration 1) and [AIRCRAFT_CONFIGURATION.1]
(configuration 2). This debug window is documented here:
[Version]
The [Version]
section provides version information for the configuration file. In Microsoft Flight Simulator 2024, major versions should always be at least equal to 1.
Note that this section information is mandatory and should always be included.
Parameter | Description | Type | Required |
---|---|---|---|
major |
Major CFG file version number, values must be greater than 0. | Integer | Yes |
minor |
Minor CFG file version number, values must be greater than 0. | Integer | Yes |
[AIRCRAFT_GEOMETRY]
This section provides general information about the defined aircraft geometry. The available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
wing_area |
The total wing area as defined by the wing_area parameter in the flight_model.cfg. |
Float | Yes |
wing_span |
The wing span as defined by the wing_span parameter in the flight_model.cfg. |
Float | Yes |
wing_mean_chord |
The mean wing Chord. This value is based on internal calculations. These calculations start by taking the wing_root_chord , the number of wings and the wing_area , to derive the wing tip chord. This value is then used to get the wing taper ratio, and then, finally, the wing mean chord is calculated using the root and the taper ratio. |
Float | Yes |
[AIRCRAFT_CONFIGURATION.N]
This section provides general information for the aircraft performance when in flight. The available common (N is 0) parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
configuration_name |
The name of the configuration (as a string). This is purely orientative to help you identify which configuration is being used. NOTE: This parameter is only used when more than one aircraft configuration is present. |
String | No |
landing_gear_state |
This defines whether the configuration has been created with landing gear down (1, TRUE) or not (0, FALSE). NOTE: This parameter is only used when more than one aircraft configuration is present. |
Boolean | No |
wing_configuration_ID |
This tells the configuration which NOTE: This parameter is only used when more than one aircraft configuration is present. |
Integer | No |
spoilers_angle |
NOTE: This parameter is only used when more than one aircraft configuration is present. |
||
CL_table_by_AoA |
This is a table that correlates a given AoA (in degrees) with the aircraft lift coefficient (CL). The table is formatted as follows:
For example:
|
1D Table | Yes |
CD_table_by_Mach_and_AoA |
This is a table that correlates a given speed (in Mach) with a given AoA (in degrees) to give the aircraft drag coefficient (CD). The table is formatted as follows:
For example:
|
2D Table | Yes |
[ENGINE_PERFORMANCE]
This section contains tables of data related to the aircraft engine performance. Available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
number_of_engines |
The total number of engines for the aircraft. This is derived from the number of Engine.N parameters defined in the engines.cfg. |
Float | Yes |
engine_max_revs |
This sets the maximum revolutions for the engines being tested. For Piston Engines, this is the RPM, and for turbine and turbofan engines, this is a percentage. IMPORTANT! Currently only aircraft with turbine / turbofan engines are supported. |
Float | Yes |
engine_net_thrust_table_by_OAT_dev_and_altitude_and_Mach_and_throttle |
4D Table | Yes | |
engine_fuel_consumption_table_by_OAT_dev_and_altitude_and_Mach_and_throttle |
4D Table | Yes | |
engine_corrected_N1_table_by_OAT_dev_and_altitude_and_Mach_and_throttle |
4D Table | Yes | |
engine_idle_corrected_N1_table_by_OAT_dev_and_altitude_and_Mach |
3D Table | Yes | |
engine_idle_descent_corrected_N1_table_by_OAT_dev_and_altitude_and_Mach |
3D Table | Yes | |
engine_max_corrected_N1_table_by_OAT_dev_and_altitude_and_Mach |
3D Table | Yes | |
engine_climb_corrected_N1_table_by_OAT_dev_and_altitude_and_Mach |
3D Table | Yes |
[TAKEOFF_PERFORMANCE]
This section contains tables of data related to the performance when the aircraft is taking off. Available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
calculate_distances_based_on_Vspeed_tables |
Boolean | Yes | |
takeoff_ground_roll_distance_table_by_weight_and_OAT_and_altitude |
3D Table | Yes | |
takeoff_total_distance_table_by_weight_and_OAT_and_altitude |
3D Table | Yes | |
V1_table_by_flaps_and_weight |
2D Table | Yes | |
Vr_table_by_flaps_and_weight |
2D Table | Yes | |
V2_table_by_flaps_and_weight |
2D Table | Yes | |
V1_adjustments_table_by_altitude_and_OAT |
2D Table | Yes | |
Vr_adjustments_table_by_altitude_and_OAT |
2D Table | Yes | |
V2_adjustments_table_by_altitude_and_OAT |
2D Table | Yes | |
V1_adjustments_table_by_slope_and_weight |
2D Table | Yes | |
V1_adjustments_table_by_wind_and_weight |
2D Table | Yes |
[LANDING_PERFORMANCE]
This section contains tables of data related to the aircraft landing performance. Available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
landing_ground_roll_distance_table_by_weight_and_OAT_and_altitude |
This is a table that correlates a given weight (in lbs) with the OAT deviation from ISA (in °C) and a given altitude (in ft) to give the required landing roll distance (in ft). The table is formatted as follows:
For example:
|
3D Table | Yes |
landing_total_distance_table_by_weight_and_OAT_and_altitude |
This is a table that correlates a given weight (in lbs) with the OAT deviation from ISA (in °C) and a given altitude (in ft) to give the required total landing distance (in ft). The table is formatted as follows:
For example:
|
3D Table | Yes |
[CLIMB_PERFORMANCE]
This section contains tables of data related to the aircraft climb performance. Available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
climb_IAS_table_by_initial_weight |
This is a table that correlates the initial climb weight (in lbs) with the climb indicated airspeed (in Knots). The table is formatted as follows:
For example:
|
1D Table | Yes |
average_climb_rate_table_by_initial_weight_and_altitude |
This is a table that correlates a given altitude (in ft) with a given weight (in lbs) to give the average climb rate (in ft / min) from sea level. The table is formatted as follows:
For example:
|
2D Table | Yes |
total_fuel_table_by_initial_weight_and_altitude |
This is a table that correlates a given altitude (in ft) with a given weight (in lbs) to give the total amount of fuel consumed (in Gallons) in the climb. The table is formatted as follows:
For example:
|
2D Table | Yes |
[CRUISE_PERFORMANCE]
This section contains tables of data related to the performance when the aircraft is cruising. Available parameters are:
Parameter | Description | Type | Required |
---|---|---|---|
cruise_TAS_table_by_weight_and_altitude |
This is a table that correlates a given weight (in lbs) with the OAT deviation from ISA (in °C) and a given altitude (in ft) to give the true airspeed (in Knots) when cruising. The table is formatted as follows:
For example:
|
2D Table | Yes |
cruise_fuel_consumption_table_by_weight_and_altitude |
This is a table that correlates a given weight (in lbs) with the OAT deviation from ISA (in °C) and a given altitude (in ft) to give the fuel consumption (in Gallons / hour) when cruising. The table is formatted as follows:
For example:
|
2D Table | Yes |