gpm-precipitation-tools 0.4.7

Package for downloading and analysing NASA Global Precipitation Measurement mission data.

gpm_precipitation_tools

Package for downloading and analysing NASA Global Precipitation Measurement mission data.

This tool is an adapted version of the PPTs tool developed by Vinicius Mesquita. It was modified from the original code by Marina Ruiz Sánchez-Oro (University of Edinburgh - School of GeoSciences) and Guillaume Goodwin (University of Edinburgh - School of GeoSciences, now in University of Padova). It offers less flexibility than the original PPTs tool and focuses on downloading rainfall data from GPM instead of offering various data sources. It contains an additional module to generate time-series of rainfall intensity in over a specified area of interest.

• Free software: MIT license

• Documentation (in progress): https://gpm-precipitation-tools.readthedocs.io.

Accessing data

Before you try to download any data, ensure that you have created an account at the NASA Earth Data website.

Make a login and password, click in Applications>Authorized Apps> Approve More Applications and select NASA GESDISC DATA ARCHIVE.

You will be prompted for the username and the password every time you download the data using this package.

Usage

Install the gpm_precipitation_tools package:

pip install gpm_precipitation_tools

To download and pre-process the precipitation data (type directly in the command line):

PPT_CMD_RUN --ProdTP XXX --StartDate %Y-%m-%d --EndDate %Y-%m-%d --ProcessDir XXX --SptSlc XXX

To process the precipitation data and convert into timeseries or raster:

process_timeseries_files_pipeline --file_folder XXX --crs EPSG:XXXX --x_lon XX --y_lat YY --time %Y-%m-%d:%H%M%S

Where,

–ProdTP = ‘GPM_30min’ (default)

GPM_30min: GPM half-hourly (IMERGM v6)

GPM_D: GPM daily (IMERGM v6)

GPM_M: GPM monthly (IMERGM v6)

–StartDate = Insert the start date (format %Y-%M-%D)

–EndDate = Insert the end date (format %Y-%M-%D)

–ProcessDir = Insert the processing directory path

–SptSlc = Insert the cutline feature path (if not used, it assumes a global product)

–OP = Call this argument if you already have the data and want to process it. Make sure you have a directory with a raw files subfolder!!!!

–file_folder = Folder where the data to analyse lives.

–crs = Coordinate system in format EPSG:XXXX.

–x_lon = Longitude coordinate of the point of interest.

–y_lat = Latitude coordinate of the point of interest.

–time = Time of interest (format: %Y-%m-%d:%H%M%S)

Credits

This package is based on the code from Vinicius Mesquita, and has been adapted by Guillaume Goodwin (University of Edinburgh/ Universita di Padova) and Marina Ruiz Sánchez-Oro (University of Edinburgh).

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2022-02-04)

• First release on PyPI.

0.2.0 (2022-02-07)

• Fix dependency clashes

• Implement command line functionality.

0.3.0 (2022-02-08)

• Add missing packages

• Update documentation

0.3.1 (2022-02-08)

• Update documentation

0.3.2 (2022-02-08)

• Fix xarray and rioxarray imports

0.3.3 (2022-02-08)

• Update version in init file

0.3.4 (2022-02-08)

• Update entry_points

0.3.5 (2022-02-08)

• Fix package imports

0.3.6 (2022-02-08)

• Fix more package imports

0.3.7 (2022-02-08)

• Fix more package imports in init files

0.3.8 (2022-02-09)

• Fix libraries imports

0.3.9 (2022-02-09)

• Remove cartopy

0.4.1 (2022-02-09)

• Add PyQt5

0.4.5 (2022-02-11)

• Fix gdal compatibility issues (hopefully!) - add setuptools to install requirements and versions to all required packages.

• Fix issues with the process_timeseries_files_pipeline.py script.

There are still some issues sometimes in some cases with cftime.

0.4.6 (2022-02-11)

• Update gdal version to 2.2.2.

0.4.7 (2022-02-22)

• Remove requirements.

• Fix bug in monthly data download.