SGP: studentGrowthPlot_Styles – R documentation

Become an expert in R — Interactive courses, Cheat Sheets, certificates and more!

studentGrowthPlot_Styles

studentGrowthPlot_Styles providing base templates for the core studentGrowthPlot function

Description

Function includes five "styles" associated with studentGrowthPlot to create PDF student growth plots depicting the growth and achievement for an individual student over time. The five styles display one to five content area student growth plots on a single page. The one, two, and three content area plots are rendered on 8.5 by 11 PDFs and the four and five content area plots are rendered on 11 by 17 PDFs. These charts are currently being used in multiple states to report student growth results. This function is called by visualizeSGP to generate individual student reports. This function may expand in the future to incorporate other possible individual student reports.

Usage

studentGrowthPlot_Styles(
           sgPlot.data,
           sgPlot.sgp_object,
           sgPlot.cutscores,
           state,
           last.year,
           content_areas,
           districts,
           schools,
           reports.by.student,
           reports.by.instructor,
           reports.by.school,
           sgPlot.years,
           sgPlot.demo.report,
           sgPlot.folder,
           sgPlot.folder.names,
           sgPlot.anonymize,
           sgPlot.front.page,
           sgPlot.header.footer.color,
           sgPlot.fan,
	   sgPlot.sgp.targets,
           sgPlot.cleanup,
           sgPlot.baseline,
	   sgPlot.sgp.targets.timeframe,
           sgPlot.zip,
           sgPlot.output.format,
           sgPlot.linkages)

Arguments

`sgPlot.data`	Wide formatted individual student report data used to produce student growth plots. To view structure of wide formatted data, utilize the `sgPlot.save.sgPlot.data` option with `visualizeSGP` to save wide formatted student growth plot data.
`sgPlot.sgp_object`	SGP object containing coefficient matrices and knots and boundaries for percentile trajectory calculations associated with JSON output.
`sgPlot.cutscores`	List of cutscores, possibly transformed, for plotting studentGrowthPlots
`state`	Acronym indicating state associated with the summaries for access to assessment program information embedded in `SGPstateData`.
`last.year`	Argument indicating the final year represented in the student growth plots.
`content_areas`	Argument providing the content areas depicted in the student growth plots.
`districts`	A vector of district numbers indicating which districts student growth plots should be produced for.
`schools`	A vector of school numbers indicating which schools student growth plots should be produce for.
`reports.by.student`	A Boolean variable passed to `studentGrowthPlot_Styles` indicating whether separate individual plots will be produced or separate reports and a summary catalog containing those reports will be produced.
`reports.by.instructor`	A Boolean variable passed to `studentGrowthPlot_Styles` indicating whether individual plots will be collated and bundled as a summary catalog by instructor.
`reports.by.school`	A Boolean variable passed to `studentGrowthPlot_Styles` indicating whether individual plots will be collated and bundled as a summary catalog by school. Prior to version 0.9-9.7, this was the only way of bundling reports and was thus the default.
`sgPlot.years`	A vector of all years over which student growth plots are being produced.
`sgPlot.demo.report`	A Boolean argument indicating whether a demonstration report catalog (with anonymized individual, school, and district names) is to be produced.
`sgPlot.folder`	A character argument specifying the folder into which the student growth reports will be placed.
`sgPlot.folder.names`	Either `names` or `number` indicating whether names or numbers should be used as folder names.
`sgPlot.anonymize`	A Boolean argument indicating whether individual, school, and district names should be anonymized.
`sgPlot.front.page`	A character vector indicating the file, the the base directory, that should be used as the front page for the student growth plots.
`sgPlot.header.footer.color`	A color (as a character) specifying the header/footer color of the report.
`sgPlot.fan`	A Boolean argument indicating whether the projection fan indicating growth rates necessary to reach 1 years targets be displayed.
`sgPlot.sgp.targets`	A Boolean argument indicating whether the sgp targets are to be displayed.
`sgPlot.cleanup`	A Boolean argument indicating whether to cleanup/remove files produced as part of pdfLaTeX build.
`sgPlot.baseline`	A Boolean argument indicating whether to use baseline referenced student growth percentiles in student growth plots.
`sgPlot.sgp.targets.timeframe`	An integer argument indicating the number of years forward associated with SGP targets.
`sgPlot.zip`	A Boolean argument indicating whether to school folders.
`sgPlot.output.format`	Argument indicating the desired type of output format for student growth plots. Either 'PDF', 'PNG', or 'PDF_PIECES'.
`sgPlot.linkages`	Argument passing linkage information (defaults to NULL) associated with assessment scale transition.

Details

studentGrowthPlot_Styles is a utility function containing five templates for displaying studentGrowthPlots. The templates display two or three content areas depending upon the availability of test data for the state. This function will expand in the future to allow for other types of individual growth and achievement reports.

Value

Function produces numerous (potentially hundreds of thousands of) PDF/PNG student growth plots.

Author(s)

Damian W. Betebenner dbetebenner@nciea.org and Adam Van Iwaarden vaniwaarden@colorado.edu

References

Betebenner, D. W. (2012). Growth, standards, and accountability. In G. J. Cizek, Setting Performance Standards: Foundations, Methods & Innovations. 2nd Edition (pp. 439-450). New York: Routledge.

SGP

Student Growth Percentiles & Percentile Growth Trajectories

v1.9-5.0

GPL-3

Authors

Damian W. Betebenner [aut, cre], Adam R. Van Iwaarden [aut], Ben Domingue [aut], Yi Shang [aut], Jonathan Weeks [ctb], John Stewart [ctb], Jinnie Choi [ctb], Xin Wei [ctb], Hi Shin Shim [ctb], Xiaoyuan Tan [ctb] (Arizona Department of Education), Carrie Giovannini [ctb] (Arizona Department of Education), Sarah Polasky [ctb] (Arizona State University), Rebecca Gau [ctb] (Arizona Charter School Association), Jeffrey Dean [ctb] (University of Arkansas), William Bonk [ctb] (Colorado Department of Education), Marie Huchton [ctb] (Colorado Department of Education), Allison Timberlake [ctb] (Georgia Department of Education), Qi Qin [ctb] (Georgia Department of Education), Melissa Fincher [ctb] (Georgia Department of Education), Kiran Athota [ctb] (Georgia Department of Education), Travis Allen [ctb] (Georgia Department of Education), Glenn Hirata [ctb] (Hawaii Department of Education), Glenn Nochi [ctb] (Hawaii Department of Education), Joshua Lee [ctb] (Hawaii Department of Education), Ayaka Nukui [ctb] (Idaho Department of Education), Carissa Miller [ctb] (Idaho Department of Education), Matthew Raimondi [ctb] (Elgin Area School District U46 (Illinois)), Wes Bruce [ctb] (Indiana Department of Education), Robert Hochsegang [ctb] (Indiana Department of Education), Tony Moss [ctb] (Kansas State Department of Education), Xuewen Sheng [ctb] (Kansas State Department of Education), Kathy Flanagan [ctb] (Massachusetts Department of Elementary and Secondary Education), Robert Lee [ctb] (Massachusetts Department of Elementary and Secondary Education), Ji Zeng [ctb] (Michigan Department of Education), Steve Viger [ctb] (Michigan Department of Education), Joe DeCastra [ctb] (Mississippi Department of Education), Ken Thompson [ctb] (Mississippi Department of Education), Soo Yeon Cho [ctb] (Missouri Department of Education), Jeff Halsell [ctb] (Clark County School District, Nevada), Selcuk Ozdemir [ctb] (Washoe County School District, Nevada), Roger Silva [ctb] (Nevada Department of Education), Deb Wiswell [ctb] (New Hampshire Department of Education), Katya Levitan-Reiner [ctb] (New Haven Public Schools), Catherine McCaslin [ctb] (New Haven Public Schools), Joshua Marland [ctb] (New York Education Department), W Joshua Rew [ctb] (Oregon Department of Education), Jason Becker [ctb] (Rhode Island Department of Education), Jessica Bailey [ctb] (Rhode Island Department of Education), Ana Karantonis [ctb] (Rhode Island Department of Education), Deborah Jonas [ctb] (Virginia Department of Education), Juan D'Brot [ctb] (West Virginia Department of Education), Nate Hixson [ctb] (West Virginia Department of Education), Deb Came [ctb] (Washington Office of Superintendent of Public Instruction), Ashley Colburn [ctb] (Washington Office of Superintendent of Public Instruction), Nick Hassell [ctb] (Washington Office of Superintendent of Public Instruction), Krissy Johnson [ctb] (Washington Office of Superintendent of Public Instruction), Daniel Bush [ctb] (Wisconsin Department of Education), Justin Meyer [ctb] (Wisconsin Department of Education), Joseph Newton [ctb] (Wisconsin Department of Education), Nick Stroud [ctb] (Wisconsin Department of Education), John Paul [ctb] (Wyoming Department of Education), Michael Flicek [ctb] (Michael Flicek Projects LLC working with Wyoming Department of Education), Phyllis Clay [ctb] (Albuquerque Public Schools), Peter Kinyua [ctb] (Albuquerque Public Schools), Brendan Houng [ctb] (University of Melbourne, Australia, NAPLAN), Leslie Rosale [ctb] (Ministry of Education, Guatemala), Nathan Wall [ctb] (eMetric working with Nevada Department of Education and South Dakota Department of Education), Narek Sahakyan [ctb] (World Class Instruction and Design (WIDA))

Initial release

2020-1-30