[](https://github.com/BenjMy/centum/actions/workflows/pages/pages-build-deployment)
[](https://github.com/BenjMy/centum/actions/workflows/python-publish.yml)
## 📥 Installation
Install Centum via pip:
```bash
pip install centum
```
# 💦 Centum
Centum, derived from the Latin word for "a hundred," is a Python package designed to streamline water accounting through energy and water balance modeling inputs. It equips users with tools to enhance water use efficiency, detect illegal water pumping, and protect essential mountain ecosystems, addressing key water management challenges.
## 🔍 Key inputs
For **irrigation water delimitation**:
- ETa and ETp (single NetCDF file) from Earth Observations
Additionnaly for **irrigation water quantification**:
- ETa from a water balance model (baseline without irrigation scheme)
Optionnaly:
- Corinne Land Cover
- Irrigation shapefiles: Import these with geopandas to define and analyze irrigation areas.
## ✨ Key Features
- Water Delineation: Map areas of interest using the ETa/ETp ratio.
- Type of irrigation classification
- Water Net Quantification: Calculate net water use based on ET baselines from Earth Observation data.
## 🌍 Additional Capabilities (expected)
- Illegal Water Pumping Detection: Identify unsanctioned water use.
- Ecosystem Resilience: Assess ecosystem drought resilience and green water footprint, aiding in ecosystem protection.
## 🔥 Core Models Used for testing
Centum relies on two main models for the testing datasets:
- Energy Balance Modeling 🌞: Provides ETa outputs using pyTSEB.
- Soil Water Balance Modeling 💧: Supplies ETa outputs using pyCATHY.
## Expected releases roadmap
- [x] V1.0: water delineation algoritm tested for synthetic irrigation time series (generated using AQUACROP)
- [ ] V1.*:
- [x] test delineation over real field site data
- [x] result visualisation utilities
- [ ] ...
- [ ] V2.0: irrigation water quantification
- [ ] use of soil database
- [ ] type of irrigation identification (use microwave info!)
- [ ] V3.0: use ET from DA as input to estimate uncertainties
- [ ] Soil parm. perturbation
- [ ] ET ensemble
- [ ] V*:
- Illegal Water Pumping Detection
- Ecosystem Resilience (Green water footprint evaluation)
- QGIS plugin
## References
Water delineation algoritm:
- ETa/ETp ratio
Irrigation water quantification:
Type of irrigation identification:
- ETa versus SM from SAR ratio
ET from DA
Raw data
{
"_id": null,
"home_page": "https://github.com/yourusername/centum",
"name": "centum",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": null,
"author": "Your Name",
"author_email": "your.email@example.com",
"download_url": null,
"platform": null,
"description": "[](https://github.com/BenjMy/centum/actions/workflows/pages/pages-build-deployment)\n[](https://github.com/BenjMy/centum/actions/workflows/python-publish.yml)\n\n\n## \ud83d\udce5 Installation\nInstall Centum via pip:\n\n```bash\npip install centum\n```\n\n# \ud83d\udca6 Centum\nCentum, derived from the Latin word for \"a hundred,\" is a Python package designed to streamline water accounting through energy and water balance modeling inputs. It equips users with tools to enhance water use efficiency, detect illegal water pumping, and protect essential mountain ecosystems, addressing key water management challenges.\n\n## \ud83d\udd0d Key inputs\nFor **irrigation water delimitation**:\n- ETa and ETp (single NetCDF file) from Earth Observations\n\nAdditionnaly for **irrigation water quantification**:\n- ETa from a water balance model (baseline without irrigation scheme)\n\nOptionnaly:\n- Corinne Land Cover\n- Irrigation shapefiles: Import these with geopandas to define and analyze irrigation areas.\n\n\n## \u2728 Key Features\n- Water Delineation: Map areas of interest using the ETa/ETp ratio.\n- Type of irrigation classification\n- Water Net Quantification: Calculate net water use based on ET baselines from Earth Observation data.\n \n## \ud83c\udf0d Additional Capabilities (expected)\n- Illegal Water Pumping Detection: Identify unsanctioned water use.\n- Ecosystem Resilience: Assess ecosystem drought resilience and green water footprint, aiding in ecosystem protection.\n\n## \ud83d\udd25 Core Models Used for testing\nCentum relies on two main models for the testing datasets:\n- Energy Balance Modeling \ud83c\udf1e: Provides ETa outputs using pyTSEB.\n- Soil Water Balance Modeling \ud83d\udca7: Supplies ETa outputs using pyCATHY.\n \n\n## Expected releases roadmap\n\n- [x] V1.0: water delineation algoritm tested for synthetic irrigation time series (generated using AQUACROP)\n- [ ] V1.*: \n - [x] test delineation over real field site data \n - [x] result visualisation utilities\n - [ ] ...\n- [ ] V2.0: irrigation water quantification\n - [ ] use of soil database\n - [ ] type of irrigation identification (use microwave info!)\n- [ ] V3.0: use ET from DA as input to estimate uncertainties\n - [ ] Soil parm. perturbation\n - [ ] ET ensemble\n- [ ] V*: \n - Illegal Water Pumping Detection\n - Ecosystem Resilience (Green water footprint evaluation)\n - QGIS plugin\n\n\n\n## References \n\nWater delineation algoritm: \n- ETa/ETp ratio\n\nIrrigation water quantification:\n\nType of irrigation identification:\n- ETa versus SM from SAR ratio\n\nET from DA\n\n\n",
"bugtrack_url": null,
"license": "GPL-3.0-or-later # Use the SPDX identifier",
"summary": "A Python package for water accounting using energy and water balance modeling.",
"version": "0.1.6",
"project_urls": {
"Homepage": "https://github.com/yourusername/centum"
},
"split_keywords": [],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "9e8f6c287ffec9ef591d571b658fdc9ef4d4b7142cf48e97092fc6122901d66d",
"md5": "8a92db314112c6f70e9cf61a5d8480fa",
"sha256": "b6b63081cd99ad232bbb03190fb725c9011d9ccbe27ce2b4518718cb836d9548"
},
"downloads": -1,
"filename": "centum-0.1.6-py3-none-any.whl",
"has_sig": false,
"md5_digest": "8a92db314112c6f70e9cf61a5d8480fa",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 25422,
"upload_time": "2025-08-29T10:40:09",
"upload_time_iso_8601": "2025-08-29T10:40:09.077241Z",
"url": "https://files.pythonhosted.org/packages/9e/8f/6c287ffec9ef591d571b658fdc9ef4d4b7142cf48e97092fc6122901d66d/centum-0.1.6-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-08-29 10:40:09",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "yourusername",
"github_project": "centum",
"github_not_found": true,
"lcname": "centum"
}
JSON
