Skip to content

A crooss platform mobile and desktop app for marine engineers in KivyMD

Notifications You must be signed in to change notification settings

c4pointer/bunker_calc

Repository files navigation

BunkerCalc App

Overview

BunkerCalc is a Python-based application built using the Kivy MD (Material Design) framework. It assists marine engineers in calculating the quantity of bunkering fuel required for a given voyage. By providing essential input parameters, the application helps estimate the fuel quantity needed, optimizing fuel management for marine vessels.

Features

  • User-friendly Interface: Intuitive and easy-to-use interface accessible for marine engineers of all technical levels.
  • Input Parameters: Users can input voyage details such as distance, speed, and fuel consumption rate.
  • Fuel Quantity Calculation: Accurately estimates required bunkering fuel quantity based on input parameters.
  • Optimization Suggestions: Provides recommendations for efficient fuel management.

Requirements

  • Python 3.x
  • Kivy MD framework

Installation

  1. Install Python: Python Installation Guide

  2. Install Kivy MD:

    pip install kivy[base] kivymd
    
  3. Clone the BunkerCalc repository:

    git clone https://github.com/yourusername/BunkerCalc.git
    
  4. Navigate to the project directory:

    cd BunkerCalc
    
  5. Run the app:

    python main.py
    

Usage

  1. Launch the app.
  2. Enter the required voyage details in the input fields.
  3. Click the "Calculate" button to obtain the estimated bunkering fuel quantity.
  4. Review any optimization suggestions provided by the app.
  5. Make necessary adjustments and repeat the calculation as needed.

Contributing

Contributions are welcome! Please refer to the CONTRIBUTING.md file for guidelines.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Acknowledgments

The BunkerCalc team would like to express gratitude to the Kivy MD community for their excellent framework.

Contact

For inquiries or support, please contact the development team at c4point@gmail.com.