intsvy.ben.pv: Performance international benchmarks and proficiency levels

In intsvy: International Assessment Data Manager

Performance international benchmarks and proficiency levels

Description

intsvy.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 official reports.

Usage

intsvy.ben.pv(pvnames,  by, cutoff, data, atlevel=FALSE, export = FALSE, name = "output", 
  folder = getwd(), config)

Arguments

pvnames	The names of columns corresponding to the achievement plausible scores, for example, paste0("PV",1:10,"MATH") for PISA
cutoff	The cut-off points for the assessment benchmarks (e.g., cutoff= c(357.77, 420.07, 482.38, 544.68, 606.99, 669.30)).
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.
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.
config	Object with configuration of a given study. Should contain the slot 'prefixes' with prefixes of filenames with the student, home, school, and teacher data.

Value

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

See Also

timss.ben.pv, pirls.ben.pv, pisa.ben.pv

Examples

## Not run: 
pisa.ben.pv(pvlabel= paste0("PV",1:10,"MATH") for PISA, by="CNT", 
data=pisa, atlevel = TRUE)

intsvy.ben.pv(pvnames= paste0("PV",1:10,"MATH") for PISA by="CNT", 
data=pisa, atlevel= TRUE, config=pisa_conf)

piaac.ben.pv(pvlabel= paste0("PVLIT", 1:10), by="CNTRYID", data=piaac)

intsvy.ben.pv(pvnames= paste0("PVLIT", 1:10), by="CNTRYID", data=piaac, 
config=piaac_conf)

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

intsvy.ben.pv(pvnames= paste0("BSMMAT0", 1:5), by="IDCNTRYL", data=timss4, 
config=timss4_conf)

## End(Not run)

intsvy documentation built on Oct. 3, 2023, 1:07 a.m.