Skip to content

LOVAPI

autocompleteTerm(term)

Search similar terms based on the term given as input.

Parameters:

Name Type Description Default
term string

A string that represent a term used in the KG analyzed.

 required

Returns:

Name Type Description
dict

A dict that contains a list of terms similar to the term passed as input.
Source code in kgheartbeat\LOVAPI.py 
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
def autocompleteTerm(term):
    """Search similar terms based on the term given as input.

    Args:
        term (string): A string that represent a term used in the KG analyzed.

    Returns: 
        dict: A dict that contains a list of terms similar to the term passed as input.
    """
    url = 'https://lov.linkeddata.es/dataset/lov/api/v2/term/autocomplete?q=%s'%term
    try:
        h = {'User-Agent': 'Mozilla/5.0 (Windows NT 6.1; WOW64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/56.0.2924.76 Safari/537.36'}
        response = requests.get(url,headers=h)
        if response.status_code == 200:
            jsonResult = response.json()
            return jsonResult
        elif response.status_code == 404:
            print('Error in running the query on LOV')
            return False 
    except:
        print('Failed to connect to Linked Open Vocabularies')
        return False

autocompleteVocab(vocab)

Search similar vocabularies based on the vocabulary given as input.

Parameters:

Name Type Description Default
term string

A string that represent a vocabulary used in the KG analyzed.

 required

Returns:

Name Type Description
dict

A dict that contains a list of vocabularies similar to the term passed as input.
Source code in kgheartbeat\LOVAPI.py 
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
def autocompleteVocab(vocab):
    """Search similar vocabularies based on the vocabulary given as input.

    Args:
        term (string): A string that represent a vocabulary used in the KG analyzed.

    Returns: 
        dict: A dict that contains a list of vocabularies similar to the term passed as input.
    """
    url = 'https://lov.linkeddata.es/dataset/lov/api/v2/vocabulary/autocomplete?q=%s'%vocab
    try:
        response = requests.get(url)
        if response.status_code == 200:
            jsonResult = response.json()
            return jsonResult
        elif response.status_code == 404:
            print('Error in running the query on LOV')
            return False 
    except:
        print('Failed to connect to Linked Open Vocabularies')
        return False

findVocabulary(vocab)

Look for a vocabulary in the LOV to see if it is considered standard or is a new defined vocabulary.

Parameters:

Name Type Description Default
vocab string

A string that represent a vocabulary used in the KG analyzed.

 required

Returns:

Name Type Description
boolean

A boolean that is True if the vocabulary is in the LOV, False otherwise.
Source code in kgheartbeat\LOVAPI.py 
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
def findVocabulary(vocab):
    """Look for a vocabulary in the LOV to see if it is considered standard or is a new defined vocabulary.

    Args:
        vocab (string): A string that represent a vocabulary used in the KG analyzed.

    Returns: 
        boolean: A boolean that is True if the vocabulary is in the LOV, False otherwise.
    """
    vocabularies = getAllVocab()
    for i in range(len(vocabularies)):
        d = vocabularies[i]
        nsp = d.get('nsp')
        uri = d.get('uri')
        if nsp == vocab:
            return True
        if uri == vocab:
            return True
    return False

getAllVocab()

Search for all standard vocabularies included in the LOV.

Returns:

Name Type Description
dict

A dict that contains all vocabularies considered standard by the LOV.
Source code in kgheartbeat\LOVAPI.py 
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
def getAllVocab():
    """Search for all standard vocabularies included in the LOV.

    Returns: 
        dict: A dict that contains all vocabularies considered standard by the LOV.
    """
    url = 'https://lov.linkeddata.es/dataset/lov/api/v2/vocabulary/list'
    try:
        response = requests.get(url)
        if response.status_code == 200:
            jsonResult = response.json()
            return jsonResult
        elif response.status_code == 404:
            print('Error in running the query on LOV')
            return False 
    except:
        print('Failed to connect to Linked Open Vocabularies')
        return False

searchTermsList(terms)

Look for a terms in the files with all terms downloaded form the LOV to see if it are considered standard or is a new defined terms.

Parameters:

Name Type Description Default
terms list

A list that represent all terms used in the KG analyzed.

 required

Returns:

Name Type Description
list

A list that contains all terms that aren't considered standard for the LOV.
Source code in kgheartbeat\LOVAPI.py 
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
@log_in_out
def searchTermsList(terms):
    """Look for a terms in the files with all terms downloaded form the LOV to see if it are considered standard or is a new defined terms.

    Args:
        terms (list): A list that represent all terms  used in the KG analyzed.

    Returns: 
        list: A list that contains all terms that aren't considered standard for the LOV.
    """
    here = os.path.dirname(os.path.abspath(__file__))
    lov1 = os.path.join(here,'lov1.txt')
    lov2 = os.path.join(here,'lov2.txt')
    newTerms = []
    with open(lov1, 'r',encoding='utf-8') as f1:
        with open(lov2, 'r',encoding='utf-8') as f2:
            data1 = set(f1.read().splitlines())
            data2 = set(f2.read().splitlines())
            for i in range(len(terms)):
                if terms[i] not in data1 and terms[i] not in data2:
                    newTerms.append(terms[i])
    return newTerms