Repository for ATHEN (Annotation and Text Highlighting Environment!

What is it?

ATHEN is an Annotation Environment based on Eclipse4 RCP. In its core it uses UIMA and allows the editing of .xmi -text documents as well as unnanotated .txt documents. (Other formats will be supported by version 1.0 but are currently unsupported)

It allows to assign a multitude of different stylings for your types and allows the creation and changing of annotation of thelike. It supports the creation of Apache Lucene Indexes, based on UIMA annotations to be able to query your corpus and get a quick insight into your analysis rules.

On top there is special support in ATHEN for editing Named Entities, Coreferences, Scenes and direct speech. On top there is a view that supports an OWL-based information extraction and ontology creation.

ATHEN was built to support novel-sized documents and should therefore be relatively efficient for huge documents.

Download

To download the newst version of ATHEN, just select the according .zip for your platform and download it:

http://ki.informatik.uni-wuerzburg.de/nappi/release/

it contains an executable that launches ATHEN, if you want to build it from source you should follow the Installation from source section

Installation from source

Download or clone the master branch

git clone https://gitlab2.informatik.uni-wuerzburg.de/mak28ma/Athen_maven.git

The next step requires you to have Maven available and installed. Switch to the main directory "de.uniwue.mk.athen" and execute in the command line

mvn clean install 

NOTE:(This requires you to have Java 8 and a Maven Version newer than 3.05) this will download all requirements by accessing different software sites, make sure you got a stable internet connection.

After the build (which can take a few minutes if you build it for the first time) you can find executables for your platform in the folder:

de.uniwue.mk.athen\releng\de.uniwue.mk.athen.product\target\products\de.uniwue.mkrug.kallimachos.athen

Launch your according executable.

**Note: if you cannot build it and just want a made executable, just contact me: markus.krug@uni-wuerzburg.de **

Introduction to the functionality of ATHEN and Tutorials!

[Tutorial] ATHEN -First time use

[Tutorial] ATHEN -Labelling Syntactic Parsing

[Prcoess description] ATHEN -Rule based ontology driven Information Extraction

[Tutorial] ATHEN -Switch workspace

[Tutorial] ATHEN -Import data

[Tutorial] ATHEN -Annotating Coreferences and Character References

[Tutorial] ATHEN -Annotating Direct Speech, including Speaker and Addressee

[Tutorial] ATHEN -Comparing Annotations

[Tutorial] ATHEN -Annotating Speech-, Thought- and Writing Representation (STWR)

Utility of ATHEN

Even though there is still a lot of work in progress, ATHEN comes with a bunch of utility, read the according instructions if you want to know how they work:

[Instruction] ATHEN -Index your XMI documents with Lucene

TODO - Converting Documents between formats in ATHEN

TODO - Preprocessing documents in ATHEN with Nappi

Extending ATHEN

ATHEN is written as a eclipse 4 RCP Application, which means it is based on plugins that can be loaded dynamically at runtime. Currently ATHEN supports the loading of a new view for the annotation perspective while ATHEN is running. If you need to know how this works, please contact me.

If you are interested in extending the functionality of ATHEN you should consider reading the developer handbook of ATHEN

Troubleshooting and contact

If problems occur you can check ATHEN -troubleshooting

and see whether your problem is known and has a workaround. If not you should contact us at: athen@informatik.uni-wuerzburg.de