Skip to content

Enrich geo-referenced data with the surrounding environmental conditions

License

Notifications You must be signed in to change notification settings

IRDG2OI/geoenrich

Repository files navigation

geoenrich 0.6.4

Read the Docs License PyPI Python versions Last commit DOI

ACKNOWLEDGEMENT

This project is being developed as part of the G2OI project, cofinanced by the European Union, the Reunion region, and the French Republic.

Package description

GeoEnrich provides functionalities to enrich georeferenced events (such as species occurrences) with environmental data from satellites or models. Users can specify a geographic or temporal buffer to include data in the neighbourhood of occurrences into their analyses. Two main outputs are available: a simple summary of the variable in the requested area, or the full data (as a geotiff raster, a png image, or a numpy array).

Sea surface temperature, chlorophyll, and 40 other environmental variables are available natively, and others can easily be added by the user. This package is intended for large numbers of occurrences: local storage is implemented to avoid redundant requests to remote servers.

The package provides functions to retrieve occurrence data directly from GBIF, or open a custom dataset from any source. Arbitrary areas defined by the user can also be enriched.

Documentation on Read the Docs.

Illustration of an occurrence dataset enriched with bathymetry data

Acknowledgment

This project is being developed as part of the G2OI project, cofinanced by the European union, the Reunion region, and the French Republic.

Union Européenne     Région Réunion     République Française

Installation

Installation instructions are in the documentation, for python and R.

Using the plugin

Jupyter Notebook tutorials are available for python and R.

Issues and further developments

User suggestions

Please feel free to raise issues or suggest improvements in the Issues tab.

Planned improvements

  • Enrich an area defined by a shapefile.
  • Add bathymetry from GEBCO.