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")
@Data
slot that will be used for the production of student growth
and achievement plots and system growth and achievement plots, summary data from summarizeSGP
in the @Summary
slot for bubble plots.
SGPstateData
.
bubblePlot
s using data available in sgp_object
. If missing the
function will use the last year available in the data to produce bubblePlot
s.
bubblePlot
s using data available in sgp_object
. If missing the
function will produce plots for all available content areas provided in the data.
bubblePlot
s using data available in sgp_object
. If missing the
function will produce plots for all available districts provided in the data where districts represent a relevant unit to be represented by the specific bubblePlot
style.
bubblePlot
s using data available in sgp_object
. If missing the
function will produce plots for all available schools provided in the data where districts represent a relevant unit to be represented by the specific bubblePlot
style.
bubblePlot
s using data available in sgp_object
. If missing the
function will produce plots for all available instructors provided in the data where schools and districts represent relevant units to be represented by the specific bubblePlot
style.
bubblePlot
s to produce using data available in sgp_object
. See
associated documentation for example plots.
bubblePlot
. See associated documentation for example plots.
bubblePlot
. See associated documentation for example plots.
bubblePlot
s should use full academic year results if available.
bubblePlot
s.
bubblePlot
s school and district names that appear in the
plots and data tips of the plots. For student level anonymization, the function utilizes the randomNames package to produce gender and ethnic correct names based
upon gender and ethnicity codes available in @Data
.
bubblePlot
s using prior achievement as well as current
achievement as the vertical dimension of the bubblePlot
.
bubblePlot
s should be placed. Default folder is "Visualizations/bubblePlots".
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. |