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_down(tsn = 161994)
itis.hierarchy_down(tsn = 9999999)

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()