PyPoolPump is a python module providing classes for computing the duration needed for a swimming pool filtering pump. This module will provide methods to define the filtering daily schedule.
Each classes is an implementation of a different algorithm found when searching Internet to find best way to compute the filtering pump duration.
FilteringDuration() class is the base class with no duration computation. It gather all the common code for each implementation.
You will find a way to add a percentage modifier on the duration computed and a way to construct the daily filtering schedule.
You should not call directly this class except if you want to implement a new algorithm.
DumbFilteringDuration() is child class with an implementation of the common known algorithm using only the water temperature as parameter:
filtering duration (in hour) = water temperature (in °C) / 2.
Reference: the poster delivered with my swimming pool
BasicFilteringDuration() is child class with an implementation of the previous algorithm with some optimizations:
- No need to filter if water temperature below 10°C
- Between 10°C and 14°C we can reduce the duration (water temperature in °C / 3)
- Between 14°C and 30°C we use the standard rule (water temperature in °C / 2)
- Above 30°C continuous filtering.
Reference: To be completed
AbacusFilteringDuration() is a child class with an implementation of a water temperature based abacus. I found this when searching potential existing module on Github.
Reference: this abacus is used in the Jeedom pool addon by @scadinot.
PumpCaracteristicFilteringDuration() is a child class with an implementation of an algorithm based on the pool dimension, the pump characteristics and the water temperature.
If you want to contribute to the development:
- Start by cloning this repository.
- Setup a virtual environment
- Install the python package in edition mode:
pip install -e . - Create a branch for your feature
- Test your change using
tox - Send a PR when ready.
This software is under the MIT License.