Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/c4pointer/bunker_calc
A crooss platform mobile and desktop app for marine engineers in KivyMD
https://github.com/c4pointer/bunker_calc
bunker bunkering fuel fuelcalculator kivy kivy-framework kivymd marine
Last synced: 22 days ago
JSON representation
A crooss platform mobile and desktop app for marine engineers in KivyMD
- Host: GitHub
- URL: https://github.com/c4pointer/bunker_calc
- Owner: c4pointer
- Created: 2021-11-20T20:15:45.000Z (almost 3 years ago)
- Default Branch: main
- Last Pushed: 2024-09-14T10:00:02.000Z (about 2 months ago)
- Last Synced: 2024-09-30T08:40:52.533Z (about 1 month ago)
- Topics: bunker, bunkering, fuel, fuelcalculator, kivy, kivy-framework, kivymd, marine
- Language: Python
- Homepage:
- Size: 101 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: Readme.md
Awesome Lists containing this project
README
# 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](https://www.python.org/downloads/)
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](CONTRIBUTING.md) file for guidelines.
## License
This project is licensed under the MIT License - see the [LICENSE.md](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 [email protected].