ITIS

itis.accepted_names(**kwargs)

Get accepted names from tsn

Parameters:
  • tsn – taxonomic serial number (TSN) (character or numeric)
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
# TSN accepted - good name
itis.accepted_names(tsn=208527)
# TSN not accepted - input TSN is old name
itis.accepted_names(tsn=504239)
itis.any_match_count(**kwargs)

Get any match count.

Parameters:
  • x – text or taxonomic serial number (TSN) (character or numeric)
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.any_match_count(x=202385)
itis.any_match_count(x="dolphin")
itis.comment_detail(as_dataframe=False, **kwargs)

Get comment detail from TSN

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.comment_detail(tsn=180543)
itis.common_names(as_dataframe=False, **kwargs)

Get common names from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.common_names(tsn=183833)
# no common names
itis.common_names(tsn=726872)
itis.core_metadata(as_dataframe=False, **kwargs)

Get core metadata from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
# coverage and currrency data
itis.core_metadata(tsn=28727)
# no coverage or currrency data
itis.core_metadata(tsn=183671)
itis.coverage(as_dataframe=False, **kwargs)

Get coverge from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
# coverage data
itis.coverage(tsn=28727)
# no coverage data
itis.coverage(526852)
# as data_frame
itis.coverage(526852, as_dataframe=True)
itis.credibility_rating(as_dataframe=False, **kwargs)

Get credibility rating from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.credibility_rating(tsn=526852)
itis.credibility_rating(28727)
itis.credibility_ratings()

Get possible credibility ratings

Parameters:**kwargs – Curl options passed on to requests.get
Returns:a dict

Usage:

from pytaxize import itis
itis.credibility_ratings()
itis.currency(as_dataframe=False, **kwargs)

Get currency from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
# currency data
itis.currency(28727)
# no currency dat
itis.currency(526852)
# as data_frame
itis.currency(526852, as_dataframe=True)
itis.date_data(as_dataframe=False, **kwargs)

Get date data from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.date_data(tsn=180543)
itis.experts(as_dataframe=False, **kwargs)

Get expert information for the TSN.

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.experts(tsn=180544)
itis.rank_name(as_dataframe=False, **kwargs)

Returns the kingdom and rank information for the TSN.

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.rank_name(tsn = 202385)
itis.hierarchy_full(as_dataframe=False, **kwargs)

Get full hierarchy from ts

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.hierarchy_full(tsn = 37906)
itis.hierarchy_full(tsn = 100800)
# as data_frame
itis.hierarchy_full(tsn = 100800, as_dataframe=True)
itis.full_record(lsid=None, **kwargs)

Returns the full ITIS record for a TSN or LSID

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • lsid – lsid for a taxonomic group (character)
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.full_record(tsn="504239")
itis.full_record(tsn="202385")
itis.full_record(tsn="183833")
itis.full_record(lsid="urn:lsid:itis.gov:itis_tsn:180543")
itis.full_record(lsid="urn:lsid:itis.gov:itis_tsn:37906")
itis.full_record(lsid="urn:lsid:itis.gov:itis_tsn:100800")
itis.geographic_divisions(as_dataframe=False, **kwargs)

Get geographic divisions from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.geographic_divisions(tsn=180543)
itis.geographic_values()

Get all possible geographic values

Parameters:**kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.geographic_values()
itis.hierarchy_down(as_dataframe=False, **kwargs)

Get hierarchy down from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.hierarchy_down(tsn = 179913)
itis.hierarchy_up(as_dataframe=False, **kwargs)

Get hierarchy up from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.hierarchy_up(tsn = 36485)
itis.hierarchy_up(tsn = 37906)
itis.terms(what='both', as_dataframe=False, **kwargs)

Get itis terms

Parameters:
  • x – query term
  • what – One of both (search common and scientific names), common (search just common names), or scientific (search just scientific names)
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.terms("bear")
itis.terms("bear", what="common")
itis.terms("Poa", what="scientific")
itis.terms("bear", as_dataframe=True)
itis.global_species_completeness(as_dataframe=False, **kwargs)

Get global species completeness from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.global_species_completeness(180541)
itis.jurisdictional_origin(as_dataframe=False, **kwargs)

Get jurisdictional origin from tsn

Parameters:
  • tsn – (int) TSN for a taxonomic group
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.jurisdictional_origin(180543)
itis.jurisdictional_origin(180543, True)
itis.jurisdiction_origin_values(**kwargs)

Get jurisdiction origin values

Parameters:
  • as_dataframe – (bool) specify return type, if pandas is available
  • **kwargs – Curl options passed on to requests.get

Usage:

from pytaxize import itis
itis.jurisdiction_origin_values()
itis.jurisdiction_values()

Get possible jurisdiction values

Parameters:**kwargs – Curl options passed on to requests.get
Returns:list

Usage:

from pytaxize import itis
itis.jurisdiction_values()