checklist module

class pyobis.checklist.ChecklistResponse(url, args, paginate)[source]

An OBIS Checklist Response Object

Usage

from pyobis import checklist

query = checklist.list(taxonid=127405, **kwargs)
query.api_url  # Returns the API URL
query.to_pandas()  # Returns a pandas DataFrame object

Methods:

pyobis.checklist.list(scientificname=None, taxonid=None, nodeid=None, startdate=None, enddate=None, startdepth=None, enddepth=None, geometry=None, flags=None, **kwargs)[source]

Generate an OBIS checklist

Parameters:
  • taxonid – [Fixnum] A obis occurrence identifier

  • scientificname – [String,Array] One or more scientific names from the OBIS backbone. All included and synonym taxa are included in the search.

  • geometry – [String] Well Known Text (WKT). A WKT shape written as either POINT, LINESTRING, LINEARRING or POLYGON. Example of a polygon: ((30.1 10.1, 10 20, 20 40, 40 40, 30.1 10.1)) would be queried as https://api.obis.org/v3/occurrence?geometry=POLYGON%28%2830.1+10.1%2C+10+20%2C+20+40%2C+40+40%2C+30.1+10.1%29%29

  • nodeid – [Fixnum] Node UUID.

  • startdate – [String] Start date YYYY-MM-DD

  • enddate – [String] End date YYYY-MM-DD

  • startdepth – [Fixnum] Start depth, in meters. Depth below sea level are treated as positive numbers.

  • enddepth – [Fixnum] End depth, in meters. Depth below sea level are treated as positive numbers.

  • flags – [String] Comma separated list of quality flags which need to be set

Returns:

A dictionary

Usage:

from pyobis import checklist
checklist.list(scientificname = 'Mola mola').execute()

# taxonid of 3013
checklist.list(taxonid = 3013).execute()
pyobis.checklist.redlist(scientificname=None, taxonid=None, nodeid=None, startdate=None, enddate=None, startdepth=None, enddepth=None, geometry=None, flags=None, **kwargs)[source]

Generate a checklist of IUCN Red List species.

Parameters:
  • scientificname – [String] Scientific name. Leave empty to include all taxa.

  • taxonid – [String] Taxon AphiaID.

  • nodeid – [String] Node UUID.

  • startdate – [String] Start date formatted as YYYY-MM-DD.

  • enddate – [String] End date formatted as YYYY-MM-DD.

  • startdepth – [Fixnum] Start depth, in meters. Depth below sea level are treated as positive numbers.

  • enddepth – [Fixnum] End depth, in meters. Depth below sea level are treated as positive numbers.

  • geometry – [String] Geometry, formatted as WKT or GeoHash.

  • flags – [String] Comma separated list of quality flags which need to be set.

Returns:

A dictionary

Usage:

from pyobis import checklist
checklist.redlist(scientificname='Abra Alba').execute()
pyobis.checklist.newest(scientificname=None, taxonid=None, nodeid=None, startdate=None, enddate=None, startdepth=None, enddepth=None, geometry=None, flags=None, **kwargs)[source]

Generate a checklist of most recently added species.

Parameters:
  • scientificname – [String] Scientific name. Leave empty to include all taxa.

  • taxonid – [String] Taxon AphiaID.

  • nodeid – [String] Node UUID.

  • startdate – [String] Start date formatted as YYYY-MM-DD.

  • enddate – [String] End date formatted as YYYY-MM-DD.

  • startdepth – [Fixnum] Start depth, in meters. Depth below sea level are treated as positive numbers.

  • enddepth – [Fixnum] End depth, in meters. Depth below sea level are treated as positive numbers.

  • geometry – [String] Geometry, formatted as WKT or GeoHash.

  • flags – [String] Comma separated list of quality flags which need to be set.

Returns:

A dictionary

Usage:

from pyobis import checklist
checklist.newest(scientificname='Abra Alba')