gdptools 0.0.25.dev4

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

Requirements

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

• Xarray

  • Any endpoint that can be read by Xarray and contains projected coordinates.
  • 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 notebook for detailed examples.

• OPeNDAP Catalog Example
• Non-catalog example

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.