SchoolDataIT (version 0.2.4)

Get_Invalsi_IS: Download the Invalsi census survey data

Description

Downloads the full database of the Invalsi scores, detailed either at the municipality or province level.

Usage

Get_Invalsi_IS(
  level = "LAU",
  verbose = TRUE,
  show_col_types = FALSE,
  multiple_out = FALSE,
  autoAbort = FALSE
)

Value

Unless multiple_out == TRUE, an object of class tbl_df, tbl and data.frame. Otherwise, a list including objects of the aforementioned classes

Arguments

level

Character. The level of aggregation of Invalsi census data. Either "NUTS-3", "Province", "LAU", "Municipality". "LAU" by default.

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.

multiple_out

Logical. Wheter keeping multiple dataframes as outputs (thus overriding the level argument) or not. 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

Numeric variables provided are:

• Average_percentage_score Average direct score (percentage of sufficient tests)

• Std_dev_percentage_score Standard deviation of the direct score

• WLE_average_score Average WLE score. The WLE score is calculated through the Rasch's psychometric model and is suitable for middle and high schools in that it is cleaned from the effect of cheating (which would affect both the average score and the score variability). By construction it has a mean around 200 points.

• Std_dev_WLE_score Standard deviation of the WLE score. By construction it ranges around 40 points at the school level.

• Students_coverage Students coverage percentage

Additional numeric variables, not always available for all observational units, are:

• Mean and SD of ESCS indicator

• First-Fifth_Level: Distribution of the proficiency level of students

• Targets_percentage: Percentage of students reaching targets

Numeric codes 888 and 999 denote not applicable and not available fields respectively.

If multiple_out == TRUE, provides the following datasets:

• Municipality_data: LAU-level data

• Province_data: NUTS-3-level data

• Region_data: NUTS-2-level data

• LLS_data: data at the level of local labour systems (Sistemi Locali del Lavoro; see ISTAT webpage for details)

• Inner_Areas_2021_data aggregated data for inner areas according to the 2020 taxonomy

• Inner_Areas_2014_data aggregated data for inner areas according to the former 2014 taxonomy

• Macroarea_data data aggregated for North-West, North-East, Center, South and Islands

Examples

# \donttest{
Get_Invalsi_IS(level = "NUTS-3", autoAbort = TRUE, verbose = FALSE)
# }