2019-05-06 08:56:56 +00:00
|
|
|
# coding: utf-8
|
|
|
|
from __future__ import unicode_literals
|
|
|
|
|
2019-05-09 15:23:19 +00:00
|
|
|
from examples.pipeline.wiki_entity_linking import wikipedia_processor as wp, kb_creator, training_set_creator, run_el
|
|
|
|
from examples.pipeline.wiki_entity_linking.train_el import EL_Model
|
2019-05-06 08:56:56 +00:00
|
|
|
|
|
|
|
import spacy
|
|
|
|
from spacy.vocab import Vocab
|
|
|
|
from spacy.kb import KnowledgeBase
|
|
|
|
import datetime
|
|
|
|
|
|
|
|
"""
|
|
|
|
Demonstrate how to build a knowledge base from WikiData and run an Entity Linking algorithm.
|
|
|
|
"""
|
|
|
|
|
|
|
|
PRIOR_PROB = 'C:/Users/Sofie/Documents/data/wikipedia/prior_prob.csv'
|
|
|
|
ENTITY_COUNTS = 'C:/Users/Sofie/Documents/data/wikipedia/entity_freq.csv'
|
|
|
|
ENTITY_DEFS = 'C:/Users/Sofie/Documents/data/wikipedia/entity_defs.csv'
|
2019-05-07 14:03:42 +00:00
|
|
|
ENTITY_DESCR = 'C:/Users/Sofie/Documents/data/wikipedia/entity_descriptions.csv'
|
2019-05-06 08:56:56 +00:00
|
|
|
|
|
|
|
KB_FILE = 'C:/Users/Sofie/Documents/data/wikipedia/kb'
|
|
|
|
VOCAB_DIR = 'C:/Users/Sofie/Documents/data/wikipedia/vocab'
|
|
|
|
|
2019-05-07 14:03:42 +00:00
|
|
|
TRAINING_DIR = 'C:/Users/Sofie/Documents/data/wikipedia/training_data_nel/'
|
2019-05-06 08:56:56 +00:00
|
|
|
|
|
|
|
|
|
|
|
if __name__ == "__main__":
|
|
|
|
print("START", datetime.datetime.now())
|
|
|
|
print()
|
|
|
|
my_kb = None
|
|
|
|
|
|
|
|
# one-time methods to create KB and write to file
|
|
|
|
to_create_prior_probs = False
|
|
|
|
to_create_entity_counts = False
|
2019-05-09 15:23:19 +00:00
|
|
|
to_create_kb = False
|
2019-05-06 08:56:56 +00:00
|
|
|
|
|
|
|
# read KB back in from file
|
|
|
|
to_read_kb = True
|
2019-05-09 15:23:19 +00:00
|
|
|
to_test_kb = False
|
2019-05-06 08:56:56 +00:00
|
|
|
|
2019-05-06 13:13:50 +00:00
|
|
|
# create training dataset
|
2019-05-06 08:56:56 +00:00
|
|
|
create_wp_training = False
|
|
|
|
|
2019-05-07 14:03:42 +00:00
|
|
|
# run training
|
2019-05-09 15:23:19 +00:00
|
|
|
run_training = True
|
2019-05-07 14:03:42 +00:00
|
|
|
|
|
|
|
# apply named entity linking to the dev dataset
|
|
|
|
apply_to_dev = False
|
2019-05-06 13:13:50 +00:00
|
|
|
|
2019-05-06 08:56:56 +00:00
|
|
|
# STEP 1 : create prior probabilities from WP
|
|
|
|
# run only once !
|
|
|
|
if to_create_prior_probs:
|
|
|
|
print("STEP 1: to_create_prior_probs", datetime.datetime.now())
|
|
|
|
wp.read_wikipedia_prior_probs(prior_prob_output=PRIOR_PROB)
|
|
|
|
print()
|
|
|
|
|
|
|
|
# STEP 2 : deduce entity frequencies from WP
|
|
|
|
# run only once !
|
|
|
|
if to_create_entity_counts:
|
|
|
|
print("STEP 2: to_create_entity_counts", datetime.datetime.now())
|
|
|
|
wp.write_entity_counts(prior_prob_input=PRIOR_PROB, count_output=ENTITY_COUNTS, to_print=False)
|
|
|
|
print()
|
|
|
|
|
|
|
|
# STEP 3 : create KB and write to file
|
|
|
|
# run only once !
|
|
|
|
if to_create_kb:
|
|
|
|
print("STEP 3a: to_create_kb", datetime.datetime.now())
|
|
|
|
my_nlp = spacy.load('en_core_web_sm')
|
|
|
|
my_vocab = my_nlp.vocab
|
|
|
|
my_kb = kb_creator.create_kb(my_vocab,
|
|
|
|
max_entities_per_alias=10,
|
|
|
|
min_occ=5,
|
2019-05-07 14:03:42 +00:00
|
|
|
entity_def_output=ENTITY_DEFS,
|
|
|
|
entity_descr_output=ENTITY_DESCR,
|
2019-05-06 08:56:56 +00:00
|
|
|
count_input=ENTITY_COUNTS,
|
|
|
|
prior_prob_input=PRIOR_PROB,
|
|
|
|
to_print=False)
|
|
|
|
print("kb entities:", my_kb.get_size_entities())
|
|
|
|
print("kb aliases:", my_kb.get_size_aliases())
|
|
|
|
print()
|
|
|
|
|
|
|
|
print("STEP 3b: write KB", datetime.datetime.now())
|
|
|
|
my_kb.dump(KB_FILE)
|
|
|
|
my_vocab.to_disk(VOCAB_DIR)
|
|
|
|
print()
|
|
|
|
|
|
|
|
# STEP 4 : read KB back in from file
|
|
|
|
if to_read_kb:
|
|
|
|
print("STEP 4: to_read_kb", datetime.datetime.now())
|
|
|
|
my_vocab = Vocab()
|
|
|
|
my_vocab.from_disk(VOCAB_DIR)
|
|
|
|
my_kb = KnowledgeBase(vocab=my_vocab)
|
|
|
|
my_kb.load_bulk(KB_FILE)
|
|
|
|
print("kb entities:", my_kb.get_size_entities())
|
|
|
|
print("kb aliases:", my_kb.get_size_aliases())
|
|
|
|
print()
|
|
|
|
|
|
|
|
# test KB
|
|
|
|
if to_test_kb:
|
2019-05-06 13:13:50 +00:00
|
|
|
my_nlp = spacy.load('en_core_web_sm')
|
|
|
|
run_el.run_el_toy_example(kb=my_kb, nlp=my_nlp)
|
2019-05-06 08:56:56 +00:00
|
|
|
print()
|
|
|
|
|
|
|
|
# STEP 5: create a training dataset from WP
|
|
|
|
if create_wp_training:
|
|
|
|
print("STEP 5: create training dataset", datetime.datetime.now())
|
2019-05-07 14:03:42 +00:00
|
|
|
training_set_creator.create_training(kb=my_kb, entity_def_input=ENTITY_DEFS, training_output=TRAINING_DIR)
|
|
|
|
|
2019-05-09 15:23:19 +00:00
|
|
|
# STEP 6: apply the EL algorithm on the training dataset
|
2019-05-07 14:03:42 +00:00
|
|
|
if run_training:
|
|
|
|
print("STEP 6: training ", datetime.datetime.now())
|
2019-05-09 15:23:19 +00:00
|
|
|
my_nlp = spacy.load('en_core_web_md')
|
|
|
|
trainer = EL_Model(kb=my_kb, nlp=my_nlp)
|
2019-05-15 00:23:08 +00:00
|
|
|
trainer.train_model(training_dir=TRAINING_DIR, entity_descr_output=ENTITY_DESCR, trainlimit=1500, devlimit=50)
|
2019-05-07 14:03:42 +00:00
|
|
|
print()
|
2019-05-06 13:13:50 +00:00
|
|
|
|
2019-05-09 15:23:19 +00:00
|
|
|
# STEP 7: apply the EL algorithm on the dev dataset
|
2019-05-07 14:03:42 +00:00
|
|
|
if apply_to_dev:
|
2019-05-09 15:23:19 +00:00
|
|
|
my_nlp = spacy.load('en_core_web_md')
|
2019-05-07 14:03:42 +00:00
|
|
|
run_el.run_el_dev(kb=my_kb, nlp=my_nlp, training_dir=TRAINING_DIR, limit=2000)
|
2019-05-06 13:13:50 +00:00
|
|
|
print()
|
|
|
|
|
2019-05-06 08:56:56 +00:00
|
|
|
|
|
|
|
# TODO coreference resolution
|
|
|
|
# add_coref()
|
|
|
|
|
|
|
|
print()
|
|
|
|
print("STOP", datetime.datetime.now())
|