README.md

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

ILSAmerge

It is common that data from International Large-Scale Assessments (ILSA), like TIMSS, TIMSS Advanced, PIRLS, ICCS, ICILS, CIVED, REDS, RLII, and SITES, come in an unaggregated format.

That means that data is published in hundreds of files, each of one represents a combination of countries and participants (students, teachers, principals, etc.)

It is also common that researches would need to merge this data to include all countries into a single file.

The goal of ILSAmerge is to make this process as simple and as straightforward as possible.

Installation

You can install the stable version of ILSAmerge directly from CRAN:

install.packages("ILSAmerge")

Or, if you wish to install the development version of ILSAmerge:

remotes::install_github("dopatendo/ILSAmerge")

Downloading files

For downloading ILSA data, we can use ILSAdownload(). For an example see vignette("Download").

Identify ILSA files

For identifying populations within a study, we can use ILSAfiles.info(). For an example see vignette("IndentifyILSAfiles").

Load data without merging

If we need to load ILSA data but not save it, we can use justload(). For an example see vignette("Load").

Merge files

For merging ILSA data, we can use ILSAmerge(). For an example see vignette("Merge").

Rename files

For rename ILSA data, we can use ILSArename(). For an example see vignette("Rename").

Download, merge and combine in one step

We can also combine all the steps for preparing ILSA data (downloading, merging, combining respondents, and renaming) using ILSAready().

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