Skip to content

Latest commit

 

History

History
68 lines (51 loc) · 3.74 KB

README.md

File metadata and controls

68 lines (51 loc) · 3.74 KB
Raw

PropertyRecommenderEvaluator

The PropertyRecommenderEvaluator is a python framework for the evaluation of property recommender systems which aim at supporting users in adding information in collaborative environments based on the triple format (subject, property, object). Consider a user on Wikidata who is currently in the process of editing the subject „Innsbruck“ (a city in Austria) and has already entered values for the properties mayor and the number of inhabitants. A recommender system may assist the user in recommending further properties which might also be suitable for the given subject (e.g., about the founding year of the city). These recommendations are traditionally derived from similar subjects (in regards to the properties used) which contain properties that are not yet used on the given subject.

The Python-framework at hand provides evaluating property recommendation approaches that rely on a set of precomputed association rules (wikipedia article). Our framework provides the following features:

  • import triple information extracted from a Wikidata JSON—dump to a MySQL database
  • computation of association rules (stored in MySQL)
  • creation and storage of a test set of random subjects (we store these for future comparisons of different algorithms and improved repeatability)
  • evaluation framework for comparing recall, precision and reconstruction.
  • detailed results exported to JSON including single results for every subject, evaluation run, recomendation algorithm and evaluation measure

We have used this framework to evaluate . More details about this evaluation can be found in the paper.

Citation and License

We release the code under the GNU LGPL License. If you use our code in a scientific context, please cite the following paper:

@inProceedings{opensym16,
author = {Zangerle, Eva and Gassler, Wolfgang and Pichl, Martin and Steinhauser, Stefan and Specht, G\"{u}nther},
title = {An Empirical Evaluation of Property Recommender Systems for Wikidata and Collaborative Knowledge Bases},
booktitle = {Proceedings of the 12th International Symposium on Open Collaboration},
series = {OpenSym '16},
year = {2016},
location = {Berlin, Germany},
publisher = {ACM},
address = {New York, NY, USA}
}

Getting Started

Prerequisites

To install the Wikidata importer's PHP dependencies, you have to call composer install:

composer install -d ./tools/jsonDumpImporter

Next, you have to create all necessary tables and stored procedures for running the evaluation framework. For this, you have to call the createSchema.sh script with the connection settings to your database as arguments:

./tools/createSchema/createSchema.sh <host> <user> <password> <database>

Now you can start to import a Wikidata JSON Dump. Our import.sh script handles bz2 and gzip compressed files.

./tools/jsonDumpImporter/import.sh <compressed dump file> <host> <user> <password> <database>

Evaluation Framework

You can find the documentation of the python evaluation part here.

Requirements

  • Python 3.x
  • MySQL or MariaDB
  • PHP >= 5.4.0
  • Composer >= 1.2

Contact

Eva Zangerle, Martin Pichl, Wolfgang Gassler
Databases and Information Systems
Department of Computer Science
University of Innsbruck
[email protected]
http://dbis-informatik.uibk.ac.at