Welcome to the SARRA-data-download repository - your go-to source for streamlined climate and weather data preparation for crop simulation models in Africa. Our repository includes tools to download daily rainfall estimates from providers like TAMSAT, CHIRPS, and IMERG, as well as AgERA5 climate data. These datasets are crucial for the use of SARRA-O and SARRA-Py spatialized crop simulation models.
The output format of these tools is a series of geotiff files with the same spatial resolution as the input data. These geotiff files can be used in various applications, including QGIS, for visualization and analysis. With the SARRA data download repository, you can simplify your data preparation process and elevate your crop simulation models in Africa. Install Python 3.9.6 or above, clone the repo, and follow the instructions to get started!
This repo is a collection of tools to download and prepare climate and weather files necessary for the use of SARRA-O and SARRA-Py spatialized crop simulation models. Its rationale is to allow for easy download of time series datasets from different data providers for Africa.
You will need Python 3.9.6 or above.
Then, clone this repo and install its dependencies :
git clone https://github.com/SARRA-cropmodels/SARRA_data-download
cd SARRA_data-download
pip install -r requirements.txt
The ./notebooks/get_satellite_rainfall_estimated.ipynb notebook allows for downloading of daily rainfall estimates product from different providers, and preprocessing for their direct use in crop simulation models of the SARRA family. The output format is then a series of geotiff files, one per day, with the same spatial resolution as the input data.
Rainfall estimates products available :
Note : before downloding IMERG data, you must have a NASA Earthdata account. Check this document for more information about how to create an account and get your credentials.
To use, open the ./notebooks/get_satellite_rainfall_estimated.ipynb notebook in Jupyter, JupyterLab or VSCode, modify the parameters in the appropriate section and run the cells. The output files will be stored in the ./data/3_output/ directory.
The ./notebooks/get_AgERA5_data.ipynb notebook allows for downloading of daily AgERA5 climate data from the Copernicus Climate Data Store (CDS), and preprocessing for their direct use in crop simulation models of the SARRA family. The output format is a series of geotiff files, one per variable and per day.
The cdsapi package is used to download data from CDS. This has the advantage of magaging the caching of already passed requests, thus to speed up the downloading process.
AgERA5 data should be produced daily, with a 7-day lag, according to the AgERA-5 frequency update documentation.
Before running the notebook for the first time, follow these instructions to setup a Copernicus Climate Data Store API key on your machine, and accept Copernicus Terms of Service.
To use, open the ./notebooks/get_AgERA5_data.ipynb notebook in Jupyter, JupyterLab or VSCode, modify the parameters in the appropriate section and run the cells. The output files will be stored in the ./data/3_output/ directory.