Skip to contents

Introduction

Finto is a Finnish thesaurus and ontology service that provides a centralized platform for managing and utilizing controlled vocabularies in various applications, including libraries, archives, and research institutions. It enables seamless integration with linked data and supports automated subject indexing through tools like Annif. Maintained by the National Library of Finland, Finto enhances interoperability and accessibility of structured metadata across different domains.

To make a simple search Search Concepts by Query Term we use the following.

library(finto)
concepts <- search_concepts("sibelius")
head(concepts)
## # A tibble: 2 × 7
##   uri                           type  prefLabel altLabel hiddenLabel lang  vocab
##   <chr>                         <chr> <chr>     <chr>    <lgl>       <chr> <chr>
## 1 http://www.yso.fi/onto/koko/… skos… Sibelius… Sibelius NA          fi    koko 
## 2 http://www.yso.fi/onto/mero/… skos… Sibelius… Sibelius NA          fi    liiko

To get available vocabularies from the Finto Skosmos API we use

library(finto)
vocabularies <- get_vocabularies(lang = "en")
head(vocabularies)
##      uri     id
## 1    afo    afo
## 2 allars allars
## 3    cer    cer
## 4     cn     cn
## 5  finaf  finaf
## 6    geo    geo
##                                                                                   title
## 1                                       AFO - Natural resource and environment ontology
## 2                                                 Allärs - General thesaurus in Swedish
## 3 Clean Energy Research ontology of The Bank of Finnish Terminology in Art and Sciences
## 4                                                               Finnish Corporate Names
## 5                                                     KANTO - Kansalliset toimijatiedot
## 6                                                             GEO - Geologian ontologia

To retrieve top concepts in a vocabulary

library(finto)
top_concepts <- get_top_concepts(vocid = "yso", lang = "fi")
head(top_concepts)
## # A tibble: 3 × 5
##   uri                               label      topConceptOf notation hasChildren
##   <chr>                             <chr>      <chr>        <lgl>    <lgl>      
## 1 http://www.yso.fi/onto/yso/p8691  ominaisuu… http://www.… NA       TRUE       
## 2 http://www.yso.fi/onto/yso/p4762  oliot      http://www.… NA       TRUE       
## 3 http://www.yso.fi/onto/yso/p15238 tapahtuma… http://www.… NA       TRUE

Retrieving author information

To retrieve author information we need unique identifier of the author which is called asterID

library(finto)
author_info <- fetch_kanto_info(asteriID = "000094320")
knitr::kable(author_info,caption = "author info")
author info
uri type prefLabel altLabel variantName hiddenLabel authorizedAccessPoint note birthDate deathDate birthPlace deathPlace profession language title country relatedPerson isni source exactMatch closeMatch inScheme created modified
http://urn.fi/URN:NBN:fi:au:finaf:000094320 http://rdaregistry.info/Elements/c/C10004, skos:Concept A:son-Ljungberg, Inger Ljungberg, Inger A:son- Ljungberg, Inger A:son- NA A:son-Ljungberg, Inger NA NA NA NA NA NA NA NA NA NA Asteri ID: 000094320 NA NA NA http://urn.fi/URN:NBN:fi:au:finaf: 1998-04-16 2020-11-11T20:14:39

Retrieval of profession information

library(finto)
profession_info <- fetch_profession_info("http://urn.fi/URN:NBN:fi:au:mts:m3357")
knitr::kable(profession_info,caption = "author info")
author info
profession_uri profession_prefLabel_en profession_prefLabel_fi profession_prefLabel_sv profession_entryTerms profession_belongsToGroup profession_broader profession_narrower profession_related profession_created profession_modified profession_closeMatch profession_source profession_downloadFormats
http://urn.fi/URN:NBN:fi:au:mts:m3357 physiologist fysiologi fysiolog fysiologer, physiologists, fysiologit http://urn.fi/URN:NBN:fi:au:mts: NA NA NA 2018-11-01 2024-08-27 http://www.yso.fi/onto/yso/p20543 ALLFO-term, YSO-termi, Nationell RDA-term, Kansallinen RDA-termi RDF/XML, TURTLE, JSON-LD

Retriveal of both author and profession informations

For this we need a tibble

library(finto)
library(tidyverse)
input_data <- tibble(author_ID = c("000069536", "000041234", "000057891"))
full_author_info <- finto::get_kanto(input_data)
knitr::kable(full_author_info, caption = "Full author Data Frame from kanto")
Full author Data Frame from kanto
author_ID uri type prefLabel altLabel variantName hiddenLabel authorizedAccessPoint note birthDate deathDate birthPlace deathPlace profession language title country relatedPerson isni source exactMatch closeMatch inScheme created modified profession_metadata_profession_uri profession_metadata_profession_prefLabel_en profession_metadata_profession_prefLabel_fi profession_metadata_profession_prefLabel_sv profession_metadata_profession_entryTerms profession_metadata_profession_belongsToGroup profession_metadata_profession_broader profession_metadata_profession_narrower profession_metadata_profession_related profession_metadata_profession_created profession_metadata_profession_modified profession_metadata_profession_closeMatch profession_metadata_profession_source profession_metadata_profession_downloadFormats profession_metadata_uri profession_labels
000041234 http://urn.fi/URN:NBN:fi:au:finaf:000041234 skos:Concept, http://rdaregistry.info/Elements/c/C10004 Bonsdorff, Johan von, 1940-2002 Von Bonsdorff, Johan, 1940-2002 Von Bonsdorff, Johan, 1940-2002 NA Bonsdorff, Johan von, 1940-2002 NA 1940 2002 NA NA http://urn.fi/URN:NBN:fi:au:mts:m3004, http://urn.fi/URN:NBN:fi:au:mts:m2565 NA NA NA NA http://isni.org/isni/0000000059605128, Asteri ID: 000041234 Helsingin Sanomat 10.3.2002 NA http://urn.fi/urn:nbn:fi:sks-kbg-009461 http://urn.fi/URN:NBN:fi:au:finaf: 1980-08-18 2023-04-20T12:33:22 http://urn.fi/URN:NBN:fi:au:mts:m3004, http://urn.fi/URN:NBN:fi:au:mts:m2565 author, journalist kirjailija, toimittaja författare, journalist arbetarförfattare, novelisti, proletärförfattare, authors, kansalliskirjailija, novellisti, nationalförfattare, kaunokirjailija, prosaisti, nationalskald, esseisti, national author, writers, kirjailijat, proosakirjailija, työläiskirjailija, lehtimiehet, editors, toimittajat, journalistit, journalister, reportrar, journalists, redaktörer, tidningsmän, reportterit http://urn.fi/URN:NBN:fi:au:mts: http://urn.fi/URN:NBN:fi:au:mts:m2505 NA NA 2018-11-01 2024-11-08, 2024-08-27 http://www.yso.fi/onto/yso/p8970, http://www.yso.fi/onto/yso/p1021 Kansallinen RDA-termi, ALLFO-term, YSO-termi, Nationell RDA-term, YSO-termi, ALLFO-term, Nationell RDA-term, Kansallinen RDA-termi RDF/XML, TURTLE, JSON-LD NA author, journalist
000057891 http://urn.fi/URN:NBN:fi:au:finaf:000057891 http://rdaregistry.info/Elements/c/C10004, skos:Concept Saksanen, Seppo, 1936- NA NA NA Saksanen, Seppo, 1936- NA 1936 NA NA NA NA NA NA NA NA Asteri ID: 000057891, http://isni.org/isni/0000000398157307 NA NA NA http://urn.fi/URN:NBN:fi:au:finaf: 1981-10-16 2020-11-07T16:23:38 NA NA NA NA NA NA NA NA NA NA NA NA NA NA NA NA
000069536 http://urn.fi/URN:NBN:fi:au:finaf:000069536 skos:Concept, http://rdaregistry.info/Elements/c/C10004 Malmivaara, Wilhelmi, 1854-1922 Malmiwaara, Wilhelmi, 1854-1922; Malmberg, Vilh., 1854-1922; Malmivaara, Wilh., 1854-1922; Malmivaara, Vilmos, 1854-1922; Malmivaara, Vilhelmi, 1854-1922; Malmiwaara, Vilhelmi, 1854-1922; Malmberg, Wilh., 1854-1922; Malmberg, Wilhelm, 1854-1922 Malmiwaara, Vilhelmi, 1854-1922; Malmiwaara, Wilhelmi, 1854-1922; Malmberg, Vilh., 1854-1922; Malmivaara, Vilhelmi, 1854-1922; Malmberg, Wilh., 1854-1922; Malmberg, Wilhelm, 1854-1922; Malmivaara, Wilh., 1854-1922; Malmivaara, Vilmos, 1854-1922 NA Malmivaara, Wilhelmi, 1854-1922 Nimi vuoteen 1900: Wilhelm Malmberg, Täydellinen nimi: Wilhelmi Malmivaara, Vuodesta 1900 Malmivaara 1854 1922 http://www.yso.fi/onto/yso/p94257 http://www.yso.fi/onto/yso/p94257 http://urn.fi/URN:NBN:fi:au:mts:m3285, http://urn.fi/URN:NBN:fi:au:mts:m2479, http://urn.fi/URN:NBN:fi:au:mts:m2518 http://lexvo.org/id/iso639-3/fin NA NA NA http://isni.org/isni/0000000466883328, Asteri ID: 000069536 Kansallisbiografia, katsottu 25.9.2014, Wikipedia, katsottu 3.5.2019 NA http://urn.fi/urn:nbn:fi:sks-kbg-006242 http://urn.fi/URN:NBN:fi:au:finaf: 1994-11-13 2025-03-03T10:09:23 http://urn.fi/URN:NBN:fi:au:mts:m3285, http://urn.fi/URN:NBN:fi:au:mts:m2479, http://urn.fi/URN:NBN:fi:au:mts:m2518 poet, priest, member of parliament runoilija, pappi, kansanedustaja diktare, präst, riksdagsledamot poets, skalder, lyriker, runoilijat, poeter, lyyrikot, papit, pastors, pastorit, präster, clergymen, pastorer, priests, minister, riksdagsmän, riksdagsledamöter, members of parliament, kansanedustajat, riksdagskvinnor http://urn.fi/URN:NBN:fi:au:mts: http://urn.fi/URN:NBN:fi:au:mts:m3004, http://urn.fi/URN:NBN:fi:au:mts:m2671 NA NA 2018-11-01 2024-08-27 http://www.yso.fi/onto/yso/p3490, http://www.yso.fi/onto/yso/p5468, http://www.yso.fi/onto/yso/p1520 ALLFO-term, YSO-termi, Nationell RDA-term, Kansallinen RDA-termi, Kansallinen RDA-termi, ALLFO-term, YSO-termi, Nationell RDA-term, ALLFO-term, Nationell RDA-term, YSO-termi, Kansallinen RDA-termi RDF/XML, TURTLE, JSON-LD NA poet, priest, member of parliament