jbjorne / TEES

Turku Event Extraction System
147 stars 44 forks source link

Turku Event Extraction System 2.3

Turku Event Extraction System (TEES) is a free and open source natural language processing system developed for the extraction of events and relations from biomedical text. It is written mostly in Python, and should work in generic Unix/Linux environments.

TEES has been evaluated in the following Shared Tasks and models for predicting their targets are included in this release.

For more information and documentation, see the TEES wiki at https://github.com/jbjorne/TEES/wiki

Quick Start

To get started with TEES, download the latest stable release from http://sourceforge.net/projects/tees/files or the current version from the repository. After downloading, TEES can optionally be installed as a module using "setup.py", but this is not required, and the program can simply be used from the unpacked archive.

However, before using TEES the external programs and datafiles need to be installed using the interactive configuration tool "configure.py", located in the package root directory:

python configure.py

After TEES had been configured, you can predict events or relations for text with classify.py. Using the "-m" (model) switch, you can select one of the pre-computed models (listed at https://github.com/jbjorne/TEES/wiki/Classifying). For example, to run TEES prediction for the BioNLP 2011 GENIA development corpus, use:

python classify.py -m GE11-devel -i GE11-devel -o OUTSTEM

where "OUTSTEM" is the output file stem. To try TEES on unannotated text, you can give "classify.py" a PubMed citation id, such as:

python classify.py -m GE11 -i 9668063 -o OUTSTEM

TEES will download the abstract and use the integrated preprocessing pipeline to split the text into sentences (with the GENIA Sentence Splitter, http://www.nactem.ac.uk/y-matsu/geniass/), detect named entities (with BANNER, http://banner.sourceforge.net/) and parse the text (with BLLIP Parser using David McClosky's biomodel, http://bllip.cs.brown.edu/resources.shtml and Stanford format conversion, http://nlp.stanford.edu/software/lex-parser.shtml), after which events are detected from the document.

Using TEES

The primary user interface to TEES consists of the following programs

For information on using these programs, see the TEES wiki at https://github.com/jbjorne/TEES/wiki

TEES also has a number of modules that can be used as standalone executables, including the wrappers for external tools such as parsers. A list of these executables can be found at https://github.com/jbjorne/TEES/wiki/Programs

Citing

If you use TEES in a publication, please cite the following book:

@phdthesis{bjorne2014biomedical, title={Biomedical Event Extraction with Machine Learning}, author={Bj{\"o}rne, Jari}, year={2014}, school={University of Turku}, publisher={TUCS Dissertations} }

TEES uses several external components, for more information on their licensing terms please see https://github.com/jbjorne/TEES/wiki/Licenses.