Skip to content

An R package to simplify API access to data on higher education in Norway, as provided by Norwegian Directorate for Higher Education and Skills

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md
Notifications You must be signed in to change notification settings

mni-hkdir/rdbhapi

Repository files navigation

Codecov test coverage

R-CMD-check CRAN status Lifecycle: stable

R interface for DBH-API open data access.

Installation

You can install development version from GitHub with:

# install.packages("remotes")
remotes::install_github("makinin/rdbhapi")

Token can be defined by placing login credentials in the environment variables dbhapi_sso_id and dbhapi_sso_secret in the .Renviron file before starting R or by using Sys.setenv.

Example

DBH-API contents are in table

library(rdbhapi)
dbh_data(1)
#> # A tibble: 109 x 6
#>    Emne    `Tabell id` Tabellnavn        Gdpr  `Bulk tabell` Variabelliste      
#>    <chr>   <chr>       <chr>             <chr> <chr>         <chr>              
#>  1 Ikke t~ 1           API innhold       false true          Emne,Tabell id,Tab~
#>  2 Ikke t~ 2           API metadata      false true          Tabell id,Tabellna~
#>  3 Studen~ 60          Studenter fordel~ true  false         Institusjonskode,A~
#>  4 Studen~ 62          Utvekslingsavtal~ false false         Utvekslingsavtale,~
#>  5 Studen~ 66          Desentralisering~ true  false         Årstall,Institusjo~
#>  6 Studen~ 88          Etterutdanning    true  false         Institusjonskode,A~
#>  7 Studen~ 93          Finansieringskil~ false false         Finansieringskilde~
#>  8 Studen~ 98          Kandidater med f~ false true          Institusjonskode,Å~
#>  9 Doktor~ 100         Samarbeid om dok~ false true          Årstall,Institusjo~
#> 10 Doktor~ 101         Avlagte doktorgr~ false true          Institusjonskode,A~
#> # ... with 99 more rows

Get the whole table in R format:

library(rdbhapi)
dbh_data(211)
#> # A tibble: 282 x 15
#>    Institusjonskode Institusjonsnavn      Adresse        Postnummer `Gyldig fra`
#>    <chr>            <chr>                 <chr>          <chr>      <chr>       
#>  1 0211             Høgskolen i Bodø      Høgskolen i B~ 8049       19943       
#>  2 0212             Høgskolen i Finnmark  Follumsvei 31  9509       19943       
#>  3 0213             Høgskolen i Harstad   Høgskolen i H~ 9480       19943       
#>  4 0214             Høgskolen i Narvik    Postboks 385   8505       19943       
#>  5 0215             Høgskolen i Nesna     Høgskolen i N~ 8700       19943       
#>  6 0216             Høgskolen i Tromsø    Høgskolen i T~ 9293       19943       
#>  7 0217             Samisk høgskole       Hánnoluohkká ~ 9520       19943       
#>  8 0221             Høgskolen i Nord-Trø~ Serviceboks 2~ 7729       19943       
#>  9 0222             Høgskolen i Sør-Trøn~ Høgskolen i S~ 7004       19943       
#> 10 0231             Høgskolen i Bergen    Postboks 7030  5020       19943       
#> # ... with 272 more rows, and 10 more variables: Gyldig til <chr>,
#> #   Telefon <chr>, Telefax <chr>, Institusjonstypekode <chr>, Typenavn <chr>,
#> #   Kortnavn <chr>, Departementid <int>, Dep_navn <chr>,
#> #   Institusjonskode (sammenslått) <chr>, Sammenslått navn <chr>

Multiple choice query:

dbh_data(142, filters = list("Årstall" = c("top","5"),Utvekslingsavtale = "ERASMUS+", 
Type = "NORSK", "Nivåkode" = "*"),exclude = c("Nivåkode" = "FU"), group_by = "Årstall")
#> # A tibble: 5 x 4
#>   Årstall `Antall totalt` `Antall kvinner` `Antall menn`
#>     <int>           <int>            <int>         <int>
#> 1    2020            1774             1056           718
#> 2    2019            2902             1716          1186
#> 3    2018            2707             1640          1067
#> 4    2017            2368             1464           904
#> 5    2016            2206             1352           854

Meta data for data table

dbh_metadata(142)
#> # A tibble: 21 x 10
#>    `Tabell id` Tabellnavn `Variabel navn` Datatype Datalengde Sortering Kodefelt
#>    <chr>       <chr>      <chr>           <chr>    <chr>      <chr>     <chr>   
#>  1 142         Utvekslin~ Andel av heltid decimal  3,2        34        <NA>    
#>  2 142         Utvekslin~ Andel praksis   float    <NA>       39        <NA>    
#>  3 142         Utvekslin~ Antall kvinner  int      <NA>       11        <NA>    
#>  4 142         Utvekslin~ Antall menn     int      <NA>       11        <NA>    
#>  5 142         Utvekslin~ Antall totalt   int      <NA>       10        <NA>    
#>  6 142         Utvekslin~ Avdelingskode   char     6          2         J       
#>  7 142         Utvekslin~ Institusjonsko~ char     4          1         J       
#>  8 142         Utvekslin~ Landkode        char     2          7         J       
#>  9 142         Utvekslin~ Nivåkode        char     10         33        J       
#> 10 142         Utvekslin~ NUS-kode        char     10         37        <NA>    
#> # ... with 11 more rows, and 3 more variables: Group by (forslag) <chr>,
#> #   Kommentar <chr>, GDPR <chr>

About

An R package to simplify API access to data on higher education in Norway, as provided by Norwegian Directorate for Higher Education and Skills

Topics

Resources

License

Unknown, MIT licenses found

Licenses found

Unknown
LICENSE
MIT
LICENSE.md

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages