Skip to content

Commit

Permalink
updated readme
Browse files Browse the repository at this point in the history
  • Loading branch information
GabrieleT0 committed Apr 10, 2024
1 parent 15253ea commit f896b9c
Show file tree
Hide file tree
Showing 3 changed files with 30 additions and 5 deletions.
31 changes: 28 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,11 +1,35 @@
# KGHeartbeat API
# KGHeartBeat API

1. [What is KGHeartBeat API](#what-is-kgheartbeat-api)
2. [Installation](#installation)
3. [Quality metrics covered]()
4. [Examples](#examples)

# What is KGHeartBeat API
Library that allows you to perform Knowledge Graph (Linked Open Data) quality analysis.

### Installation
The granularity with which KG quality can be measured is at the metric level, meaning that it is possible to combine the calculation of multiple metrics to obtain KG quality for a dimension. The [examples](#examples) section shows how you can calculate the quality of different dimensions combining together the calculation of different metrics.

For documentation on the library implementation visit here: [https://gabrielet0.github.io/KGHeartbeat-API/reference/](https://gabrielet0.github.io/KGHeartbeat-API/reference/)

# Quality metrics covered
Below is a graph showing the quality dimensions covered by KGHeartbeat and the percentage of metrics measured in each of them.

![Quality metrics covered by KGHeartbeat](img/quality_metrics.png)

For more information on how they are calculated visit here: [https://isislab-unisa.github.io/KGHeartbeat/](https://isislab-unisa.github.io/KGHeartbeat/)


# Installation
```
pip install kgheartbeat
```

# Examples
1. [Calculate the Availability dimension](#calculate-the-availability-dimension)
2. [Calculate the Licensing dimension](#calculate-the-licensing-dimension)
3. [Calcuate the Versatility dimension](#calcuate-the-versatility-dimension)

### Calculate the *Availability* dimension
```Python
from kgheartbeat import KnowledgeGraph
Expand Down Expand Up @@ -58,4 +82,5 @@ languages = kg.getLanguages()
link_access = kg.getAccessAtKG()

print(f"Serialization formats: {formats}\nLanguages: {languages}\n Link to access the KG:{link_access}\n")
```
```

Binary file added img/quality_metrics.png
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
4 changes: 2 additions & 2 deletions setup.py
Original file line number Diff line number Diff line change
Expand Up @@ -15,11 +15,11 @@
# This call to setup() does all the work
setup(
name="kgheartbeat",
version="0.2.4",
version="0.2.5",
description="Library that allows to perform Knowledge Graph (Linked Open Data) quality analysis.",
long_description_content_type="text/markdown",
long_description=long_description,
url="https://knowledge-graph-quality-analysis-api.readthedocs.io/",
url="https://gabrielet0.github.io/KGHeartbeat-API/reference/",
author="Gabriele Tuozzo, Maria Angela Pellegrino",
author_email="[email protected]",
license="MIT",
Expand Down

0 comments on commit f896b9c

Please sign in to comment.