MinIE: Open Information Extraction system

Open Information Extraction - brief introduction
MinIE - Open Information Extraction system
Version
Demo
MinIE service
Python wrapper
Resources
MinIE in other downstream applications
Citing

Open Information Extraction - brief introduction

Open Information Extraction (OIE) systems aim to extract unseen relations and their arguments from unstructured text in unsupervised manner. In its simplest form, given a natural language sentence, they extract information in the form of a triple, consisted of subject (S), relation (R) and object (O).

Suppose we have the following input sentence:

AMD, which is based in U.S., is a technology company.

An OIE system aims to make the following extractions:

("AMD"; "is based in"; "U.S.")
("AMD"; "is"; "technology company")

MinIE - Open Information Extraction system

An Open Information Extraction system, providing useful extractions:

represents contextual information with semantic annotations
identifies and removes words that are considered overly specific
high precision/recall
shorter, semantically enriched extractions

Version

This is the latest version of MinIE, which may give you different (improved!) results than the original EMNLP-2017 version. The EMNLP-2017 version can be found here.

Demo

In general, the code for running MinIE in all of its modes is almost the same. The only exception is MinIE-D, which requires additional input (list of multi-word dictionaries). You can still use MinIE-D without providing multi-word dictionaries, but then MinIE-D assumes that you provided an empty dictionary, thus minimizing all the words which are candidates for dropping.

The following code demo is for MinIE-S (note that you can use the same for the rest of the modes, you just need to change MinIE.Mode accordingly):

import de.uni_mannheim.minie.MinIE;
import de.uni_mannheim.minie.annotation.AnnotatedProposition;
import de.uni_mannheim.utils.coreNLP.CoreNLPUtils;

import edu.stanford.nlp.pipeline.StanfordCoreNLP;

public class Demo {
    public static void main(String args[]) {
        // Dependency parsing pipeline initialization
        StanfordCoreNLP parser = CoreNLPUtils.StanfordDepNNParser();
        
        // Input sentence
        String sentence = "The Joker believes that the hero Batman was not actually born in 
                           foggy Gotham City.";
        
        // Generate the extractions (With SAFE mode)
        MinIE minie = new MinIE(sentence, parser, MinIE.Mode.SAFE);
        
        // Print the extractions
        System.out.println("\nInput sentence: " + sentence);
        System.out.println("=============================");
        System.out.println("Extractions:");
        for (AnnotatedProposition ap: minie.getPropositions()) {
            System.out.println("\tTriple: " + ap.getTripleAsString());
            System.out.print("\tFactuality: " + ap.getFactualityAsString());
            if (ap.getAttribution().getAttributionPhrase() != null) 
                System.out.print("\tAttribution: " + ap.getAttribution().toStringCompact());
            else
                System.out.print("\tAttribution: NONE");
            System.out.println("\n\t----------");
        }
        
        System.out.println("\n\nDONE!");
    }
}

If you want to use MinIE-D, then the only difference would be the way MinIE is called:

import de.uni_mannheim.utils.Dictionary;
. . .

// Initialize dictionaries
String [] filenames = new String [] {"/minie-resources/wiki-freq-args-mw.txt", 
                                     "/minie-resources/wiki-freq-rels-mw.txt"};
Dictionary collocationsDict = new Dictionary(filenames);

// Use MinIE
MinIE minie = new MinIE(sentence, parser, MinIE.Mode.DICTIONARY, collocationsDict);

In resources/minie-resources/ you can find multi-word dictionaries constructed from WordNet (wn-mwe.txt) and from wiktionary (wiktionary-mw-titles.txt). This will give you some sort of functionality for MinIE-D. The multi-word dictionaries constructed with MinIE-S (as explained in the paper) are not here because of their size. If you want to use them, please refer to the download link in the section "Resources".

MinIE Service

Code for exposing MinIE as a service (developed by Pasquale Minervini).

Start with:

$ mvn clean compile exec:java
[..]

[INFO] --- exec-maven-plugin:1.6.0:java (default-cli) @ minie-service ---
MinIE Service
Mar 06, 2018 8:43:13 PM org.glassfish.grizzly.http.server.NetworkListener start
INFO: Started listener bound to [localhost:8080]
Mar 06, 2018 8:43:13 PM org.glassfish.grizzly.http.server.HttpServer start
INFO: [HttpServer] Started.
Application started.
Stop the application using CTRL+C

Use the service with:

$ curl 'http://localhost:8080/minie/query' -X POST -d 'Obama visited the white house.' | jq .
{
  "facts": [
    {
      "subject": "Obama",
      "predicate": "visited",
      "object": "white house"
    }
  ]
}

Python wrapper

You can find a python wrapper for MinIE here. If you want to use MinIE with python, please follow the guidelines provided on the repo's README.

Resources

Documentation: for more thorough documentation for the code, please visit MinIE's project page.
Paper: "MinIE: Minimizing Facts in Open Information Extraction" - appeared on EMNLP 2017 [pdf]
Dictionary: Wikipedia: frequent relations and arguments [zip]
Experiments datasets: datasets from the paper
- NYT
- Wiki
- NYT-10k

MinIE in other downstream applications

Fact Salience: MinIE is used for the task of "Fact Salience". Details can be found in the paper "Facts that Matter" by Marco Ponza, Luciano Del Corro, Gerhard Weikum, published on EMNLP 2018. As a result, the fact salience system SalIE was published.
Large-Scale OIE: MinIE was used to create the largest OIE corpus to date - OPIEC. The corpus contains more than 341M triples. Details can be found in the paper "OPIEC: An Open Information Extraction Corpus" by Kiril Gashteovski, Sebastian Wanner, Sven Hertling, Samuel Broscheit, Rainer Gemulla, published on AKBC 2019.
OIE from Scientific Publications: An extension of MinIE was created which provides structured knowledge enriched with semantic information about citations - MinScIE: Citation-centered Open Information Extraction. Details can be found in the paper "MinScIE: Citation-centered Open Information Extraction" by Anne Lauscher, Yide Song and Kiril Gashteovski, published on JCDL 2019.
Entity Aspect Linking: MinIE was used for creating EAL: toolkit and dataset for entity-aspect linking. Details can be found in the paper "EAL: A Toolkit and Dataset for Entity-Aspect Linking" by Federico Nanni, Jingyi Zhang, Ferdinand Betz, Kiril Gashteovski, published on JCDL 2019.

Citing

If you use MinIE in your work, please cite our paper:

@inproceedings{gashteovski2017minie,
  title={MinIE: Minimizing Facts in Open Information Extraction},
  author={Gashteovski, Kiril and Gemulla, Rainer and Del Corro, Luciano},
  booktitle={Proceedings of the 2017 Conference on Empirical Methods in Natural Language Processing},
  pages={2630--2640},
  year={2017}
}

gkiril/minie