*! version 12 APR2020
help pisastats also see: pisareg pisacmd pisaqreg pisaoaxaca pv repest

Title

[R] pisastats Basic statistics with PISA data

Syntax

pisastats
indep_vars
, stats(string) pv(string) cnt(string) save(string) over(var) cycle(int) round(int) fast sas

Main options

stats(string) Specifies a list of statistics to be calculated with PISA data. You can ask for any statistic available after -sum, detail- command. Not specifying this option will produce an output with means of variables and plausible values

pv(string) Specifies a cognitive domain for which you want to calculate statistics. You should use 4 letter codes which are identical to last four letters of variables containing plausible values in the original PISA datasets. For example, math will produce results for mathematics as pv*math is the name of plausible values for mathematic literacy in all PISA datasets, while read will produce results for reading. Not specifying this option will result in estimates for variables only.

cnt(string) Specifies a list of countries for which you want to obtain results. If OECD is specified, then results are provided for all OECD countries. If ALL is specified, then results are provided for all countries participating in PISA cycle. When PARTNERS is specified, then results are provided for partner non-OECD countries and economies. Results can be provided for distinct groups of countries by specifying a list with three letter ISO codes. For example, ("AUS DEU POL") will produce results for Australia, Germany, and Poland. The OECD average is calculated only when OECD or ALL is specified

save(filename, ...) save
results to filename

over(var) Specifies a categorical variable for which you want to obtain statistics by each category. The variable must be numerical with a sequence of integers denoting each category

Optional

cycle(int) Specifies which PISA cycle you analyze. This affects the list of countries recognized as OECD, PISA or PARTNERS in option cnt()
as well as which names of plausible values will be recognized when given as dependent variable. Default is 2018.

round(int) Specifies how many decimal places you want to see in results tables

fast Specifying this option dramatically speeds up calculations at the cost of not fully valid estimates of standard errors. Statistic itself is calculated properly, however, standard errors are provided only for means using the Stata svy linearized command. These standard errors are usually overstimated comparing to the standard BRR method.

sas Specifying this option standard deviations are calculated using SAS formulas that are used for the OECD reports

Description

pisastats Calculates basic statistics with PISA data. Standard errors are calculated using the BRR method. Statistics for plausible values are calculated using all five (PISA 2012 or earlier) or all ten plausible values (PISA 2015 or 2018). The command uses survey information provided in the original publicly available PISA datasets. You need to keep variables like cnt, schoolid, w_fstuwt and cnt to be able to use this command.

Examples

. pisastats escs, over(gender) pv(scie) cnt(POL) save(example1)

. pisastats, pv(math) cnt(FRA) save(example2)

. pisastats escs, over(gender) pv(read) cnt(AUS ARG) stats("p50 sd") save(example3) round(5)

. pisastats escs, over(gender) pv(scie) cnt(OECD) save(example4)

. pisastats, pv(math) stats("mean sd p5 p10 p25 p50 p75 p90 p95") cnt(ALL) save(example5)

. pisastats escs, pv(read) cnt(PISA) cycle(2018) save(example6) fast

References

When using our package please provide this reference in your work:

Maciej Jakubowski & Artur Pokropek (2017), PISATOOLS: Stata module to facilitate analysis of the data from the PISA OECD study, Statistical Software Components, Boston College Department of Economics.

The formulas were taken from:

OECD (2009), PISA Data Analysis Manual: SPSS and SAS, Second Edition, OECD, Paris

OECD (2017), PISA 2015 Technical Report, OECD, Paris

Rubin, D. B. (1987), Multiple imputations for nonresponse in surveys, New York, John Wiley and Sons

Authors

Maciej Jakubowski, Evidence Institute and University of Warsaw, Poland
email: mj@evidenceinstitute.pl

Artur Pokropek, Institute of Philosophy and Sociology, Polish Academy of Sciences

Also see

Other commands in this package pisareg, pisacmd, pisaqreg, pisaoaxaca.

User-written commands pv.ado or repest.ado. Type pv or repest if installed.

Version

Last updated April 2020, by Maciej Jakubowski