gdptools 0.2.1

Gdptools

Readme

Welcome

Welcome to gdptools, a python package for grid- or polyon-to-polygon area-weighted interpolation statistics.

Example grid-to-polygon interpolation. A) Huc12 basins for Delaware River Watershed. B) Gridded monthly water evaporation amount (mm) from TerraClimate dataset. C) Area-weighted-average interpolation of gridded TerraClimate data to Huc12 polygons.

Documentation

gdptools documentation

Features

• Grid-to-polygon interpolation of area-weighted statistics.
• Use Mike Johnson's OPeNDAP catalog to access over 1700 unique datasets.
• Use any gridded dataset that can be read by xarray.
• Uses spatial index methods for improving the efficiency of areal-wieght calculation detailed by Geoff Boeing

Example catalog datasets

	Description	Dates	Links
BCCA	Bias Corrected Constructed Analogs V2 Daily Climate Projections (BACA) contains projections of daily BCCA CMIP3 and CMIP5 projections of precipitation, daily maximum, and daily minimum temperature over the contiguous United States	1950 - 2100
BCSD	Bias Corrected Spatially Downscaled (BCSD) Monthly CMIP5 Climate Projections	1950 - 2100
CHIRPS	Rainfall Estimates from Rain Gauge and Satellite Observations	1980 - Current Month
Daymet	Daymet provides long-term, continuous, gridded estimates of daily weather and climatology variables by interpolating and extrapolating ground-based observations through statistical modeling techniques.	1980 through previous year
LOCA	LOCA, which stands for Localized Constructed Analogs, is a technique for downscaling climate model projections of the future climate.	1950 - 2100
MACA	Multivariate Adaptive Constructed Analogs (MACA) is a statistical method for downscaling Global Climate Models (GCMs) from their native coarse resolution to a higher spatial resolution that captures reflects observed patterns of daily near-surface meteorology and simulated changes in GCMs experiments.	1950-2005 and 2006-2100
PRISM-Monthly	Parameter-elevation Regressions on Independent Slopes	1895-2020
TerraClimate	TerraClimate is a dataset of monthly climate and climatic water balance for global terrestrial surfaces from 1958-2019. These data provide important inputs for ecological and hydrological studies at global scales that require high spatial resolution and time-varying data.	1958-2020
gridMET	daily high-spatial resolution (~4-km, 1/24th degree) surface meteorological data covering the contiguous US	1979-yesterday

Data Requirements

Data - xarray (gridded data) and Geopandas (Polygon data)

• Xarray

  • Any endpoint that can be read by xarray and contains projected coordinates.
    • The endpoint can be supplied by the OPeNDAP catalog or from a user-supplied end-point.
  • Projection: any projection that can be read by proj.CRS (similar to Geopandas)

• Geopandas

  • Any file that can be read by Geopandas
  • Projection: any projection that can be read by proj.CRS

Installation

You can install Gdptools via pip from PyPI:

    pip install gdptools

or install via conda from conda-forge:

   conda install -c conda-forge gdptools

Usage

Please see the example notebooks for detailes.

Catalog Examples

• OPeNDAP Catalog Example

Non-catalog Examples

• Non-catalog example - gridMET
• Non-catalog example - Merra-2

Contributing

Contributions are very welcome. To learn more, see the Contributor Guide_.

License

Distributed under the terms of the CC0 1.0 Universal license, Gdptools is free and open source software.

Issues

If you encounter any problems, please file an issue along with a detailed description.

Credits

This project was generated from @hillc-usgs's Pygeoapi Plugin Cookiecutter template.