Skip to content

Latest commit

 

History

History
85 lines (65 loc) · 3.18 KB

README.md

File metadata and controls

85 lines (65 loc) · 3.18 KB
Raw

CogComp Part-of-Speech Tagger

Part-of-Speech Tagging is the identification of words as nouns, verbs, adjectives, adverbs, etc.

Usage

If you want to use this in your project, you need to take two steps. First add the dependencies, and then call the functions in your program. Here is how you can add maven dependencies into your program:

    <repositories>
        <repository>
            <id>CogCompSoftware</id>
            <name>CogCompSoftware</name>
            <url>http://cogcomp.org/m2repo/</url>
        </repository>
    </repositories>
    
    <dependencies>
        <dependency>
            <groupId>edu.illinois.cs.cogcomp</groupId>
            <artifactId>illinois-pos</artifactId>
            <version>VERSION</version>
        </dependency>
    </dependencies>

Note: Make sure to change the pom.xml parameter VERSION to the latest version of the project.

In general, the best way to use the POS Tagger is through the POSAnnotator class. Like any other annotator, it is used by calling the addView() method on the TextAnnotation containing sentences to be tagged.

	POSAnnotator posannotator = new POSAnnotator();
	posannotator.doInitialize();
	posannotator.addView(ta);

Models

When usingPOSAnnotator, the models are loaded automatically from the directory specified in the Property POSConfigurator.MODEL_PATH

Thus, to use your own models, simply place them in this directory and they will be loaded; otherwise, the model version specified in this project's pom.xml file will be loaded from the Maven repository and used.

Note : To use your own models, exclude the illinois-pos-models artifact from the illinois-pos dependency in your pom.xml.

Training

The class POSTrain contains a main method that can be used to train the models for a POS tagger provided you have access to the necessary training data. It can be called from the top-level of the POS sub-project using the following command.

mvn exec:java -Dexec.mainClass="edu.illinois.cs.cogcomp.pos.POSTrain"

To specify the configuration file for training, please pass it as the first argument. For example,

mvn exec:java -Dexec.mainClass="edu.illinois.cs.cogcomp.pos.POSTrain" -Dexec.args="./config/default.properties"

Citation

Thank you for citing us if you use us in your work! http://cogcomp.org/page/software_view/POS

@inproceedings{RothZe98,
    author = {D. Roth and D. Zelenko},
    title = {Part of Speech Tagging Using a Network of Linear Separators},
    booktitle = {Coling-Acl, The 17th International Conference on Computational Linguistics},
    pages = {1136--1142},
    year = {1998},
    acceptance = {137/550 (25\%)},
    url = " http://cogcomp.org/papers/pos.pdf",
    funding = {NSF98,KDI},
    projects = {SI,NLP},
}

@inproceedings{Even-ZoharRo01,
    author = {Y. Even-Zohar and D. Roth},
    title = {A Sequential Model for Multi Class Classification},
    booktitle = {EMNLP},
    pages = {10-19},
    year = {2001},
    url = " http://cogcomp.org/papers/emnlp01.pdf"
}