SchoolDataIT (version 0.2.4)

Group_teachers4stud: Arrange the number of teachers per students in public Italian schools at the province level

Description

This function provides the average number of teachers per students in Italian public schools at the province level.

Usage

Group_teachers4stud(
  Year = 2023,
  input_nteachers = NULL,
  nteachers_filename = c("DOCTIT", "DOCSUP"),
  verbose = TRUE,
  input_nstud_raw = NULL,
  input_nstud_aggr = NULL,
  autoAbort = FALSE,
  ...
)

Value

An object of class tbl_df, tbl and data.frame

Arguments

Year

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

input_nteachers

Object of class tbl_df, tbl and data.frame. The number of teachers by province, obtained as output of the function Get_nteachers_prov. If NULL, the function will download it automatically but it will not be saved in the global environment. NULL by default.

nteachers_filename

Character. If input_nteachers is not provided, which data to retrieve regarding the number of teachers/personnel; see Get_nteachers_prov c("DOCTIT", "DOCSUP") by default, i.e. tenured theachers and temporary teachers.

verbose

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

input_nstud_raw

Object of class 'list', including two objects of class tbl_df', tbl and data.frame, obtainded as output of the Get_nstud function with the default filename parameter. Not necessary if the argument input_nstud_aggr is provided. If NULL, the function will download it automatically but it will not be saved in the global environment. NULL by default.

input_nstud_aggr

Object of class list, including two objects of class tbl_df, tbl and data.frame, obtained as output of the function Group_nstud. If NULL, the function will compute it manually but it will not be saved in the global environment. NULL by default.

autoAbort

Logical. In case any data must be retrieved, whether to automatically abort the operation and return NULL in case of missing internet connection or server response errors. FALSE by default.

...

Arguments to Group_nstud if argument input_nstud_aggr is not provided

Examples

# \donttest{
  input_nstud23 <- Get_nstud(2023, filename ="ALUCORSOINDCLASTA", autoAbort = TRUE)
  Registry23 <- Get_Registry(2023, autoAbort = TRUE)
  School2mun23 <- Get_School2mun(2023, input_Registry = Registry23, autoAbort = TRUE)


  nstud23.aggr <- Group_nstud(Year = 2023, data = input_nstud23,
    input_Registry = Registry23, input_School2mun = School2mun23,
    autoAbort = TRUE)

  input_nteachers23 <- Get_nteachers_prov(2023, autoAbort = TRUE)

  teachers4stud <- Group_teachers4stud(Year = 2023,
                   input_nteachers = input_nteachers23,
                   input_nstud_aggr = nstud23.aggr, autoAbort = TRUE)

  teachers4stud[, -c(1, 2, 10, 11)]

  summary(teachers4stud)
# }