Metadata-Version: 2.1
Name: dedalov2
Version: 0.0.2
Summary: Explain groups of URIs on the Semantic Web
Home-page: https://github.com/jdonkervliet/dedalov2
Author: Jesse Donkervliet
Author-email: j.donkervliet+dedalo@gmail.com
License: UNKNOWN
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.7.2
Description-Content-Type: text/markdown
Requires-Dist: hdt (>=2.2.1)
Requires-Dist: psutil (>=5.6.3)

# Dedalo

Dedalo explains why a set of URIs belongs together.

## Example

Have a look at the example below and get going in seconds!

We'll use the file `abba.txt` as input. Its contents are:

```
1,http://dbpedia.org/resource/Benny_Andersson
1,http://dbpedia.org/resource/Björn_Ulvaeus
1,http://dbpedia.org/resource/Agnetha_Fältskog
1,http://dbpedia.org/resource/Anni-Frid_Lyngstad
2,http://dbpedia.org/resource/Linus_Torvalds
2,http://dbpedia.org/resource/Avicii
2,http://dbpedia.org/resource/Stellan_Skarsgård
2,http://dbpedia.org/resource/Markus_Persson
```

The number at the start of each line indicates the _group_ the URI belongs to. You can use any number you like, as long as it's an integer.

You can use the following code to explain group 1.

```python
import dedalov2 as ddl

for explanation in ddl.explain("the-internet.hdt",
                               "abba.txt",
                               minimum_score=1,
                               groupid=1):
    print(explanation)
```

The results depend on the `hdt` file you're using. If it includes URIs from DBPedia, the results look something like this:

```
http://dbpedia.org/property/label -| http://dbpedia.org/resource/Polar_Music
http://dbpedia.org/property/associatedActs -| http://dbpedia.org/resource/ABBA
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Anni-Frid_Lyngstad
http://www.w3.org/2004/02/skos/core#subject -| http://dbpedia.org/resource/Category:ABBA_members
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Cher
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Polar_Music
http://dbpedia.org/ontology/associatedBand -| http://dbpedia.org/resource/ABBA
http://dbpedia.org/ontology/associatedMusicalArtist -| http://dbpedia.org/resource/ABBA
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Svensktoppen
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Eurovision_Song_Contest
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/ABBA
http://dbpedia.org/property/wikiPageUsesTemplate -| http://dbpedia.org/resource/Template:infobox_musical_artist
http://dbpedia.org/property/wikilink -| http://dbpedia.org/resource/Rik_Mayall
http://dbpedia.org/ontology/label -| http://dbpedia.org/resource/Polar_Music
```

These URIs are long and difficult to read.
Read [the docs](https://dedalov2.readthedocs.io/en/latest/features.html#using-uri-prefixes) to learn how to make the output look better.

## Installation

Dedalov2 requires Python 3 and can be installed using Python's package manager, pip.

```bash
pip install dedalov2
```

Depending on your use case, you may want to pass the `-U` flag or run this in a virtual environment.

## Documentation

See the [documentation page](https://dedalov2.readthedocs.io/en/latest/index.html) for more examples.


