Skip to main content

Acromine based Disambiguation of Entities From Text

Project description


License Build Documentation PyPI version Python 3

Adeft (Acromine based Disambiguation of Entities From Text context) is a utility for building models to disambiguate acronyms and other abbreviations of biological terms in the scientific literature. It makes use of an implementation of the Acromine algorithm developed by the NaCTeM at the University of Manchester to identify possible longform expansions for shortforms in a text corpus. It allows users to build disambiguation models to disambiguate shortforms based on their text context. A growing number of pretrained disambiguation models are publicly available to download through adeft.


Adeft works with Python versions 3.5 and above. It is available on PyPi and can be installed with the command

$ pip install adeft

Adeft's pretrained machine learning models can then be downloaded with the command

$ python -m

Using Adeft

A dictionary of available models can be imported with from adeft import available_models

The dictionary maps shortforms to model names. It's possible for multiple equivalent shortforms to map to the same model.

Here's an example of running a disambiguator for ER on a list of texts

from adeft.disambiguate import load_disambiguator

er_dd = load_disambiguator('ER')



Users may also build and train their own disambiguators. See the documention for more info.


Documentation is available at

Jupyter notebooks illustrating Adeft workflows are available under notebooks:


Adeft uses nosetests for unit testing, and is integrated with the Travis continuous integration environment. To run tests locally, make sure to install the test-specific requirements listed in as

pip install adeft[test]

and download all pre-trained models as shown above. Then run nosetests in the top-level adeft folder.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for adeft, version 0.3.0
Filename, size File type Python version Upload date Hashes
Filename, size adeft-0.3.0-py2.py3-none-any.whl (29.2 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size adeft-0.3.0.tar.gz (23.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page