Learn R Programming

SGP (version 0.7-1.0)

studentGrowthPlot_Styles: studentGrowth_Styles providing base templates for the core studentGrowthPlot function

Description

Function includes two "styles" associated with studentGrowthPlot to create PDF student growth plots depicting the growth and achievement for an individual student over time. One styles displayed two content area student growth plots on a single page and the other three content areas. 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,
           state,
           last.year,
           content_areas,
           districts,
           schools,
           reports.by.student,
           sgPlot.years,
           sgPlot.demo.report,
           sgPlot.folder,
           sgPlot.folder.names,
           sgPlot.anonymize,
           sgPlot.front.page,
           sgPlot.header.footer.color,
           sgPlot.fan,
           sgPlot.cleanup)

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
state
Acronym indicating state associated with the summaries for access to assessment program information embedded in stateData.
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 variables 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.
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.cleanup
A boolean argument indicating whether to cleanup/remove file produced as part of pdfLaTeX build.

Value

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

Details

studentGrowthPlot_Styles is a utility function containing a two 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.