RDFRules • Documentation • VŠE
Table of Contents
PyRDFRules is a Python wrapper for the graph rule mining tool RDFRules.
RDFRules is a powerful analytical tool for rule mining from RDF knowledge graphs. It offers a complex rule mining solution including RDF data pre-processing, rules post-processing and prediction abilities from rules. The core of RDFRules is written in the Scala language. Besides the Scala API, RDFRules also provides REST web service with graphical user interface via a web browser.
Repository for RDFRules can be found at propi/rdfrules.
PyRDFRules is distributed as a Python library through PyPi. The primary goal of this API is to faciliate the easy use of RDFRules through a Python interface.
A minimum Python version of 3.12.2 is required. You can check your Python version using python --version.
pip install pyrdfrulesFull documentation is available at a dedicated documentation site. Code samples can be found in the sample directory, including a Python notebook.
Currently, using a remote HTTP instance of RDFRules or a local instance of RDFRules is supported. Automatic installation of JVM if not present and of RDFRules is supported, and the library takes care of running the RDFRules application.
To connect to a remote instance of RDFRules, create an application and use the start_remote method.
from pydantic_core import Url
import pyrdfrules.application
app = pyrdfrules.application.Application()
rdfrules = await app.start_remote(
url = Url("http://YOUR_RDFRULES_INSTANCE/api/")
)todoAs a last step, launch the pipeline, wait for all results and print the head, body and measures of each mined rule.
A task is a series of steps (a pipeline) provided to RDFRules. Tasks are used to mine rules, index, cache or otherwise manipulate data...
If you have a JSON task ready, you can execute it in the following way:
from pyrdfrules.common.task.task import Task
task : Task = None
with open("./task.json", "r") as file:
task_json_from_file = file.read()
task = await rdfrules.task.create_task_from_string(task_json_from_file)
await rdfrules.task.run_task(task)This will block execution until the task is finished. You can then access the results of the task once it's done.
Full pipeline sample matching the DBpedia & YAGO example from the RDFRules web instance can be found in sample/dbpedia.py or DOCUMENTATION LINK (todo).
To initialize your environment:
./init.shTo run a build and run jupyter lab:
./run.sh- Sample interface
- Implement JSON serialization of pipeline
- Implement communication with RDFRules
If you have a suggestion to improve this project, please fork the repo and create a pull request. If you encounter any issues, please do raise an issue with an appropriate tag. Feature requests, enhancements and bug reports are welcome.
To contribute to this project, first:
- Fork the Project
- Create your Feature Branch (git checkout -b feature/AmazingFeature)
- Commit your Changes (git commit -m 'Add some AmazingFeature')
- Push to the Branch (git push origin feature/AmazingFeature)
- Open a Pull Request
pyrdfrules is distributed under the terms of the Apache License. See LICENSE for more information.