Usage
growthAchievementPlot( gaPlot.sgp_object, gaPlot.students=NULL, gaPlot.percentile_trajectories, gaPlot.achievement_percentiles=c(.01, seq(.05, .95, by=.05), .99), gaPlot.show.scale.transformations=TRUE, gaPlot.grade_range, gaPlot.max.order.for.progression=NULL,
gaPlot.start.points="Achievement Level Cuts",
gaPlot.subtitle = TRUE, state, content_area, year, format="print", baseline=FALSE, equated=NULL,
output.format="PDF", output.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
followed by analyzeSGP. The function requires coefficient matrices in order to display percentile growth trajectories.
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, 35, 50, 65, 90.
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.
gaPlot.max.order.for.progression
The maximum coefficient matrix order to use for each progression. Default is NULL which utilizes the maximum order available with the coefficient matrices.
gaPlot.start.points
Either 'Achievement Level Cuts' or 'Achievement Percentiles' defining where the growth percentiles trajectories will start in the growth achievement plots.
gaPlot.subtitle
Boolean variable (defaults to TRUE) indicating whether subtitle is printed on the growth achievement chart indicating student starting point.
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 labeling 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.
baseline
Boolean variable (defaults to FALSE) indicating whether to create percentile trajectories using baseline referenced coefficient matrices.
equated
Boolean variable (defaults to FALSE) indicating whether to utilize linked matrices to generate growth and achievement plots.
output.format
A character vector indicating which output format to use. Currently support 'PDF' (the default) and 'PNG'. The call to growthAchievementPlot in visualizeSGP outputs in both
formats.
output.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.