Skip to content

AtlasOfLivingAustralia/galah-python

Repository files navigation

galah

pypi

Overview

galah-python is a Python interface to biodiversity data hosted by the Global Biodiversity Information Facility (GBIF) and those members of the GBIF node network that maintain their own APIs (i.e. the ‘living atlases’). These organisations collate and store observations of individual life forms, using the ‘Darwin Core’ data standard. galah-python was built and is maintained by the Science & Decision Support Team at the Atlas of Living Australia (ALA).

galah-python enables users to locate and download species occurrence records (observations, specimens, eDNA records, etc.), taxonomic information, or associated media such as images or sounds, and to restrict their queries to particular taxa or locations. Users can specify which columns are returned by a query, or restrict their results to occurrences that meet particular data-quality criteria. All functions return a Pandas DataFrame as their standard format.

The package is named for the bird of the same name (Eolophus roseicapilla), a widely-distributed endemic Australian species. The logo was designed by Ian Brennan.

If you have any comments, questions or suggestions, please contact us.

Getting started

  • The Getting Started Tutorial provides an introduction to the core package functions.
  • For an outline of the package structure, and a list of all the available functions, view the API docs page.

Installation

See the installation docs for full details.

Install the galah-python package

$ pip install galah-python

galah-python depends on the following packages:

  • numpy
  • pandas
  • requests
  • urllib3
  • TIME-python
  • zip-files
  • configparser
  • glob2
  • shutils
  • setuptools
  • shapely
  • pytest
  • unittest2py3k

Usage

Visit the galah package website for documentation and vignettes to get started.

License

galah-python was created by Amanda Buyan, with contributions by Caitlin Ramsay, Dax Kellie and Martin Westgate under a MPL-2.0 license.

Credits

galah-python was created with cookiecutter and the py-pkgs-cookiecutter template.