Simple search

import pykew.ipni as ipni

result = ipni.search('Poa annua')

Advanced search

import pykew.ipni as ipni
from pykew.ipni_terms import Name

query = { Name.genus: 'Poa', Name.species: 'annua' }
res = ipni.search(query)

Filtering

You can filter a given result set by taxonomic rank.

import pykew.ipni as ipni
from pykew.ipni_terms import Filters

res = ipni.search('Poa', filters = Filters.infraspecific)

Using results

Results sets are returned as an iterator which can be manipulated as you generally would in python. The result object also implements size() efficiently - it does not fetch all results to count them.

import pykew.ipni as ipni
from pykew.ipni_terms import Name

query = { Name.genus: 'Poa', Name.species: 'annua' }
res = ipni.search(query)

res.size()
[r['name'] for r in res if 'name' in r]

Simple search

import pykew.powo as powo

result = powo.search('Poa annua')

Advanced search

import pykew.powo as powo
from pykew.powo_terms import Name

query = { Name.genus: 'Poa', Name.species: 'annua' }
res = powo.search(query)

Filtering

You can filter a given result set by accepted taxa, taxa with images, and taxonomic rank.

import pykew.powo as powo
from pykew.powo_terms import Filters

res = powo.search('Poa', filters = [Filters.accepted, Filters.species])

Individual record

import pykew.powo as powo

res = powo.lookup('urn:lsid:ipni.org:names:320035-2')

import pykew.powo as powo

res = powo.lookup('urn:lsid:ipni.org:names:320035-2', include=['distribution'])
native_to = [d['name'] for d in res['distribution']['natives']]

Using results

Results sets are returned as an iterator which can be manipulated as you generally would in python. The result object also implements size() efficiently - it does not fetch all results to count them.

import pykew.powo as powo
from pykew.powo_terms import Name, Geography

query = { Name.genus: 'Poa', Geography.distribution: 'Africa' }
res = powo.search(query)

res.size()
[r['name'] for r in res if 'name' in r]