Skip to main content

A library for Species Occurence data retrieval from GBIF, iNaturalist, and SpeciesLink APIs.

Project description

USAGE.md

Overview

ecoobs is a library designed to facilitate data management and processing for scientific and research applications.

Getting Started

Installation

pip install ecoobs

Basic Usage

import ecoobs

# Example: Download occurrences from GBIF, iNaturalist, and SpeciesLink - INaturalist doesn't require any authentication.
ecoobs.save_specieslink_apikey(apikey)
ecoobs.save_gbif_credentials(user, email, pwd)
species_names = ["Panthera onca", "Lynx rufus"]
df = ecoobs.get_occurrences(
    species_names,
    country="Brazil",
    year_range=(2000, 2020),
)

Functions

  • get_occurrences(species_names, country=None, year_range=None, lat_min=None, lat_max=None, lon_min = None, lon_max = None, includeGbif = True, includeInaturalist = True, includeSpeciesLink = True): Fetches occurrence data for the specified species from GBIF, iNaturalist, and SpeciesLink (you can choose the source), with optional filters for country, year range, and latitude bounds.
  • get_species_autocomplete(name): Retrieves a list of species suggestions from GBIF based on the provided name.
  • save_gbif_credentials(user, email, pwd): Saves GBIF user credentials for authenticated requests.
  • save_specieslink_apikey(apikey): Saves the API key for SpeciesLink requests.
  • delete_gbif_credentials(): Deletes stored GBIF user credentials.
  • delete_specieslink_apikey(): Deletes the stored SpeciesLink API key.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

ecoobs-0.1.0.tar.gz (11.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

ecoobs-0.1.0-py3-none-any.whl (12.8 kB view details)

Uploaded Python 3

File details

Details for the file ecoobs-0.1.0.tar.gz.

File metadata

  • Download URL: ecoobs-0.1.0.tar.gz
  • Upload date:
  • Size: 11.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for ecoobs-0.1.0.tar.gz
Algorithm Hash digest
SHA256 9ebab13c5afea245623c32b0b3c020b218be1e700b1a4d614674c39d783d051c
MD5 98c16809f7d29ce66488e896e16f5997
BLAKE2b-256 b6deb8661073888572b926787ccb9b55d18a6aa2703782ddbafaecc566d1bb55

See more details on using hashes here.

File details

Details for the file ecoobs-0.1.0-py3-none-any.whl.

File metadata

  • Download URL: ecoobs-0.1.0-py3-none-any.whl
  • Upload date:
  • Size: 12.8 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.12.9

File hashes

Hashes for ecoobs-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 31cd77b065c77ca26ae18efed61ff61ffc2bcb728022b1afd68a57581a2eeead
MD5 d620c7ed611d4d2931bd9da88385aa45
BLAKE2b-256 5bd8c1830a4a7df2e69b1205dd7b8c013c79561283c8206d363175d096713816

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page