pyWaPOR
This repository contains a Python implementation of the algorithm used to generate the WaPOR datasets. It can be used to calculate evaporation, transpiration and biomass production maps.
Installation
Its recommended to install in a clean conda environment and use conda to install all the important packages from the conda-forge channel.
conda create -n my_pywapor_env --yes -c conda-forge python pip gdal xarray numpy pandas requests matplotlib netcdf4 pyproj scipy pycurl joblib bs4 rasterio bottleneck tqdm dask rioxarray cryptography cachetools cdsapi shapely lxml scikit-learn numba xmltodict
conda activate my_pywapor_env
Then use the package manager pip to install pywapor.
pip install pywapor
Usage
To run the model for one dekad (from 2021-07-01 to 2021-07-11 in this case) for the Fayoum irrigation scheme in Egypt (but feel free to change the boundingbox defined by latlim and lonlim) using mainly VIIRS and Sentinel-2 data, run the following code (run python in your console to activate Python and exit() to deactivate).
import pywapor
# User inputs.
timelim = ["2021-07-01", "2021-07-03"]
latlim = [28.9, 29.7]
lonlim = [30.2, 31.2]
project_folder = r"/my_first_ETLook_run/"
level = "level_2_v3"
# Load a model configuration.
configuration = pywapor.general.levels.pre_et_look_levels(level = level)
# Download and prepare input data.
ds_in = pywapor.pre_et_look.main(project_folder, latlim, lonlim, timelim, sources = configuration)
# Run the model.
ds_out = pywapor.et_look.main(ds_in)
Check out the documentation and the notebooks below to learn more!
Documentation
Notebooks
Name
Colab
1.
Introduction
2.
Passwords
3.
Enhancers
4.
Sideloading
WaPOR v3
WaPOR v1
Acknowledgments
The methodology for WaPOR was developed by the FRAME1 consortium, consisting of eLEAF (lead), VITO, ITC, University of Twente and Waterwatch foundation, commissioned by and in partnership with the Land and Water Division of FAO. The method for calculating evapotranspiration is based on the ETLook model developed by eLEAF in 2010. The method for calculating total biomass production is based on the C-Fix model.
The code in the pywapor.et_look_v2_v3 module of this repository, containing all core physical functions used by ETLook, was written by Henk Pelgrum (eLEAF) and Rutger Kassies (eLEAF). The remaining modules have been developed by Bert Coerver (FAO), Tim Hessels (WaterSat), and, in the framework of the ESA-funded ET4FAO project, Radoslaw Guzinski (DHI-GRAS), Hector Nieto (Complutig) and Laust Faerch (DHI-GRAS).
Contact
For questions, requests or issues with this repository, please contact Bert Coerver at bert.coerver@fao.org or the WaPOR team at wapor@fao.org.
Release Notes
3.4.0 (2023-09-15)
3.3.0 (2023-04-05)
3.2.0 (2023-01-03)
3.1.0 (2022-09-22)
3.0.0 (2022-08-31)
2.6.0 (2022-08-04)
2.5.0 (2022-06-23)
2.4.2 (2022-04-26)
2.4.1 (2022-03-11)
2.4.0 (2022-02-03)
2.3.0 (2021-11-19)