A package to enrich your geo-referenced data (eg. species occurrences) with environmental data.
Project description
geoenrich
Package description
This package provides functionalities to enrich georeferenced events (such as species occurrences) with environmental data from satellites or models. It is intended for large numbers of occurrences: local storage is implemented to avoid redundant requests to remote servers. All downloaded environmental data are stored locally in netCDF files and can be retrieved as multidimensional numpy arrays to be used in any way.
The package provides functions to retrieve occurrence data directly from GBIF, or open a custom DarwinCore archive from any source. These occurrences are then stored into csv databases that record the netCDF coordinates for the relevant subsets of each environmental variables.
All environmental variables used for enrichment must have latitude and longitude dimensions. The package also handles time and depth dimensions.
Documentation on Read the Docs.
Installation
Installation instructions in the documentation.
Using the plugin
A Jupyter Notebook tutorial is available at the root of the repository.
Issues and further developments
User suggestions
Please feel free to raise issues or suggest improvements in the Issues tab.
Planned improvements
Depth requests
There are currently only two options regarding the depth dimension : only surface data, or data for all depths. We plan to add an option to download data for any range of depth.
Temporary netCDF files copies
To improve reliability we will make temporary backups of netCDF files being written in, to be able to recover data in case writing is interrupted or fails.
Variable statistics.
For each occurrence, we will return average, standard deviation, minimum and maximum of the variable in the bounding box.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.