SchoolDataIT (version 0.2.4)

Get_nstud: Download students' number data

Description

This functions downloads the data regarding the number of students, from the open website of the Italian Ministry of Education, University and Research

Usage

Get_nstud(
  Year = 2023,
  filename = c("ALUCORSOETASTA", "ALUCORSOINDCLASTA"),
  verbose = TRUE,
  show_col_types = FALSE,
  autoAbort = FALSE
)

Value

By default, a list of two tbl_df, tbl and data.frame objects:

• $ALUCORSOETASTA: The number of students by school, school grade and age. It provides a higher number of school than the other element

• $ALUCORSOINDCLASTA: The number of students and classes by school and school grade. This is a long-format dataframe.

Arguments

Year

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

filename

Character. A string included in the name of the file to download. By default it is c("ALUCORSOETASTA", "ALUCORSOINDCLASTA"), which are the file names used so far for the number of students by age and the number of studentsin public schools by age and class.

Other file names are the following. The output is not currently supported by the remainder of the functions involving the number of students.

"ALUITASTRACITSTA" for the number of Italian and foreign students in public schools

"ALUSECGRADOINDSTA" for the number of students of public schools by high school address

"ALUTEMPOSCUOLASTA" for the number of students of public schools by school running time

"ALUCORSOETAPAR", "ALUCORSOINDCLAPAR", "ALUITASTRACITPAR", "ALUSECGRADOINDPAR", "ALUTEMPOSCUOLAPAR" for the data of the previous file but referring to private schools.

verbose

Logical. If TRUE, the user keeps track of the main underlying operations. TRUE by default.

show_col_types

Logical. If TRUE, if the verbose argument is also 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.

Examples

# \donttest{
  Get_nstud(2023, filename = "ALUCORSOINDCLASTA", autoAbort = TRUE)
# }