Learn ACE Relations

Learn ACE Relations uses one or more APF files to train the Ace Relation pattern file which is used by the Ace relation tagger.  It is invoked by

xjet AceJet.LearnAceRelations propertyFile patternFile year (directory filelist)+

where
propertyFile
Jet properties file
patternFile
the generated relation pattern file
year
either 2004 or 2005, specifying the format of the APF files
directory
the path of the directory containing both the text and APF files for the documents
fileList
a list of the documents to be processed, one document doc per line
(for document doc, the text file is assumed to be doc.sgm and the APF file doc.apf.xml)

Pattern File

Each line in the pattern file represents a single training instance ... a pair of entities which may or may not correspond to an ACE relation. The line has the form

order type1 subtype1 head1 [ syntax : chunks ] type2 subtype2 head2 --> rtype rsubtype

where
order
is either 'arg1-arg2' or 'arg2-arg1', indicating the correspondence between the surface order and the argument order
type1
the entity type of the first argument
subtype1
the entity subtype of the first argument
head1
the head of the first argument (however, if a name, the entity type of the name)
syntax
the syntactic relation between the arguments, or '0' if none
chunks
the heads of the sequence of noun groups and other constituents between the first and second arguments
type2
the entity type of the second argument
subtype2
the entity subtype of the second argument
head2
the head of the second argument (however, if a name, the entity type of the name)
rtype
the type of the relation, or '0' if no relation
rsubtype
the subtype of the relation