SchoolDataIT (version 0.2.7)

Get_BroadBand: Download the data regarding the broad band connection activation in Italian schools

Description

Retrieves the data regarding the activation date of the ultra-broadband connection in schools and indicates whether the connection was activated or not at a certain date.

Usage

Get_BroadBand(
  Date = as.Date(format(as.Date(format(Sys.Date(), "%Y-%m-01")) - 1, "%Y-%m-01")),
  include_municipality_code = TRUE,
  input_School2mun = NULL,
  input_Registry = NULL,
  input_AdmUnNames = NULL,
  verbose = TRUE,
  autoAbort = FALSE
)

Value

An object of class tbl_df, tbl and data.frame. The variables BB_Activation_date and BB_Activation_staus indicate the activation date and activation status of the broadband connection at the selected date.

Arguments

Date

Object of class Date. The date at which it is required to determine if the broad band connection has been activated or not. By default, the first day of last month, which we assume to be the last update of the dataset.

include_municipality_code

Logical. Whether to include municipality codes. TRUE by default.

input_School2mun

Object of class list obtained with Get_School2mun. If include_municipality_code == TRUE, the mapping from school codes to municipality (and province) codes. If NULL, it will be downloaded automatically, but not saved in the global environment. NULL by default.

input_Registry

If input_School2mun is required, an object of class tbl_df, tbl and data.frame corresponding to the national school registry (preferably of the last year, i.e. 2024/2025) obtained with Get_Registry. NULL by default.

input_AdmUnNames

If input_School2mun is required, an object of class tbl_df, tbl and data.frame corresponding to the statistical codes of administrative units (preferably referring to the period corresponding to school year 2024/2025) obtained with Get_AdmUnNames. NULL by default.

verbose

Logical. If TRUE, the user keeps track of the main underlying operations. TRUE 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

Ultra - Broadband is defined as everlasting internet connection with a maximum speed of 1 gigabit per second, with a minimum guaranteed speed of 100 megabits/second both on the uploading and downloading operations, until the peering point is reached, as declared on the data provider's website: <https://bandaultralarga.italia.it/scuole-voucher/progetto-scuole/>. In the example the broadband availability at the beginning of school year 2022/23 (1st september 2022) is shown.

Examples

# \donttest{

  Broadband_220901 <- Get_BroadBand(Date = as.Date("2022-09-01"), autoAbort = TRUE)

  Broadband_220901

  Broadband_220901[, c(9,6,13,14)]

# }