Reconciliation Service IpniName

Reconciliation Service URL: 

Service description

Initial reconciliation service matching scientific names to those in the International Plant Name Index (IPNI).

A note about handling ranks

Not relevant if you are using the reconciliation service with a single query string, i.e. without having your data split up into columns like family, genus, species etc.

So that all ranks can be handled, this matcher takes three ordered epithet arguments. Names of generic rank or higher should be supplied as epithet_1, names of infrageneric or specific rank should also include epithet_2, infraspecific names have the infraspecific epithet as epithet_3.

rank of name epithet_1 epithet_2 epithet_3
above family epithet
family familial
infrafamily infrafamilial
genus generic
infragenus generic infrageneric
species generic specific
infraspecies generic specific infraspecific

Presence or absence of fields

  • epithet_1 is mandatory.
  • epithet_2 and epithet_3, if present in the query, will be present in all results. If not in the query only names without a second or third epithet will be returned.
  • basionym_author and publishing_author will be matched (on either side) by a blank field.
  • full_name is ignored, it’s there due to a limitation of the software at present.

Contains 1451247 records.

Service detail

Queries sent as a single field are first split up into Properties. Each property (both the query and the authoritative value) is transformed by every Transformer in turn. The results are compared using the Matchers, on every property.

PropertyTransformersMatcher
epithet_1org.kew.rmf.transformers.LowerCaseTransformer
org.kew.rmf.transformers.botany.FakeHybridSignCleaner
org.kew.rmf.transformers.StripNonAlphabeticCharactersTransformer
org.kew.rmf.transformers.DictionaryRegexTransformer
org.kew.rmf.transformers.botany.EpithetTransformer
org.kew.rmf.matchers.ExactMatcher
epithet_2org.kew.rmf.transformers.LowerCaseTransformer
org.kew.rmf.transformers.botany.FakeHybridSignCleaner
org.kew.rmf.transformers.StripNonAlphabeticCharactersTransformer
org.kew.rmf.transformers.DictionaryRegexTransformer
org.kew.rmf.transformers.botany.EpithetTransformer
org.kew.rmf.matchers.LevenshteinMatcher
epithet_3org.kew.rmf.transformers.LowerCaseTransformer
org.kew.rmf.transformers.botany.FakeHybridSignCleaner
org.kew.rmf.transformers.StripNonAlphabeticCharactersTransformer
org.kew.rmf.transformers.DictionaryRegexTransformer
org.kew.rmf.transformers.botany.EpithetTransformer
org.kew.rmf.matchers.LevenshteinMatcher
basionym_authororg.kew.rmf.transformers.authors.StripPublishingAuthorTransformer
org.kew.rmf.transformers.DictionaryTransformer
org.kew.rmf.transformers.authors.StripExAuthorTransformer
org.kew.rmf.transformers.authors.StripInAuthorTransformer
org.kew.rmf.transformers.authors.ShrunkAuthors
org.kew.rmf.matchers.CommonTokensMatcher
publishing_authororg.kew.rmf.transformers.authors.StripBasionymAuthorTransformer
org.kew.rmf.transformers.DictionaryTransformer
org.kew.rmf.transformers.authors.StripExAuthorTransformer
org.kew.rmf.transformers.authors.StripInAuthorTransformer
org.kew.rmf.transformers.authors.ShrunkAuthors
org.kew.rmf.matchers.CommonTokensMatcher
full_nameorg.kew.rmf.matchers.AlwaysMatchingMatcher

Properties

The Reconciliation Service can determine these automatically, or they can be overridden in the OpenRefine interface.

For the JSON web service these should be URL-encoded HTTP GET parameters.

The CSV file upload must use these properties as header lines.

  • epithet_1
  • epithet_2
  • epithet_3
  • basionym_author
  • publishing_author
  • full_name

Service endpoints

  • Open Refine reconciliation service: 
  • JSON web service: 
  • CSV file upload: 
     

Version UNKNOWN.

Reconciliation Service