git-svn-id: file:///dta/svn/old/PyPES/trunk@548 91a45504-6d28-49e1-87dd-05d800df9125

Author: perado42

GNUmakefile

@@ -12,50 +12,7 @@ PYTHONPATH = src
 PYTHON = $(ENV) PYTHONPATH="$(PYTHONPATH)" python3.0
 
 
-INFERDTA = \
-  aquaint-brandeis.kbe.xml \
-  aquaint-chrisrte.kbe.xml \
-  aquaint-cns.kbe.xml \
-  aquaint-cycorp.kbe.xml \
-  aquaint-kbeval.kbe.xml \
-  aquaint-lcch.kbe.xml \
-  aquaint-lccm.kbe.xml \
-  aquaint-mit.kbe.xml \
-  aquaint-modals.kbe.xml \
-  aquaint-parc-dev.kbe.xml \
-  aquaint-parc-predev.kbe.xml \
-  aquaint-simple.kbe.xml \
-  aquaint-stanford.kbe.xml \
-  aquaint-utdicsi.kbe.xml \
-  ave-06-de-tst.rte.xml \
-  ave-06-en-dev-np-nr.rte.xml \
-  ave-06-en-dev-np-r.rte.xml \
-  ave-06-en-dev-yp-nr.rte.xml \
-  ave-06-en-dev-yp-r.rte.xml \
-  ave-06-en-tst.rte.xml \
-  ave-07-de-dev.ave.xml \
-  ave-07-de-tst.ave.xml \
-  ave-07-en-dev.ave.xml \
-  ave-07-en-tst.ave.xml \
-  ave-08-de-dev.ave.xml \
-  ave-08-de-tst.ave.xml \
-  ave-08-en-dev.ave.xml \
-  ave-08-en-tst.ave.xml \
-  fracas.bmc.xml \
-  rte-05-dev.rte.xml \
-  rte-05-tst.rte.xml \
-  rte-06-dev.rte.xml \
-  rte-06-tst.rte.xml \
-  rte-07-dev-2w.rte.xml \
-  rte-07-dev-3w.rte.xml \
-  rte-07-tst-2w.rte.xml \
-  rte-07-tst-3w-results.tar.gz \
-  rte-07-tst-3w.txt \
-  rte-08-2w-results.tar.gz \
-  rte-08-3w-results.tar.gz \
-  rte-08.rte.xml \
-  rte-wang-birth.rte.xml \
-  rte-wang-kill.rte.xml
+INFERDTA = $(subst dta/infer/orig/, , $(wildcard dta/infer/orig/*.xml *.gz))
 
 INFERDTA_ORIG = $(patsubst %, dta/infer/orig/%, $(INFERDTA))
 

doc/index.rst

@@ -11,6 +11,7 @@ Contents:
    :maxdepth: 2
 
    tutorial.rst
+   library/bin.rst
    guidelines.rst
 
 Indices and tables

doc/library/bin.rst

@@ -0,0 +1,49 @@
+:mod:`bin` --- binaries 
+=======================
+
+.. module:: bin
+  :synopsis: binaries
+
+:mod:`bin` contains main programmes and command line utilities.
+
+.. function:: compare_annotations.main( [argv] )
+
+   compares two annotation files containing decisions on candidate
+   entailments, such as :file:`dta/infer/fracas/fracas-1-1/gold.tsa.xml` and
+   :file:`dta/infer/fracas/fracas-1-1/McPIETAgent.tsa.xml`.
+   
+   The *argv* list should contain as its first element the subdirectory
+   where files are to be found (default :file:`dta/infer/fracas/fracas-1`).
+   Then all directories are traversed which are subdirectories
+   :file:`dta/infer/fracas` and have as a prefix ``fracas-1``.
+
+   Within each directory, a file named in the second element in the
+   *argv* list (default ``gold.tsa.xml``) is then compared against
+   a file named in the third element (default ``McPIETAgent.tsa.xml``).
+
+.. function:: decide_annotations.main( [argv] )
+
+   takes a McPIET annotation (such as :file:`dta/infer/fracas/fracas-1-1/McPIETAgent.tsa.xml`)
+   and makes new entailment decisions on the basis of the numeric `r1` and `r2` fields.
+
+   The default strategy is to say `entailment` when `r1` is `1.0`, contradiction when `r2`
+   is `1.0` and `unknown` when both are `0.0`. -- This leads to strict logical decisions
+   and no robustness.
+
+   The strategy used in :function:`decide_annotation.main( [argv] )`, on the other hand,
+   leads to more robustness.  Here a decision is `entailment` whenever `r1` > `r2`, and
+
+   does the same traversal through subdirectories, given *argv* as
+   :function:`compare_annotations.main`.
+
+
+.. function:: extract_ergsem_smi.main( [argv] )
+.. function:: extract_logical_patterns.main( [argv] )
+.. function:: preprocess_fracas.main( [argv] )
+.. function:: preprocess_rte.main( [argv] )
+.. function:: preprocess_rte_results.main( [argv] )
+.. function:: read_treebank.main( [argv] )
+.. function:: run_score.main( [argv] )
+.. function:: run_testsuite.main( [argv] )
+.. function:: sanitize_rte.main( [argv] )
+