Learn R Programming

SGP (version 0.7-1.0)

growthAchievementPlot: growthAchievementPlot for SGP

Description

Function to create growth and achievement plots depicting system level results associated with student growth percentile results. The charts show, simultaneously, norm- and criterion-referneced student achievement (i.e., status) as well as norm- and criterion referenced student growth. These charts are those shown on the cover of Educational Measurement: Issues and Practice as part of Betebenner (2009).

Usage

growthAchievementPlot(
        gaPlot.sgp_object,
        gaPlot.students,
        gaPlot.percentile_trajectories,
        gaPlot.achievement_percentiles=c(.01, seq(.05, .95, by=.05), .99),
        gaPlot.show.scale.transformations=TRUE,
        gaPlot.grade_range,
        state,
        content_area,
        year,
        format="print",
        pdf.folder,
        assessment.name)

Arguments

gaPlot.sgp_object
The sgp_object containing system information for constructing the growth and achievement plot. Object is calculated using abcSGP or (at least) prepareSGP
gaPlot.students
Either NULL (the default) or a list of student IDs for whom one wishes to generate growth and achievement plots.
gaPlot.percentile_trajectories
A vector indicating the growth percentile trajectories to be depicted on the plot. If missing, the percentile trajectories will be the trajectories associated with the state supplied. If no state is supplied, the percentile trajectories will be 10
gaPlot.achievement_percentiles
A vector of percentiles that achievement (i.e., status) percentiles will be depicted across the range of grades.
gaPlot.show.scale.transformations
A boolean arguments (defaults to TRUE) indicating whether to show the scale as a vertical axis if a scale transformation is applied to the supplied data.
gaPlot.grade_range
The grade range for which to demonstrate plot. If missing, function uses supplied state to derive grade range.
state
A two letter acronym for the state associated with the supplied data.
content_area
A character vector indicating the content area to produce the growth and achievement chart. Note that the supplied content area must match that used in the internal labelling of content area for the sgp_object.
year
The year for which to produce the growth and achievement plots.
format
Either "print" (the default) for light background or "presentation" for dark background slides.
pdf.folder
A character vector indicating where to put the produced growth and achievement plot.
assessment.name
A character vector indicating the assessment.name. If missing, the supplied state is used to determine the assessment.name.

Value

  • Function creates a growth and achievement chart and writes the result as a PDF to pdf.folder.

Details

Typical use of the function is as part of visualizeSGP function. However, function can be used to produce growth and achievement charts.

References

Betebenner, D. W. (2009). Norm- and criterion-referenced student growth. Educational Measurement: Issues and Practice, 28(4):42-51.