pisa.ben.pv: PISA proficiency levels

Description Usage Arguments Value See Also Examples

View source: R/pisa.ben.pv.R

Description

Calculates percentage of students at each proficiency level defined by PISA. Or at proficiency levels provided by the useR. Use the pisa2015.ben.pv() for data from PISA 2015 study.

Usage

1
2
pisa.ben.pv(pvlabel, by, cutoff, data, export=FALSE, name= "output", folder=getwd())
pisa2015.ben.pv(pvlabel, by, cutoff, data, export=FALSE, name= "output", folder=getwd())

Arguments

pvlabel

The label corresponding to the achievement variable, for example, "READ", for overall reading performance.

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

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

pisa.ben.pv returns a data frame with the percentage of students at each proficiency level and its 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, pirls.ben.pv

Examples

1
2
3
4
5
## Not run: 
# Table I.2.1a, p. 298 International Report 2012 Volume I
pisa.ben.pv(pvlabel="MATH", by="IDCNTRYL", data=pisa)

## End(Not run)

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