pirls.ben.pv: PIRLS international benchmarks

In dickli/intsvy2: International Assessment Data Manager 2

Description

pirls.ben.pv calculates the percentage of students performing at or above the cut-off points (scores) given by the useR. The default are the benchmarks established by PIRLS/TIMSS.

Usage

pirls.ben.pv(pvlabel, by, cutoff, data, export = FALSE, name = "output", folder = getwd())

Arguments

pvlabel	The label corresponding to the achievement variable, for example, "ASRREA", for overall reading performance.
cutoff	The cut-off points for the assessment benchmarks (e.g., cutoff = c(400, 475, 550, 625).
by	The label for the grouping variable, usually the countries (i.e., by="IDCNTRYL"), but could be any other categorical variable.
data	An R object, normally a data frame, containing the data from PIRLS.
export	A logical value. If TRUE, the output is exported to a file in comma-separated value format (.csv) that can be opened from LibreOffice or Excel.
name	The name of the exported file.
folder	The folder where the exported file is located.

Value

pirls.ben.pv returns a data frame with the percentage of students at or above the benchmark and the corresponding standard error.

The total weight, "TOTWGT" and the cut-off points or benchmarks are defined in the config object.

See Also

timss.ben.pv, pisa.ben.pv

Examples

## Not run: 
# PIRLS: Exhibit 2.14 User Guide PIRLS 2011, p. 24
pirls.ben.pv(pvlabel="ASRREA", by="IDCNTRYL",  data=pirls)

## End(Not run)

dickli/intsvy2 documentation built on Sept. 8, 2020, 12:05 a.m.