Skip to content
/ Mandolin Public

❇️ The best modules for Markov Logic Networks condensed in one framework.

License

Notifications You must be signed in to change notification settings

AKSW/Mandolin

Repository files navigation

logo

MANDOLIN

The best modules for Markov Logic Networks - rule mining, grounding, inference - condensed in one framework.

Requirements

  • Java 1.8+
  • PostgreSQL 9.4.x
  • Gurobi solver
  • Maven
  • Wget, Unzip

Quick start

Experiments

The following command will discover new links of any predicate (--aim) on the WordNet dataset (--input) with mining threshold 0.8 (--mining) and 1 million Gibbs sampling iterations (--sampling).

java -Xmx1g -jar target/Mandolin-0.4.0-jar-with-dependencies.jar plain --input data/benchmark/wn18/wordnet-mlj12-train.nt,data/benchmark/wn18/wordnet-mlj12-valid.nt --output eval/wn18 --mining 0.8 --sampling 1000000 --aim "*"

Discovered links can be found in the --output folder at ./eval/wn18/discovered_X.nt, where X is the output threshold, meaning that a file contains all links whose confidence is greater or equal than X.

An excerpt of the discovered rules and weights:

0.990517419  wn18:_part_of(b, a) => wn18:_has_part(a, b)
0.862068966  wn18:_instance_hypernym(a, c) AND wn18:_synset_domain_topic_of(f, b) => wn18:_synset_domain_topic_of(a, b)

An excerpt of the discovered links with confidence > 0.9:

wn18:08131530 wn18:_has_part wn18:08132046 .
wn18:09189411 wn18:_has_part wn18:08707917 .
wn18:10484858 wn18:_synset_domain_topic_of wn18:08441203 .
wn18:01941987 wn18:_synset_domain_topic_of wn18:00300441 .

Basic documentation

Mandolin can be launched as follows.

java -Xmx1g -jar target/Mandolin-0.4.0-jar-with-dependencies.jar <GOAL> <PARAMETERS>

Goals

Goal Description
plain Launch a plain Mandolin execution.
eval Evaluate MRR and hits@k.

Plain execution

Parameters for plain goal:

Parameter Description Example value
--input Comma-separated N-Triple files. data1.nt,data2.nt
--output Workspace and output folder. eval/experiment1
--aim Aim predicate. For all predicates use wildcard *. http://www.w3.org/2002/07/owl#sameAs
--mining Rule mining threshold. 0.9 (default: 0.0 support)
--sampling Gibbs sampling iterations. 1000000 (default: 100 x evidence size)
--rules Maximum number of rules. 1500 (default: none)
--sim Enable similarity among literals as min,step,max. 0.8,0.1,0.9 (default: none)
--onto Enable ontology import. true (default: false)
--fwc Enable forward-chain. true (default: false)

Evaluation

The eval goal takes two parameters: the N-Triples file of the test set and Mandolin's output directory.

Example run:

java -Xmx1g -jar target/Mandolin-0.4.0-jar-with-dependencies.jar eval data/benchmark/wn18/wordnet-mlj12-test.nt eval/wn18

Manual install

  • Clone project:
git clone https://github.com/mommi84/Mandolin.git
cd Mandolin

Alternative 1

  • Launch bash install.sh -c

Alternative 2

  • Insert PostgreSQL setting parameters into a file ./mandolin.properties. Example:
# GENERAL CONFIGURATION FOR MANDOLIN
pgsql_home=/usr/local/Cellar/postgresql/9.4.1
pgsql_username=tom
pgsql_password=
pgsql_url=localhost
  • Download data

  • Compile project:

export MAVEN_OPTS=-Xss4m
mvn clean compile assembly:single

Database handler

After using Mandolin, stop the DB instance with:

sh pgsql-stop.sh

The instance can be restarted with:

sh pgsql-start.sh

Citing

@article{soru2017mandolin,
  title={Mandolin: A Knowledge Discovery Framework for the Web of Data},
  author={Soru, Tommaso and Esteves, Diego and Marx, Edgard and Ngomo, Axel-Cyrille Ngonga},
  journal={arXiv preprint arXiv:1711.01283},
  year={2017}
}

License(s)

Mandolin is licensed under GNU General Public License v2.0. AMIE is licensed under Creative Commons Attribution-NonComercial license v3.0. ProbKB is licensed under the BSD license. RockIt is licensed under the MIT License. Gurobi can be activated using a free academic license.