Stanford Lexicalized Parser v1.5.1 - 30 May 2006.
-------------------------------------------------

Copyright (c) 2002-2006 The Board of Trustees of 
The Leland Stanford Junior University. All Rights Reserved.

Original core parser code by Dan Klein.
Support code, additional modules, languages, features,
internationalization, compaction, typed dependencies, etc. by
Christopher Manning, Roger Levy, Teg Grenager, Galen Andrew, Bill
MacCartney, Marie-Catherine de Marneffe, Huihsin Tseng, Pi-Chuang Chang
and Wolfgang Maier.  
This release prepared by Christopher Manning.

This package contains 3 parsers: a high accuracy unlexicalized PCFG, a
lexical dependency parser, and a factored model, where the estimates of
dependencies and an unlexicalized PCFG are jointly optimized to give a
lexicalized PCFG treebank parser.  Also included are grammars for
various languages for use with these parsers.

For more information about the parser, point a web browser at the included
javadoc direcotry, starting at the Package page for
the edu.stanford.nlp.parser.lexparser package, and looking
also at the LexicalizedParser class documentation therein.

This software requires Java 5 (JDK 1.5.0+).


QUICKSTART

UNIX

On a Unix system you should be able to parse the English test file with
the following command

Type in a shell open to this directory:  ./lexparser.csh testsent.txt

This actually uses the PCFG parser, which is quick to load and run,
and quite accurate.  

[Notes: it takes a few seconds to load the parser data before parsing 
begins; continued parsing is quicker. To use the lexicalized parser,
replace englishPCFG.ser.gz with englishFactored.ser.gz in the lexparser.csh
script. For other languages you also have to specify a language pack.
See the Javadoc parser.lexparser package documenation.]

WINDOWS

On a Windows system, assuming that java is on your PATH, you should be
able to run a parsing GUI by double-clicking on the lexparser-gui.bat icon,
or giving the command lexparser-gui in this directory from a command prompt.

Click Load File, Browse, and navigate to and select testsent.txt in the top
directory of the parser distribution.  Click Load Parser, Browse, and
select englishPCFG.ser.gz in the same directory.  Click Parse to
parse the first sentence.

(This GUI is also available under Unix -- try lexparser-gui.csh; 
conversely the command line parser runs equally well under Windows,
using lexparser.bat.)


DOING OTHER THINGS

The parser is supplied with several grammars. There are English grammars
both based on the standard LDC Penn Treebank WSJ secs 2-21, and ones
based on a slightly augmented data set.  There are Chinese grammars
trained just on mainland material from Xinhua and more mixed material
from the LDC Chinese Treebank, and there is a German parser trained from
the Negra corpus.  We also provide several test sentences.  You can
train your own parsers given suitable hand-annotated treebanks, and you
can specify many options, some at parsing time and others at training
time.  See the Javadoc for more information about available options.
The file lexparser-zh-utf8.csh shows one example of setting options for
parsing UTF-8 encoded Chinese.


LICENSE

// StanfordLexicalizedParser -- a probabilistic lexicalized NL CFG parser
// Copyright (c) 2002-2006 The Board of Trustees of 
// The Leland Stanford Junior University. All Rights Reserved.
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License
// as published by the Free Software Foundation; either version 2
// of the License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful,
// but WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
// GNU General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.
//
// For more information, bug reports, fixes, contact:
//    Christopher Manning
//    Dept of Computer Science, Gates 1A
//    Stanford CA 94305-9010
//    USA
//    parser-support@lists.stanford.edu
//    http://nlp.stanford.edu/downloads/lex-parser.shtml


CHANGES

This section summarizes changes between released versions of the parser.

Version 1.5.1  2006-05-30
    Improved English and Chinese grammatical relations; fixed UTF-8 handling
Version 1.5  2005-07-20
    Added grammatical relations output; fixed bugs introduced in 1.4
Version 1.4  2004-03-24
    Made PCFG faster again (by FSA minimization); added German support
Version 1.3  2003-09-06
    Made parser over twice as fast; added tokenization options
Version 1.2  2003-07-20
    Halved PCFG memory usage; added support for Chinese
Version 1.1  2003-03-25
    Improved parsing speed; included GUI, improved PCFG grammar
Version 1.0  2002-12-05 
    Initial release
