A Semantic Parsing Toolkit for English utterances to ULKB

About

A Semantic Parsing Toolkit that, using ERG Grammar, parse a sentece to MRS and transform the MRS in a ULKB Logic sentence.

Step-by-Step

See mrs-to-logic.org

Ideas from http://svn.delph-in.net/lkb/branches/fos/src/tproving/gq-to-fol.lisp

Dependencies

• Ace https://github.com/delph-in/docs/wiki/AceInstall
• ERG Grammar https://github.com/delph-in/docs/wiki/ErgTop
• The python library https://pydelphin.readthedocs.io
• Utool https://github.com/coli-saar/utool/releases/tag/utool-3.4 (Java)
• ukb (C program, https://github.com/asoroa/ukb)
• ULKB Logic https://github.ibm.com/IBM-Research-AI/ULKB

To test

python3 -m venv venv
source venv/bin/activate
pip install pip --upgrade
pip install pydelphin
pip intall -e .
pip install jupyterlab
jupyter-lab

See nb/demo

Unit tests

Make sure you have the test dependencies:

pytest

To run the testsuite and generate a coverage report (==htmlcov==):

pytest

To run the packaging and compatibility tests:

export ACE_GRAMMAR=<path to grammar file>
export TOX_TESTENV_PASSENV=ACE_GRAMMAR
tox

UKB

The gloss relations file used by UKB need to be produced from the updated annotations. The code below will generate a file called ukb/wn30_gloss_rel.txt. This file will be used in the ccc cluster for produce the wn30g.bin input for the UKB main code.

See glossta-kg how to generate new wn30_gloss_rel.txt

In MacOS with boost installed via Homebrew

% cd ukb-source-folder/src
% ./configure --with-boost-include=/usr/local/include/
% make

Grammar

Compile the grammar, notice the use of the `dict` config:

ace -g PATH-TO-ERG/ace/config-dict.tdl -G erg.dat

or download from http://sweaglesw.org/linguistics/ace/

Usefull Links

• https://docs.python.org/3/library/venv.html
• https://pydelphin.readthedocs.io/en/latest/
• http://github.com/own-pt/delphin-rdf
• http://sweaglesw.orog/linguistics/ace/
  • https://github.com/delph-in/docs/wiki/AceInstall
• https://github.com/delph-in/docs/wiki/ErgTop
• https://rdflib.readthedocs.io/en/stable/
  • https://www.w3.org/TR/rdf-primer/
• https://franz.com/agraph/support/documentation/current/docker.html
• https://www.coli.uni-saarland.de/projects/chorus/utool/