Skip to content

jetfuelburn Changelog

The format of this log is based on Keep a Changelog. This project adheres to Semantic Versioning.

3.3.0 (12. May 2026)

Improvements

  • Added the usdot_plots.ipynb notebook to processing/usdot/, which generates plots from US DOT T2 data.
  • Added benchmarking scripts and notebooks to dev/usdot_benchmarking/:
    • distance_sweep.py: sweeps trip distances from 1,000 to 7,000 km and computes fuel burn per passenger-km for all reduced-order models (sacchi_etal, yanto_etal, montlaur_etal, seymour_etal, aim2015, eea_emission_inventory_2009, myclimate) for representative aircraft types (A320, B738, B772), benchmarked against US DOT statistical data.
    • ozempic_savings.ipynb and model_comparison.ipynb: notebooks for visualising and comparing model outputs by modifying payload.
  • Extended the statistics.usdot class with data for years 2019, 2023, and 2025 (previously only 2013, 2018, and 2024 were available).
  • Added the following functions to the statistics.usdot class:
    • calculate_movements(): returns the number of flights captured for a given aircraft type and year.
    • calculate_average_time(): returns the average trip flight time for a given aircraft type and year.
    • calculate_average_distance(): returns the average trip distance for a given aircraft type and year.
    • calculate_average_cargo(): returns the average freight and mail transported for a given aircraft type and year.
    • calculate_average_pax(): returns the average number of passengers per flight for a given aircraft type and year.
    • calculate_total_fuel_consumption(): returns the total fuel consumption across all aircraft types for a given year.

3.2.0 (12. May 2026)

Improvements

  • Added additional regression coefficients for military and transport aircraft to the reducedorder.eea_emission_inventory_2009 module for improved fuel burn estimation accuracy.

3.1.0 (16. March 2026)

Fixes

  • Updated the utility.mapping module to improve route rendering and label display.

3.0.0 (16. March 2026)

Improvements

  • Added a new utility.mapping module for mapping-related calculations.
  • Added a new utility.ofp module for flight plan-related calculations.
  • Updated the installation instructions to include optional dependencies.

Breaking Changes

  • Renamed the utility.math module to utility.mathematics to avoid namespace conflicts with the Python built-in math module.
  • Renamed all variables pointing to file names to use _path suffix (e.g. data.yaml > data_path).

2.0.1 (20. February 2026)

Fixes

  • Various minor bug fixes in the test suites.

Improvements

2.0.0 (11. February 2026)

Breaking Changes

  • Renamed the breguet module to rangeequation, since non-Breguet ("cruise-climb") range equation solutions have been added.
  • Removed the combined module (which was not included in the documentation) for re-integration at a later stage.
  • Renamed the _calculate_aircraft_velocity function in the utility.physics module to _calculate_airspeed_from_mach.

Improvements

  • Added an analytical solution ("arctan solution") to the range equation for constant altitude/airspeed flight profiles to the rangeequation module.
  • Added a numerical solution ("integrated solution") to the range equation for variable altitude/airspeed flight profiles to the rangeequation module.
  • Added a new aerodynamics utility module with functions for calculating aerodynamic properties.
    • Added a new JSBSim data module with aerodynamic data for the JSBSim flight dynamics model.
    • Added a new OpenAP data module with aerodynamic data for the OpenAP flight dynamics model.
  • Added a new engines utility module for engine-related calculations.
    • Added a function to calculate altitude/speed-dependent engine thrust-specific fuel consumption (TSFC) based on manufacturer information.
  • Added a new math utility module for mathematical functions.
  • Added a new code utility module for code-related utilities.

Fixes

  • Various minor bug fixes and documentation improvements.

1.6.0 (01. February 2026)

Improvements

  • Updated the utility.physics module:
    • Removed function _calculate_atmospheric_conditions
    • Added function _calculate_atmospheric_temperature
    • Added function _calculate_atmospheric_density
    • Added function _calculate_speed_of_sound

1.5.2 (23. January 2026)

Fixes

  • Updated the file I/O handling in the jetfuelburn.utility.geography module to avoid repeated file openings when calculating Great Circle distances.

1.5.1 (22. January 2026)

Improvements

  • Added a function to calculate Great Circle distances between two airports to the jetfuelburn.utility.geography module.

1.4.0 (20. January 2026)

Improvements

  • Added the fuel burn model of Montlaur et al. (2025) to the jetfuelburn.reducedorder module.

1.3.0 (15. January 2026)

Improvements

  • Added the fuel burn model of @romainsacchi (2023) to the jetfuelburn.reducedorder module.

1.2.0 (14. January 2026)

Improvements

  • Added the fuel burn model of the AeroMaps software framework by Planès et al. (2023) to the jetfuelburn.statistics module.

1.1.1 (20. December 2025)

Release for Zenodo archiving and JOSS publication.

1.1.0 (07. October 2025)

Improvements

  • Renamed module aux to utility for consistency with other packages.

1.0.2 (08. August 2025)

Improvements

  • Moved to src/jetfuelburn directory structure.

1.0.1 (08. August 2025)

Fixes

  • Fixed pint unit registry error in statistics module (#20).

1.0.0 (27. April 2025)

Note

Initial release of jetfuelburn package to accompany a submission to JOSS.

Improvements

  • Updated documentation.

Fixes

  • Fixed unit conversion errors in jetfuelburn.breguet.calculate_fuel_consumption_range_equation() function.
  • Fixed the Examples section of the jetfuelburn.reducedorder.eea_emission_inventory_2009 module.

0.0.9 (27. April 2025) ++YANKED++

Fixes

  • Fixed Example sections of function/class docstrings (were named Examples previously).

Improvements

  • Added US Department of Transportation (USDOT) Statistical Data (Form 41 Schedule T-100 Table T2) (#14).
  • Moved jetfuelburn.averages.myclimate to jetfuelburn.reducedorder.myclimate.

0.0.8 (16. April 2025)

Improvements

  • Added MyClimate Average/Statistical Model (#10).

Fixes

  • Fixed parameter description of jetfuelburn.diagrams.calculate_fuel_consumption_payload_range() function.

0.0.7 (24. March 2025)

Improvements

  • Added EMEP/EEA Emissions Model (#5).
  • Added warning and interactive plot to Lee et al. (2010) Model.

0.0.5 (14. March 2025)

Note

First working release for testing of Pyodide "Examples" fences.

Improvements

  • Added GitHub Actions workflow files.
  • Made AIM2015 data files accessible.

0.0.1 (13. March 2025)

Note

Initial release, including drafts of all functions.