TCL

Trajectory Computation Light (TCL) for BADAH/BADA3/BADA4 aircraft performance module.

pyBADA.TCL.apcClimbCalculation(climbType: ClimbType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, speedBrakes: SpeedBrakes | None = None, climbCASMACHProfileConfiguration: ClimbCASMACHProfileConfiguration | None = None) → FlightTrajectory[source]

Dispatches and calculates the aircraft climb trajectory based on the specified climb type.

This function serves as a high-level interface that selects the appropriate climb logic—be it a constant rate of climb, a speed transition (acceleration), or a standard CAS/Mach speed schedule. It ensures the correct parameters and configurations are passed down to the specialized performance sub-functions.

Parameters:

climbType (myTypes.ClimbType) – The strategy for the climb (RATE, ACCELERATION, or CASMACH).
AC (Aircraft) – Aircraft model instance containing performance and engine data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the climb (e.g., target ROCD).
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.
climbCASMACHProfileConfiguration (myTypes.ClimbCASMACHProfileConfiguration | None) – Detailed settings for CAS/Mach climbs, including takeoff procedures.

Returns:

A Flight Trajectory object containing the results of the specific climb calculation.

Return type:

FT

pyBADA.TCL.apcClimbCasMach(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes, casMachSpeedSchedule: CASMACHSpeedSchedule, takeOffProcedure: TakeOffProcedureBADA | TakeOffProcedureNADP1 | TakeOffProcedureNADP2, departureProfile: DepartureProfile, reducedPower: bool) → FlightTrajectory[source]

Calculates a complete climb trajectory using a CAS/Mach speed schedule.

This function simulates a multi-segment climb profile by determining threshold altitudes for configuration changes and speed transitions. It incorporates BADA speed schedules or custom user inputs, manages the transition at the crossover altitude, and accounts for specific takeoff procedures (e.g., NADP1, NADP2) and engine-specific climb limits.

Parameters:

AC (Aircraft) – Aircraft model instance containing performance limits and engine data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including acceleration level types and steps.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters for the climb segments.
speedBrakes (myTypes.SpeedBrakes) – Configuration for speed brake state and deployment value.
casMachSpeedSchedule (myTypes.CASMACHSpeedSchedule) – Object defining CAS below/above FL100 and target Mach.
takeOffProcedure (myTypes.TakeOffProcedure) – The specific takeoff/climb procedure (BADA, NADP1, or NADP2).
departureProfile (myTypes.DepartureProfile) – Profile type definition (e.g., constant CAS below 10,000ft).
reducedPower (bool) – Boolean flag to indicate if reduced thrust/power should be used.

Returns:

A Flight Trajectory object containing the concatenated climb segments.

Return type:

FT

pyBADA.TCL.apcDescentCalculation(descentType: DescentType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, speedBrakes: SpeedBrakes | None = None, CASMACHProfileConfiguration: DescentCASMACHProfileConfiguration | None = None) → FlightTrajectory[source]

Dispatches and calculates the aircraft descent trajectory based on the specified type.

This function serves as a high-level interface that selects the appropriate descent logic—supporting constant rate (ROCD), fixed gradient (slope), high-speed emergency procedures, speed transitions (deceleration), or managed CAS/Mach speed schedules. It coordinates the inputs and routes them to the specialized performance sub-functions.

Parameters:

descentType (myTypes.DescentType) – The strategy for the descent (RATE, SLOPE, EMERGENCY, ACCELERATION, or CASMACH).
AC (Aircraft) – Aircraft model instance containing performance and engine data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the descent (e.g., target ROCD or slope).
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.
CASMACHProfileConfiguration (myTypes.DescentCASMACHProfileConfiguration | None) – Detailed settings for managed CAS/Mach descent profiles.

Returns:

A Flight Trajectory object containing the results of the specific descent calculation.

Return type:

FT

pyBADA.TCL.apcDescentCasMach(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes, casMachSpeedSchedule: CASMACHSpeedSchedule, arrivalProfile: ArrivalProfile) → FlightTrajectory[source]

Calculates a complete descent trajectory using a CAS/Mach speed schedule.

This function simulates a multi-segment descent profile. It manages the transition from constant Mach at high altitudes to constant CAS below the crossover altitude. It accounts for speed restrictions (e.g., FL100), engine-specific threshold altitudes, and various acceleration/deceleration logics (AT, BEFORE, AFTER) as defined in the speed configuration.

Parameters:

AC (Aircraft) – Aircraft model instance containing performance limits and engine data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including deceleration level types and steps.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters governing the descent segments.
speedBrakes (myTypes.SpeedBrakes) – Configuration for speed brake state and deployment value.
casMachSpeedSchedule (myTypes.CASMACHSpeedSchedule) – Object defining target Mach and CAS values for the descent.
arrivalProfile (myTypes.ArrivalProfile) – Profile type definition (e.g., expedite or constant CAS).

Returns:

A Flight Trajectory object containing the concatenated descent segments.

Return type:

FT

pyBADA.TCL.apcDescentEmergency(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes) → FlightTrajectory[source]

Calculates an emergency descent trajectory at maximum operating speeds (VMO/MMO).

Parameters:

AC (Aircraft) – Aircraft model instance containing VMO, MMO, and performance limits.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration (Note: Function defaults to AC.VMO/AC.MMO).
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters for the descent segment.
speedBrakes (myTypes.SpeedBrakes) – Configuration for speed brake state and deployment value.

Returns:

A Flight Trajectory object representing the high-speed emergency descent.

Return type:

FT

pyBADA.TCL.apcFlightEnvelope(AC, mass: float, altitudeStep: float, meteo: Meteo | None = None) → dict[str, list][source]

Generates the operational and certified flight envelopes for a fixed-wing aircraft.

This function calculates the minimum and maximum speed limits across the aircraft’s entire altitude range (up to HMO). It accounts for stall speeds, buffet limits, thrust-limited maximum speeds, and structural limits (VMO/MMO), while handling the transition at the crossover altitude.

Parameters:

AC (Aircraft) – Aircraft model instance containing flight envelope and limit data.
mass (float) – Current aircraft mass for weight-dependent speed calculations [kg].
altitudeStep (float) – The vertical increment for envelope sampling [ft].
meteo (myTypes.Meteo | None) – Meteorological data, specifically temperature deviation (deltaTemp).

Returns:

A dictionary containing lists of speed limits for both envelopes.

Return type:

dict

pyBADA.TCL.apcLevelAccelerationDeceleration(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget | None = None, speedBrakes: SpeedBrakes | None = None) → FlightTrajectory[source]

Calculates a level flight trajectory for speed transitions (acceleration or deceleration).

Parameters:

AC (Aircraft) – Aircraft model instance containing performance and aerodynamic data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing the initial pressure altitude.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the speed change (e.g., longitudinal acceleration).
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.

Returns:

A Flight Trajectory object containing the acceleration/deceleration segment.

Return type:

FT

pyBADA.TCL.apcLevelCalculation(cruiseType: CruiseType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, integrationType: IntegrationType | None = None, cruiseLength: float | None = None, stepSize: float | None = None, stepClimb: bool | None = None, speedBrakes: SpeedBrakes | None = None, costIndex: float | None = None) → FlightTrajectory[source]

Dispatches and calculates the fixed-wing aircraft level flight trajectory.

Parameters:

cruiseType (myTypes.CruiseType) – The strategy for level flight (CONSTANTSPEED or ACCELERATION).
AC (Aircraft) – Aircraft model instance containing performance and optimization data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration; supports fixed values or optimized types (MRC, LRC, ECON).
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing speed changes (for acceleration).
integrationType (myTypes.IntegrationType | None) – Defines if cruiseLength is DISTANCE or TIME.
cruiseLength (float | None) – The total length of the cruise segment [NM or s].
stepSize (float | None) – The discretization step for integrated calculations.
stepClimb (bool | None) – Boolean flag to enable or disable automatic step-climb logic.
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.
costIndex (float | None) – The ratio of time-related costs to fuel costs for ECON speed.

Returns:

A Flight Trajectory object containing the results of the level flight calculation.

Return type:

FT

pyBADA.TCL.apcLevelConstantSpeed(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, integrationType: IntegrationType, cruiseLength: float, stepSize: float, costIndex: float, stepClimb: bool) → FlightTrajectory[source]

Calculates a level flight trajectory at a constant speed for fixed-wing aircraft.

This function simulates cruise performance, supporting both point-based performance snapshots across an altitude range and integrated flight segments. It features advanced speed selection logic, including Maximum Range Cruise (MRC), Long Range Cruise (LRC), and Economic (ECON) speeds based on Cost Index. Integrated calculations can optionally include step-climb logic to optimize flight levels as mass decreases.

Parameters:

AC (Aircraft) – Aircraft model instance including performance optimization modules.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration; supports fixed values or optimized types (MRC, LRC, ECON).
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
integrationType (myTypes.IntegrationType) – Defines if cruiseLength is DISTANCE or TIME.
cruiseLength (float) – The total length of the cruise segment [NM or s].
stepSize (float) – The discretization step for the integrated calculation.
costIndex (float) – The ratio of time-related costs to fuel costs used for ECON speed.
stepClimb (bool) – Boolean flag to enable or disable automatic step-climb logic.

Returns:

A Flight Trajectory object containing the cruise results.

Return type:

FT

pyBADA.TCL.climbDescentAccelerationDeceleration(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, flightPhase: FlightPhase, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes | None = None) → FlightTrajectory[source]

Calculates the flight trajectory for acceleration or deceleration during climb or descent.

Parameters:

AC (Aircraft) – Aircraft model instance containing performance and aerodynamic data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing the initial pressure altitude.
flightPhase (myTypes.FlightPhase) – The current phase of flight (CLIMB or DESCENT).
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters governing the acceleration/deceleration.
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.

Returns:

A Flight Trajectory object containing the computed results.

Return type:

FT

pyBADA.TCL.climbDescentRate(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes | None = None) → FlightTrajectory[source]

Calculates the flight trajectory in climb or descent at a specific ROCD.

Parameters:

AC (Aircraft) – Aircraft model instance containing performance and aerodynamic data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including the speed type and initial value.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target objective for the segment, specifically target ROCD.
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.

Returns:

A Flight Trajectory object containing the computed results.

Return type:

FT

pyBADA.TCL.climbDescentSlope(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, speedBrakes: SpeedBrakes | None = None) → FlightTrajectory[source]

Calculates the flight trajectory in climb or descent at a specific slope.

Parameters:

AC (Aircraft) – Aircraft model instance containing performance and aerodynamic data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including the speed type and initial value.
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target objective for the segment, specifically the target slope.
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.

Returns:

A Flight Trajectory object containing the computed results.

Return type:

FT

pyBADA.TCL.flightEnvelope(AC, mass: float, altitudeStep: float, meteo: Meteo | None = None) → dict[str, list][source]

Dispatches the flight envelope calculation to the appropriate aircraft or helicopter model.

Parameters:

AC (Aircraft) – Aircraft model instance containing the BADA family name and performance data.
mass (float) – Current aircraft mass for weight-dependent speed limits [kg].
altitudeStep (float) – The vertical increment for sampling the envelope [ft].
meteo (myTypes.Meteo | None) – Meteorological data, specifically temperature deviation (deltaTemp).

Returns:

A dictionary containing ‘operationalFlightEnvelope’ and ‘certifiedFlightEnvelope’ data.

Return type:

dict

pyBADA.TCL.hpcClimbARPM(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget, rating: HRating) → FlightTrajectory[source]

Calculates a helicopter climb trajectory using the ARPM model.

Parameters:

AC (Aircraft) – Aircraft (Helicopter) model instance with ARPM procedure methods.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration (Note: Initial TAS is derived from ARPM).
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters for the climb segment.
rating (myTypes.HRating) – The helicopter power rating (e.g., ‘ARPM’, ‘TOP’, ‘MCP’).

Returns:

A Flight Trajectory object representing the helicopter climb profile.

Return type:

FT

pyBADA.TCL.hpcClimbCalculation(climbType: ClimbType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, hClimbRatingConfiguration: HClimbRatingConfiguration | None = None) → FlightTrajectory[source]

Dispatches and calculates the helicopter climb trajectory based on the specified climb type.

Parameters:

climbType (myTypes.ClimbType) – The strategy for the climb (RATE, ACCELERATION, or ARPM).
AC (Aircraft) – Aircraft (Helicopter) model instance with ARPM performance data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the climb (e.g., target ROCD).
hClimbRatingConfiguration (myTypes.HClimbRatingConfiguration | None) – Configuration for helicopter-specific power ratings.

Returns:

A Flight Trajectory object containing the results of the helicopter climb.

Return type:

FT

pyBADA.TCL.hpcDescentARPM(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget) → FlightTrajectory[source]

Calculates a helicopter descent and landing trajectory using the ARPM model.

This function simulates a rotorcraft descent profile by identifying key altitude thresholds (500ft, 150ft, and 5ft) that trigger updates to the ARPM performance parameters. It handles the transition from forward descent to the final landing phase, automatically calculating the required TAS and ROCD based on the ARPM ‘Descent’ phase logic.

Parameters:

AC (Aircraft) – Aircraft (Helicopter) model instance with ARPM procedure methods.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration (Note: TAS is derived from ARPM).
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters for the descent segment.

Returns:

A Flight Trajectory object representing the helicopter descent profile.

Return type:

FT

pyBADA.TCL.hpcDescentCalculation(descentType: DescentType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, speedBrakes: SpeedBrakes | None = None, CASMACHProfileConfiguration: DescentCASMACHProfileConfiguration | None = None) → FlightTrajectory[source]

Dispatches and calculates the helicopter descent trajectory based on the specified type.

Parameters:

descentType (myTypes.DescentType) – The strategy for the descent (RATE, SLOPE, EMERGENCY, ACCELERATION, or ARPM).
AC (Aircraft) – Aircraft (Helicopter) model instance containing VNE and ARPM data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the descent (e.g., target ROCD or slope).
speedBrakes (myTypes.SpeedBrakes | None) – Configuration for speed brake state and deployment value.
CASMACHProfileConfiguration (myTypes.DescentCASMACHProfileConfiguration | None) – Detailed settings for fixed-wing style CAS/Mach descent schedules.

Returns:

A Flight Trajectory object containing the computed helicopter descent results.

Return type:

FT

pyBADA.TCL.hpcDescentEmergency(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget) → FlightTrajectory[source]

Calculates an emergency descent trajectory for helicopters at VNE.

Parameters:

AC (Aircraft) – Aircraft model instance containing VNE and helicopter performance data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration (Note: Function defaults to AC.vne).
mass (float) – Current aircraft mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget) – Target parameters for the descent segment.

Returns:

A Flight Trajectory object representing the high-speed helicopter descent.

Return type:

FT

pyBADA.TCL.hpcFlightEnvelope(AC, mass: float, altitudeStep: float, meteo: Meteo | None = None) → dict[str, list][source]

Generates the operational and certified flight envelopes for a helicopter.

This function calculates the minimum and maximum speed boundaries for rotorcraft across a range of altitudes. It accounts for certified structural limits (VNE), atmospheric crossover altitudes, and power-limited speed envelopes where the maximum achievable speed is constrained by engine performance (MCNT rating).

Parameters:

AC (Aircraft) – Aircraft (Helicopter) model instance containing envelope data.
mass (float) – Current helicopter mass for performance-limited calculations [kg].
altitudeStep (float) – The vertical increment for envelope sampling [ft].
meteo (myTypes.Meteo | None) – Meteorological data, specifically temperature deviation (deltaTemp).

Returns:

A dictionary containing lists of speed limits for both envelopes.

Return type:

dict

pyBADA.TCL.hpcLevelAccelerationDeceleration(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, controlTarget: ControlTarget | None = None) → FlightTrajectory[source]

Calculates a level helicopter trajectory for speed transitions at a constant altitude.

Parameters:

AC (Aircraft) – Aircraft (Helicopter) model instance containing performance data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing the initial pressure altitude.
speed (myTypes.Speed) – Speed configuration including initial, final, and step speed values.
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing the transition (e.g., specific acceleration).

Returns:

A Flight Trajectory object containing the computed transition segment.

Return type:

FT

pyBADA.TCL.hpcLevelCalculation(cruiseType: CruiseType, AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo | None = None, controlTarget: ControlTarget | None = None, integrationType: IntegrationType | None = None, cruiseLength: float | None = None, stepSize: float | None = None) → FlightTrajectory[source]

Dispatches and calculates the helicopter level flight trajectory based on cruise type.

Parameters:

cruiseType (myTypes.CruiseType) – The strategy for level flight (CONSTANTSPEED or ACCELERATION).
AC (Aircraft) – Aircraft (Helicopter) model instance containing ARPM and OPT data.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration; fixed values or optimization types.
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo | None) – Meteorological data (wind speed and temperature deviation).
controlTarget (myTypes.ControlTarget | None) – Target parameters governing speed changes (for acceleration).
integrationType (myTypes.IntegrationType | None) – Defines if cruiseLength is DISTANCE or TIME.
cruiseLength (float | None) – The total length of the cruise segment [NM or s].
stepSize (float | None) – The discretization step for integrated calculations.

Returns:

A Flight Trajectory object containing the results of the level flight calculation.

Return type:

FT

pyBADA.TCL.hpcLevelConstantSpeed(AC, calculationType: CalculationType, pressureAltitude: PressureAltitude, speed: Speed, mass: float, meteo: Meteo, integrationType: IntegrationType, cruiseLength: float, stepSize: float) → FlightTrajectory[source]

Calculates a level flight trajectory at a constant speed for helicopters.

This function simulates cruise performance at a fixed altitude. It can calculate a single state (POINT) across a range of altitudes or integrate fuel burn and time over a specific distance or duration (INTEGRATED). It supports automated speed selection for MRC (Maximum Range Cruise), LRC (Long Range Cruise), and MEC (Maximum Endurance Cruise).

Parameters:

AC (Aircraft) – Aircraft (Helicopter) model instance including optimization modules.
calculationType (myTypes.CalculationType) – The calculation method, either POINT or INTEGRATED.
pressureAltitude (myTypes.PressureAltitude) – Altitude data containing initial, final, and step values.
speed (myTypes.Speed) – Speed configuration; can be a fixed value or an optimization type.
mass (float) – Current helicopter mass in kilograms [kg].
meteo (myTypes.Meteo) – Meteorological data (wind speed and temperature deviation).
integrationType (myTypes.IntegrationType) – Defines if cruiseLength is DISTANCE or TIME.
cruiseLength (float) – The total length of the cruise segment [NM or s].
stepSize (float) – The discretization step for the integrated calculation.

Returns:

A Flight Trajectory object containing the level flight results.

Return type:

FT