Display SKOS Relations and Properties about Extracted Concepts
Abstract
Display SKOS Relations and Properties about Extracted Concepts
Note
Whenever you make changes to your PoolParty Thesaurus project, you have to first refresh the extraction model before executing the extractor again.
SKOS Relations
The PoolParty Extractor can also provide more information from the thesaurus about the extracted concepts. The parameters 'useRelatedConcepts', 'useTransitiveBroaderConcepts' and 'useTransitiveBroaderTopConcepts' return the related concepts, all broader concepts and the broader top concepts respectively.
Request
{{url}}/extractor/api/extract?text=Daiquiri is a family of cocktails whose main ingredients are rum, citrus, and sugar or other sweetener.&projectId={{project}}&language=en&numberOfTerms=0&useTransitiveBroaderConcepts=true&useTransitiveBroaderTopConcepts=true&useRelatedConcepts=trueThe information is returned under the tags 'relatedConcepts', 'transitiveBroaderConcepts' and 'transitiveBroaderTopConcepts'.
Click to expand the result:
{
"concepts": [
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 100,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d",
"language": "en",
"prefLabel": "Daiquiri",
"altLabels": [
"Banana daiquiri",
"Daiquiris",
"Daquiri",
"Daikiri",
"Banana daikiri",
"Daiquiri (cocktail)",
"Daquari",
"Strawberry daiquiri"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/8d052dfc-44bf-4985-8ce3-4564570a161b",
"title": "Cocktails"
}
],
"relatedConcepts": [
"https://nextrelease-cons.semantic-web.at/cocktails/bee1e709-b317-4f46-b06f-a22367baefdf",
"https://nextrelease-cons.semantic-web.at/cocktails/60d3a991-48d3-4e73-9d62-5961893fd311",
"https://nextrelease-cons.semantic-web.at/cocktails/bca7bc6d-6709-48b8-ae52-fe194c212398"
],
"transitiveBroaderConcepts": [
"https://nextrelease-cons.semantic-web.at/cocktails/5ac37bec-e4b9-4d43-9bcc-8d6954903c25",
"https://nextrelease-cons.semantic-web.at/cocktails/caae2ea0-7e60-400b-a2bb-14ef79720668",
"https://nextrelease-cons.semantic-web.at/cocktails/7516b400-963a-4151-8fdc-f6b23bad1dd5"
],
"transitiveBroaderTopConcepts": [
"https://nextrelease-cons.semantic-web.at/cocktails/5ac37bec-e4b9-4d43-9bcc-8d6954903c25",
"https://nextrelease-cons.semantic-web.at/cocktails/7516b400-963a-4151-8fdc-f6b23bad1dd5"
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 31,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1",
"language": "en",
"prefLabel": "Rum",
"altLabels": [
"Jamaica Spirits",
"Gunpowder Rum",
"Caña blanca",
"Gold rum",
"Coconut rum",
"Rum (beverage)",
"Jamaica Spirit",
"Spiced Rum",
"Spiced rum",
"Cane spirit",
"Cuban rum",
"Hard rum"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/591cf89a-57af-49b8-9042-3fc77408c93e",
"title": "Beverages"
}
],
"transitiveBroaderConcepts": [
"https://nextrelease-cons.semantic-web.at/cocktails/f3000285-36b0-4ffe-af90-740c2dd8fff5",
"https://nextrelease-cons.semantic-web.at/cocktails/403d1249-f37f-4f43-bebf-8dde9677d886"
],
"transitiveBroaderTopConcepts": [
"https://nextrelease-cons.semantic-web.at/cocktails/f3000285-36b0-4ffe-af90-740c2dd8fff5",
"https://nextrelease-cons.semantic-web.at/cocktails/403d1249-f37f-4f43-bebf-8dde9677d886"
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 19,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1",
"language": "en",
"prefLabel": "Sugar",
"altLabels": [
"Sugary",
"-Ose",
"Shurger",
"Sugar crops",
"Cube sugar",
"Foreign matter in refined sugar",
"Sugar lumps",
"Molten sugar",
"Berry sugar",
"Refined sugar",
"White refined sugar",
"Sugar Crystals",
"Sugar trade",
"Suggar",
"Sweet salt",
"Lump sugar",
"Raw Sugar",
"Sugar buzz",
"Sugar cube",
"White sugar",
"Sugar engineering",
"Sugars",
"White Sugar"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/87384ce8-f20a-4201-b06d-3e0b8d832e5d",
"title": "Sweeteners"
}
],
"frequencyInDocument": 1
}
]
}Custom Types and Properties
Concepts can also have specific RDF types (in addition to the type skos:Concept that all concepts in a SKOS thesaurus have). This information is returned by the parameter 'useTypes'.
Request
{{url}}/extractor/api/extract?text=Daiquiri is a family of cocktails whose main ingredients are rum, citrus, and sugar or other sweetener.&projectId={{project}}&language=en&useTypes=true&numberOfTerms=0In the result we can see that 'Daiquiri' is also of the type cocktail, depicted by the URIhttps://nextrelease-cons.semantic-web.at/cocktail-ontology/Cocktail.
It shows also that 'Sugar' is of types 'Garnish': https://nextrelease-cons.semantic-web.at/cocktail-ontology/Garnish as well as 'Ingredients'https://nextrelease-cons.semantic-web.at/cocktail-ontology/Ingredients.
Click to expand the result:
{
"concepts": [
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 100,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d",
"language": "en",
"prefLabel": "Daiquiri",
"altLabels": [
"Banana daiquiri",
"Daiquiris",
"Daquiri",
"Daikiri",
"Banana daikiri",
"Daiquiri (cocktail)",
"Daquari",
"Strawberry daiquiri"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/8d052dfc-44bf-4985-8ce3-4564570a161b",
"title": "Cocktails"
}
],
"customSchemeTypes": [
{
"uri": "http://www.w3.org/2004/02/skos/core#Concept",
"label": "Concept"
},
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Cocktail"
}
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 31,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1",
"language": "en",
"prefLabel": "Rum",
"altLabels": [
"Jamaica Spirits",
"Gunpowder Rum",
"Caña blanca",
"Gold rum",
"Coconut rum",
"Rum (beverage)",
"Jamaica Spirit",
"Spiced Rum",
"Spiced rum",
"Cane spirit",
"Cuban rum",
"Hard rum"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/591cf89a-57af-49b8-9042-3fc77408c93e",
"title": "Beverages"
}
],
"customSchemeTypes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Ingredients"
},
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Beverages"
},
{
"uri": "http://www.w3.org/2004/02/skos/core#Concept",
"label": "Concept"
},
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Alcoholic-Beverages"
}
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 19,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1",
"language": "en",
"prefLabel": "Sugar",
"altLabels": [
"Sugary",
"-Ose",
"Shurger",
"Sugar crops",
"Cube sugar",
"Foreign matter in refined sugar",
"Sugar lumps",
"Molten sugar",
"Berry sugar",
"Refined sugar",
"White refined sugar",
"Sugar Crystals",
"Sugar trade",
"Suggar",
"Sweet salt",
"Lump sugar",
"Raw Sugar",
"Sugar buzz",
"Sugar cube",
"White sugar",
"Sugar engineering",
"Sugars",
"White Sugar"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/87384ce8-f20a-4201-b06d-3e0b8d832e5d",
"title": "Sweeteners"
}
],
"customSchemeTypes": [
{
"uri": "http://www.w3.org/2004/02/skos/core#Concept",
"label": "Concept"
},
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Garnish"
},
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/Ingredients"
}
],
"frequencyInDocument": 1
}
]
}Concepts can have a lot of custom defined information as well. This information is returned by using the parameter 'properties'. You can specify a list of URIs of the properties one wants to see or just specify 'all' to get all information that is available:
Request
{{url}}/extractor/api/extract?text=Daiquiri is a family of cocktails whose main ingredients are rum, citrus, and sugar or other sweetener.&projectId={{project}}&language=en&numberOfTerms=0&properties=allThis custom information has two parts.
Custom attributes are literals (that is, they are just text) and are returned under 'customAttributes'.
Custom relations are links to other concepts in the thesaurus and they are returned under 'customRelations'.
In this example we can see that there is information about the preparation of a cocktail and how it is served (attributes), and which ingredients a cocktail has (relations).
Click to expand the result:
{
"concepts": [
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 100,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/bab016bd-2fd5-4809-bfe7-3225d25f116d",
"language": "en",
"prefLabel": "Daiquiri",
"altLabels": [
"Banana daiquiri",
"Daiquiris",
"Daquiri",
"Daikiri",
"Banana daikiri",
"Daiquiri (cocktail)",
"Daquari",
"Strawberry daiquiri"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/8d052dfc-44bf-4985-8ce3-4564570a161b",
"title": "Cocktails"
}
],
"customRelations": [
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/uses_2",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/021c85c0-a60a-4414-8fd8-bd3383b794f1"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/consists-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/f5cd2a2b-2153-4b7e-ae79-678b939765ca"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/iba",
"object": "http://www.iba-world.com/index.php?option=com_content&id=193&Itemid=532"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/consists-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/71210bd1-3071-4533-8da4-fe0f7d7694a0"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/consists-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/88f5de3d-3de4-4a2f-9523-50bc7bb06600"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/image",
"object": "http://upload.wikimedia.org/wikipedia/commons/thumb/7/7a/Daiquiri_drink.jpg/440px-Daiquiri_drink.jpg"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/uses",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/19dee0d8-fd30-469f-9ecd-91c902ff717c"
}
],
"customAttributes": [
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/preparation",
"literal": {
"label": "Pour all ingredients into shaker with ice cubes. Shake well. Strain in chilled cocktail glass.",
"language": "en",
"datatype": {
"localName": "langString",
"namespace": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
}
}
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/served",
"literal": {
"label": "Straight up; without ice",
"language": "en",
"datatype": {
"localName": "langString",
"namespace": "http://www.w3.org/1999/02/22-rdf-syntax-ns#"
}
}
},
{
"property": "http://purl.org/dc/terms/modified",
"literal": {
"label": "2017-04-26T11:41:00.000Z",
"language": null,
"datatype": {
"localName": "dateTime",
"namespace": "http://www.w3.org/2001/XMLSchema#"
}
}
}
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 31,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/e98ac9a3-64f3-4cc5-8d0d-cf8684b0e7d1",
"language": "en",
"prefLabel": "Rum",
"altLabels": [
"Jamaica Spirits",
"Gunpowder Rum",
"Caña blanca",
"Gold rum",
"Coconut rum",
"Rum (beverage)",
"Jamaica Spirit",
"Spiced Rum",
"Spiced rum",
"Cane spirit",
"Cuban rum",
"Hard rum"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/591cf89a-57af-49b8-9042-3fc77408c93e",
"title": "Beverages"
}
],
"customRelations": [
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/image_3",
"object": "http://preview.poolparty.biz/sparqlingCocktails/resources/images/rum.png"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/4d15a643-f7c7-4ee5-8f56-4ebd2bcf74b5"
}
],
"customAttributes": [
{
"property": "http://purl.org/dc/terms/modified",
"literal": {
"label": "2017-04-26T11:40:57.000Z",
"language": null,
"datatype": {
"localName": "dateTime",
"namespace": "http://www.w3.org/2001/XMLSchema#"
}
}
}
],
"frequencyInDocument": 1
},
{
"id": "1E034541-9963-0001-EE48-B5D068201D43:https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1@en",
"project": "1E034541-9963-0001-EE48-B5D068201D43",
"score": 19,
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/3c94f5fc-4664-4177-a880-88643c0be9c1",
"language": "en",
"prefLabel": "Sugar",
"altLabels": [
"Sugary",
"-Ose",
"Shurger",
"Sugar crops",
"Cube sugar",
"Foreign matter in refined sugar",
"Sugar lumps",
"Molten sugar",
"Berry sugar",
"Refined sugar",
"White refined sugar",
"Sugar Crystals",
"Sugar trade",
"Suggar",
"Sweet salt",
"Lump sugar",
"Raw Sugar",
"Sugar buzz",
"Sugar cube",
"White sugar",
"Sugar engineering",
"Sugars",
"White Sugar"
],
"conceptSchemes": [
{
"uri": "https://nextrelease-cons.semantic-web.at/cocktails/87384ce8-f20a-4201-b06d-3e0b8d832e5d",
"title": "Sweeteners"
}
],
"customRelations": [
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/1576f08f-5936-4071-b85e-d4e85f31c303"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/bee1e709-b317-4f46-b06f-a22367baefdf"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-used-by_2",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/bca7bc6d-6709-48b8-ae52-fe194c212398"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/fb278b46-3c67-48b0-b9eb-7ea037294f5f"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-used-by_2",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/236b36df-93ca-4408-836c-133ace53798a"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/61a18ebf-fd92-4ef1-8ab1-bfd3c26867b9"
},
{
"property": "https://nextrelease-cons.semantic-web.at/cocktail-ontology/is-part-of",
"object": "https://nextrelease-cons.semantic-web.at/cocktails/b33091cd-8c57-45e3-a89b-9de91ffce1e8"
}
],
"customAttributes": [
{
"property": "http://purl.org/dc/terms/modified",
"literal": {
"label": "2017-06-13T15:05:56.000Z",
"language": null,
"datatype": {
"localName": "dateTime",
"namespace": "http://www.w3.org/2001/XMLSchema#"
}
}
}
],
"frequencyInDocument": 1
}
]
}