intsvy (version 2.9)

timss.ben.pv: TIMSS international benchmarks

Description

timss.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

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

Value

timss.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.

Arguments

pvlabel

The names of columns corresponding to the achievement plausible scores.

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 TIMSS.

atlevel

A logical value. If TRUE, percentages at each level are calculated. Otherwise (FALSE), percentages at or above levels are reported.

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.

See Also

pirls.ben.pv, pisa.ben.pv

Examples

if (FALSE) {
timss.ben.pv(pvlabel= paste0("BSMMAT0", 1:5), by="IDCNTRYL", 
cutoff = c(400, 475, 550, 625), data=timss8g)

timss.ben.pv(pvlabel= paste0("BSMMAT0", 1:5), by="IDCNTRYL", data=timss4g)
}