OpenGrm NGram README

OpenGrm NGram - Release 0.1 (Beta)

The OpenGrm NGram library is used for making and modifying n-gram language models encoded as weighted finite-state transducers (FSTs). It makes use of functionality in the OpenFst library to create, access and manipulate n-gram models.

REQUIREMENTS:

This version is known to work under Linux and MacOS using g++ (≥ 4.2). Expected to work wherever adequate POSIX (dlopen, ssize_t, basename), c99 (snprintf, strtoll, <stdint.h>), and tr1 (<tr1/ordered_set>, <tr1/ordered_map>) support are available.

It is assumed you have OpenFst (www.openfst.org) 1.2.10 or higher and have installed it. Make sure you configure it with the --enable-far flag.

INSTALLATION:

Follow the generic GNU build system instructions in ./INSTALL. We recommend configuring with --enable-static=no for faster compiles.

Configuring with --enable-bin=no gives very fast compiles, but excludes the command line utilities.

Compiling with -Wall -Wno-sign-compare under g++ should give no warnings from this library.

USAGE:

To use in your own programs you will need to include <ngram/ngram.h>. Compile with '-I /usr/local/include' and link against /usr/local/lib/libfst.so, /usr/local/lib/fst/libfstfar.so and /usr/local/lib/libngram.so. Set your LD_LIBRARY_PATH (or equivalent) to contain /usr/local/lib.

The linking is, by default, dynamic so that the Fst and Arc type DSO extensions can be used correctly if desired.

DOCUMENTATION:

www.opengrm.org

See ./NEWS for updates since the last release.

-- MichaelRiley - 09 Dec 2011