This repository contains implementation of the Temporal Role Tagger. Most existing NERD applications are not able to detect or resolve ambiguities that require the determination of a temporal context for their correct interpretation, such as in temporal roles like CEO of a company, Soccer World Champion, or head of a country, i.e. descriptions of the position or purpose of specific named entities in specific situations that change over time.
The aim of this project is detection temporal roles in a given sentence.
The introduced pipeline here consists of multiple components as follows:
The text fragments were manually selected from the New York Times news corpus version 2008 as well as from English Wikipedia articles and comprise 178 positive and negative sentences.
Each role has been annotated with two tages: <RP Categoty='CAT'> for role phrases and <HR> for head roles.
<HR> identifies the most general variant of a role with potential high ambiguity, and the <RP Categoty='CAT'> further specifying the role with sufficient details for successful disambiguation, as e.g. in "the acting President of the U.S." the term "President" is the head role, while the entire phrase constitutes the role phrase including further specifications:
<RP Categoty='HEAD_OF_STATE_TAG'>the acting <HR>President</HR> of the U.S.</RP>
In this project CAT could be:
- HEAD_OF_STATE_TAG
- POPE_TAG
- MONARCH_TAG
- CHAIR_PERSON_TAG
Before able to run the code, few steps should be done.
- Downloading Standford CoreNLP pre-trained models anding putting them in the
/src/main/resourcesfolder - Downloading Wikipedia dump file and running wikiextractor by
-lflag to preserving the links. After running extractor, move the files to thewikipediafilesfolder in the project root directory. - Download
article_categories_en.ttlfrom DBpedia download portal. Create a folder namedcategoryin the project root directory and move the file there. - Download
skos_categories_en.ttlfrom DBpedia download portal and move it to thecategoryin the project root directory. - Download
redirectPagefrom this link and move it torequirementsfolder in the project root directory
Running inside Eclipse This project is based on Gradle. So it could be easily imported to Eclipse. For importing it the Eclipse should contain Buildship Plugin. After installing Buildship Plugin, you can easily import the project into the Eclipse as a Gradle project.
Running in Terminal
For running the project in terminal, first the project should be built. Run ./gradlew installDist. Then you only need to modify config.properties in build/install/RoleTagger/bin and finally run build/install/RoleTagger/bin/RoleTagger.bat or build/install/RoleTagger/bin/RoleTagger.sh.
Modifying Pipeline
To be able to en/dis able the components in the pipeline, the PipeLine class can be modified.