From c742a52fcdb475f3131830f7df91de12cd7dd90a Mon Sep 17 00:00:00 2001 From: Chris Dyer Date: Tue, 2 Oct 2012 01:10:44 -0400 Subject: new readme --- README | 57 --------------------------------------------------------- README.md | 21 +++++++++++++++++++++ 2 files changed, 21 insertions(+), 57 deletions(-) delete mode 100644 README create mode 100644 README.md diff --git a/README b/README deleted file mode 100644 index 47b52355..00000000 --- a/README +++ /dev/null @@ -1,57 +0,0 @@ -cdec is a fast decoder. - -SPEED COMPARISON ------------------------------------------------------------------------------- - -Here is a comparison with a couple of other decoders doing SCFG decoding: - - Decoder Lang. BLEU Run-Time Memory - cdec c++ 31.47 0.37 sec/sent 1.0-1.1GB - Joshua Java 31.55 2.34 sec/sent 4.0-4.8GB - Hiero Python 31.22 27.2 sec/sent 1.7-1.9GB - -The maximum number of pops from candidate heap at each node is k=30, no other -pruning, 3gm LM, Chinese-English translation task. - - -GETTING STARTED ------------------------------------------------------------------------------- - -See the BUILDING file for instructions on how to build the software. To -explore the decoder's features, the best way to get started is to look -at cdec's command line options or to have a look at the test cases in -the tests/system_tests/ directory. Each of these can be run with a command -like ./cdec -c cdec.ini -i input.txt -w weights . The files should be -self explanatory. - - -EXTRACTING A SYNCHRONOUS GRAMMAR / PHRASE TABLE ------------------------------------------------------------------------------- -cdec does not include code for generating grammars. To build these, you will -need to write your own software or use an existing package like Joshua, Hiero, -or Moses. - - -OPTIMIZING / TRAINING MODELS ------------------------------------------------------------------------------- -cdec does include code for optimizing models, according to a number of -training criteria, including training models as CRFs (with latent derivation -variables), MERT (over hypergraphs) to opimize BLEU, TER, etc. - -Eventually, I will provide documentation for this. - - -ALIGNMENT / SYNCHRONOUS PARSING / CONSTRAINED DECODING ------------------------------------------------------------------------------- -cdec can be used as an aligner. For examples, see the test cases. - - -COPYRIGHT AND LICENSE ------------------------------------------------------------------------------- -Copyright (c) 2009 by Chris Dyer - -See the file LICENSE.txt for the licensing terms that this software is -released under. This software also includes the file m4/boost.m4 which is -licensed under the LGPL v3, for more information refer to the comments -in that file. - diff --git a/README.md b/README.md new file mode 100644 index 00000000..d19fda3e --- /dev/null +++ b/README.md @@ -0,0 +1,21 @@ +`cdec` is a research platform for machine translation and similar structured prediction problems. + +## Installation + +Build `cdec`: + + autoreconf -ifv + ./configure + make + ./tests/run-system-tests.pl + +You will need the following libraries / tools: + + boost + GNU Autotools + GNU Flex + +## Further information + +[For more information, refer to the cdec documentation](http://www.cdec-decoder.org) + -- cgit v1.2.3