Advanced Vessel Fuel Calculator

Desktop Python application for estimating vessel fuel consumption, tank status, cylinder oil usage, and bunkering results from operational inputs.

Features

• Sea, manoeuvring, and port operation modes
• Main engine consumption by power, RPM, or vessel speed
• Tier II and Tier III fuel-consumption curves
• Auxiliary engine load and generator-set calculations
• Boiler and cylinder-oil consumption helpers
• FO/DO tank capacity tracking with unpumpable-volume handling
• Bunkering worksheet with density, temperature, volume, and mass conversions

Requirements

• Python 3.10+
• NumPy
• Tkinter, usually bundled with desktop Python distributions

Quick Start

python -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
python main.py

On Windows, activate the environment with:

.\.venv\Scripts\activate
python main.py

Project Layout

main.py
src/
  calculator/       Core fuel, bunker, cylinder-oil, and conversion logic
  data/             Demo/reference engine and tank data
  gui/              Tkinter application windows

Data Notice

The public repository does not include vessel documents, operational records, or saved bunkering snapshots. Runtime data created by the bunkering screen is stored locally under src/data/saved/ and is ignored by Git.

Values in src/data/engine_data.py are demo/reference calculation inputs. Replace them with approved vessel data before using the tool for real operational planning.

License

Released under the MIT License.