Download ILSA files

In ILSAmerge: Merge and Download International Large-Scale Assessments (ILSA) Data

library(ILSAmerge)

knitr::opts_chunk$set(
  collapse = TRUE
)

Available datasets

Currently ILSAmerge is able to download several ILSA datasets, including: 'PISA', 'TALIS', 'TIMSS', 'TIMSS Advanced', 'PIRLS', 'ICCS', 'ICILS', 'CIVED', 'REDS', 'RLII', and 'SITES.'

The links of these datasets are allocated in GitHub, so links can be corrected if they are down.

With availableILSA(), we can check which datasets are available:

availableILSA()

Download the datasets for a particular study

Depending on the study datasets are uploaded in 1 or more .zip files. That is why ILSAdownload() will handle by itself how many and which .zip files to download.

As an example, we let us say we want to download the data of 'RLII' 1991. Then, at least we need to opt for three arguments; study, year, and outputdir:

ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir())

try(ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir()),silent = TRUE)

As we can see, some studies will require that you agree with their license agreements. If that is the case, you will be required to answer if you agree or not. In order to continue, you will need to agree. If you know that you will agree with the study terms, then you can also avoid this prompt via agreeLicense = TRUE:

ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir(),
             agreeLicense = TRUE)

Unzip

This function can also unzip downloaded files using unzip = TRUE:

ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir(),
             unzip = TRUE)

Avoid printing

It is possible to avoid any printing by quiet = TRUE, but you will still be prompted to agree. To avoid both prints you can use both arguments:

ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir(),
             quiet = TRUE, agreeLicense = TRUE)

Download time

Timeout times for downloading are controlled by maxtime, which you can set for a desired number of seconds:

ILSAdownload(study = "RLII", year = 1991, outputdir = tempdir(),
             maxtime = 60)

ILSAmerge documentation built on April 11, 2025, 5:54 p.m.