NaCTeM

Acromine Disambiguation Web Service (Request Access)

Acromine Disambiguation Web Service provides a SOAP interface, where your applications can associate every occurrence of abbreviations with their definitions.

WSDL

Sample

Overview of the API

Acromine Disambiguation Web Service provides the SOAP interface that exports a function analyze. Given a bio-medical text, the analyze function finds all occurrences of abbreviations by consulting the Acromine dictionary. Since a number of abbreviations have multiple definitions (e.g., electron spin resonance, erythrocyte sedimentation rate, estrogen receptor for the abbreviation ESR), the function estimates the most suitable definition for each abbreviation based on its context in the text.

Format of the result

Disambiguation results are returned as a string in an XML-like format. The given text are represented as child nodes (including #PCDATA) of the root element <result>. The function inserts an XML element <abbrdef> for every occurrence of abbreviation definitions in the text. An attribute pid in element <abbrdef> denotes a unique definition number. An element <abbrdef> contains <sf> and <lf> elements that annotate an abbreviation (short form) and its definition (long form), respectively.

The function inserts an XML element <abbr> for every occurrence of known abbreviations that do not accompany their definitions in the text. An attribute pid, sfid, and longform in element <abbr> denote a unique definition number, a unique shortform number, and the long form corresponding to the abbreviation.

  • <result>
    • <abbrdef pid="defid">: abbreviation definitions
      • <lf> ... </lf>: the definition (long form)
      • <sf> ... </sf>: the abbreviation (short form)
    • </abbrdef>
    • <abbr pid="defid" sfid="sfid" longform="longform">: global abbreviations (without definitions)
      • the abbreviation (short form)
    • </abbr>
  • </result>