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 pydap numpy pandas requests matplotlib pyproj scipy pycurl pyshp joblib bs4 rasterio xarray bottleneck geojson tqdm dask rioxarray pyvis shapely lxml cachetools cdsapi sentinelsat geopy numba
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 MODIS 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-11"]
latlim = [28.9, 29.7]
lonlim = [30.2, 31.2]
project_folder = r"/my_first_ETLook_run/"
# Download and prepare input data.
ds_in = pywapor.pre_et_look.main(project_folder, latlim, lonlim, timelim)
# 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.
Levels
3.
Composites
4.
Sideloading
5.
Enhancers
6.
pyWaPOR vs. WaPOR
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.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)