bubblePlot_Styles providing various uses of the core bubblePlot function
Function includes a number of "styles" associated with bubblePlot
to create bubble plots depicting a variety of relationships often of interest
to stakeholders. The bubblePlot
function itself is adaptable to many representations but is most often used in conjunction with results derived
from summarizeSGP
to represent summary level results of growth against achievement (usually, median student growth percentile against percentage
at/above proficient).
bubblePlot_Styles( sgp_object, state, bPlot.years=NULL, bPlot.content_areas=NULL, bPlot.districts=NULL, bPlot.schools=NULL, bPlot.instructors=NULL, bPlot.styles=c(1), bPlot.levels=NULL, bPlot.level.cuts=NULL, bPlot.full.academic.year=TRUE, bPlot.minimum.n=10, bPlot.anonymize=FALSE, bPlot.prior.achievement=TRUE, bPlot.draft=FALSE, bPlot.demo=FALSE, bPlot.output="PDF", bPlot.format="print", bPlot.folder="Visualizations/bubblePlots")
sgp_object |
An object of class SGP containing long formatted data in the |
state |
Acronym indicating state associated with the summaries for access to assessment program information embedded in |
bPlot.years |
A vector indicating year(s) in which to produce |
bPlot.content_areas |
A vector indicating content area(s) to produce |
bPlot.districts |
A vector indicating districts to produce |
bPlot.schools |
A vector indicating schools to produce |
bPlot.instructors |
A vector indicating instructors to produce |
bPlot.styles |
A vector of positive integers indicating the types of |
bPlot.levels |
A character vector of levels to be used to color bubbles in the |
bPlot.level.cuts |
A vector of cuts to be used to distinguish levels used to color bubbles in the |
bPlot.full.academic.year |
A Boolean argument (defaults to TRUE) indicating whether |
bPlot.minimum.n |
A positive integer (defaults to 10) indicating the minimum size for summary values to be displayed in the |
bPlot.anonymize |
A Boolean argument (defaults to FALSE) indicating whether to anonymize |
bPlot.prior.achievement |
A Boolean argument (defaults to TRUE) indicating whether to produce |
bPlot.draft |
A Boolean argument (defaults to FALSE) indicating whether to put an indicator on the chart noting that the results are draft and to not distribute. |
bPlot.demo |
A Boolean argument (defaults to FALSE) indicating whether to produce demo student level plots (styles 150 and/or 153) for instructors. |
bPlot.output |
Argument indicating the desired type of output format for bubble plots. Either 'PDF' (default) or 'PNG'. |
bPlot.format |
Either "print" or "presentation" indicating whether to optimize the plot for print form (light background) or presentation form (dark background). |
bPlot.folder |
Character vector indicating where |
bubblePlot_Styles
is an omnibus function containing a number of applications of the bubblePlot
function with data output from SGP
analyses. As added styles are
constructed they will be added to the function allowing user to construct plots of their liking. User wishing to participate and provide or suggest specific styles of their own should
contact the package maintainer. Styles representing summary level data (e.g., growth and achievement for schools) are currently assigned numbers from 1 to 99 and styles representing
individual level data (e.g., growth and achievement for students within a single grade) are currently assigned numbers from 100 to 199.
1 : |
Growth and achievement bubblePlot s for the entire state with bubbles representing schools. |
100 : |
Growth and achievement bubblePlot s by grade for students in selected schools and districts. |
Function produces numerous PDF bubble charts in the styles specified by the function.
Damian W. Betebenner dbetebenner@nciea.org and Adam Van Iwaarden vaniwaarden@colorado.edu
Please choose more modern alternatives, such as Google Chrome or Mozilla Firefox.