SchoolDataIT (version 0.2.4)

Get_Registry: Download the registry of Italian public schools from the school registry section

Description

This function returns two main pieces of information regarding Italian schools, namely:

• The denomination of the region, province and municipality to which the school belongs.

• The mechanographical code to the reference institute of each school.

It is possible to access schools in all the national territory, including the autonomous provinces of Aosta, Trento and Bozen.

Usage

Get_Registry(
  Year = 2023,
  filename = c("SCUANAGRAFESTAT", "SCUANAAUTSTAT"),
  show_col_types = FALSE,
  autoAbort = FALSE
)

Value

An object of class tbl_df, tbl and data.frame.

Arguments

Year

Numeric or character. Reference school year (last available is 2024). Available in the formats: 2023, "2022/2023", 202223, 20222023. 2023 by default.

filename

Character. A string included in the name of the file to download, identifying the schools included. By default it is c("SCUANAGRAFESTAT", "SCUANAAUTSTAT"), i.e. the file names used for public school registries, respectively across all the national territory except for the autonomous provinces of Aosta, Trento or Bozen, and only in the three If instead the registry of the private schools is needed, please insert "SCUANAGRAFEPAR" and/or "SCUANAAUTPAR".

For the registry of private schools, either in all the national territory except for the aforementioned provinces, and for these provinces, please use "SCUANAGRAFEPAR" and "SCUANAAUTPAR" respectively. Please notice that data regarding private schools are not available for most functions in this package.

show_col_types

Logical. If TRUE, the columns of the raw dataset are shown during the download. FALSE by default.

autoAbort

Logical. Whether to automatically abort the operation and return NULL in case of missing internet connection or server response errors. FALSE by default.

Details

Schools different from primary, middle or high schools are classified as "NR".

Examples

# \donttest{
  Get_Registry(2024, filename = "SCUANAGRAFESTAT", autoAbort = TRUE)
# }