This file provides some basic information concerning POLFIE, an LFG grammar of Polish.

POLFIE-OT is a version of POLFIE, an LFG grammar of Polish implemented in the XLE system (Xerox Linguistic Environment), enriched with OT (Optimality Theory) constraints for the purpose of automatic disambiguation of resulting parses – according to defined criteria, certain parses are considered optimal, while the remaining ones are considered unoptimal (it is possible, however, to view the unoptimal parses).

POLFIE has been developed at the Institute of Computer Science, Polish Academy of Sciences (IPI PAN) within two projects: NEKST and CLARIN-PL. It provides a two-layer representation: constituent structure (c-structure, tree representation) and functional structure (f-structure, AVM representation). It is based on two previous implemented grammars of Polish: its c-structure is based on GFJP2, a DCG grammar used by the parser Świgra, while its f-structure is inspired by FOJP, an HPSG grammar of Polish. Lexical entries used by the grammar are created with the help of two state-of-the-art resources for Polish: Morfeusz2, a morphological analyser, and Walenty, a valence dictionary.


This file is divided into the following sections:

LICENCE
CONTACT
AVAILABILITY
NOTE
LIST OF GRAMMAR FILES AND DIRECTORIES
OBTAINING PREREQUISITES
RUNNING XLE


#################################################################################################################################################################################################################

LICENCE:

The grammar is made available according to the terms of GNU General Public License (see the file gpl-3.0.txt) unless stated otherwise.

For licence information concerning Morfeusz2 (BSD 2-clause), see grammar/fst/sgjp/copyright-note.txt.

#################################################################################################################################################################################################################

CONTACT:

POLFIE is currently developed and maintained by Agnieszka Patejuk (aep@ipipan.waw.pl).

The module handling tokenisation and morphological analysis (contents of fst/ subdirectory) was created by Katarzyna Krasnowska-Kieraś (kasia.krasnowska@gmail.com), who also provides programming support for POLFIE.

#################################################################################################################################################################################################################

AVAILABILITY:

For the most current version for local installation, go to http://zil.ipipan.waw.pl/LFG.

POLFIE is also available as a web service (it does not require a local installation of XLE) at http://iness.mozart.ipipan.waw.pl/iness/xle-web:
• choose grammar from Grammar menu:
  – POLFIE-Morfeusz2 (stable version)
  – POLFIE-Morfeusz2-OT (version with OT constraints)
  – POLFIE-Morfeusz2-dev (development version)
• write a sentence in the relevant field
• click the "Parse sentence" button

#################################################################################################################################################################################################################

NOTE:

All the instructions provided in this file assume that you use a Linux-type operating system.

#################################################################################################################################################################################################################

LIST OF GRAMMAR FILES AND DIRECTORIES:

.:
fst
gpl-3.0.txt
grammar
lexicon
POLFIE.lfg
README.txt
.xlerc

./fst:
morfeusz_analyze2.so
morfeusz_analyze.so
morfeusz_tokenize.so
sgjp

./fst/sgjp:
copyright-note.txt
morfeusz-brev-a.dict
morfeusz-sgjp-nkjp-a.dict
morfeusz-sgjp-nkjp.tagset
version-info

./grammar:
common.features.lfg
POLFIE-features.lfg
POLFIE-morphology.lfg
POLFIE-overlay-rules-extrscr.lfg
POLFIE-overlay-rules-FOJP.lfg
POLFIE-overlay-rules-lexsem.lfg
POLFIE-overlay-rules-unlikes.lfg
POLFIE-rules-main.lfg
POLFIE-rules-meta-coord.lfg
POLFIE-rules-meta-main.lfg
POLFIE-rules-meta-punct.lfg
POLFIE-rules-NP.lfg
POLFIE-rules-paths.lfg
POLFIE-rules-sublex.lfg
POLFIE-templates-agr.lfg
POLFIE-templates-ann.lfg
POLFIE-templates-aux.lfg
POLFIE-templates-features.lfg
POLFIE-templates-lexicalised-comp.lfg
POLFIE-templates-lexicalised-conj.lfg
POLFIE-templates-lexicalised.lfg
POLFIE-templates-lexicalised-rest.lfg
POLFIE-templates-modpart.lfg
POLFIE-templates-OT.lfg
POLFIE-templates-pos-common.lfg
POLFIE-templates-pos-notsublex.lfg
POLFIE-templates-pos-sublex.lfg
POLFIE-templates-syntax.lfg
POLFIE-templates-valence-default.lfg
POLFIE-templates-valence-Walenty-V.lfg

./lexicon:
POLFIE-lex-core-mwe.lfg
POLFIE-lex-core-overlay.lfg
POLFIE-lex-core-punct.lfg
POLFIE-lex-lemmata.lfg
POLFIE-lex-lemmata-Walenty-byc.lfg
POLFIE-lex-lemmata-Walenty.lfg
POLFIE-lex-tags.lfg
POLFIE-lex-unknown.lfg

#################################################################################################################################################################################################################

OBTAINING PREREQUISITES:

To use this version of POLFIE, you need to obtain a copy of:
-- XLE (http://www2.parc.com/isl/groups/nltt/xle/)
-- Morfeusz2 (http://sgjp.pl/morfeusz/dopobrania.html)

#################################################################################################################################################################################################################

RUNNING XLE:

if you need to install XLE, check the documentation (http://www2.parc.com/isl/groups/nltt/xle/doc/xle.html#SEC1.5)
1. run XLE by typing "xle" (in the directory containing the main grammar config file)
2. to load a grammar whose base config file name is POLFIE.lfg, type:
create-parser POLFIE.lfg
(you may skip this step if you put such a line in your .xlerc file; the .xlerc file provided with the grammar contains this line)
3. to parse sentence "To zdanie jest proste.", type:
parse {To zdanie jest proste.}
4. to quit XLE, type:
exit
5. for more information, check the XLE documentation (http://www2.parc.com/isl/groups/nltt/xle/doc/xle.html#SEC2), you may find XLE Walkthrough very helpful (http://www2.parc.com/isl/groups/nltt/xle/doc/walkthrough.html)

HAPPY PARSING!
