Cognate Morfessor - Quick start
===============================


Installation
------------

Morfessor 2.0 is installed using setuptools library for Python. To
build and install the module and scripts to default paths, type

python setup.py install

For details, see http://docs.python.org/install/

Cognate Morfessor has a dependency on python-Levenshtein.

Documentation
-------------

TODO: User instructions for Cognate Morfessor.

The relevant commands are called
morfessorcognate-train and morfessorcognate-segment .
View their source code for usage.

These scripts might be helpful for preprocessing:
scripts/tools/merge_lists.py
scripts/tools/extract_seg_maps.py

Citing
------

Details of the algorithm and experiments applying it to NMT
are described in the following paper:

Stig-Arne Grönroos, Sami Virpioja, and Mikko Kurimo.
Cognate-aware morphological segmentation for multilingual
neural translation.
Proceedings of the Third Conference on Machine Translation,
Brussels, Belgium, Oct 2018. Association for Computational
Linguistics.

(To appear. FIXME: add link)


Contact
-------

Questions or feedback? Email: morpho@aalto.fi