SGP (version 0.0-8.0)

analyzeSGP: Analyze student data to produce student growth percentiles and student growth projections

Description

Utility function/exemplar used to produce student growth percentiles and student growth projections using long formatted data like that provided by prepareSGP.

Usage

analyzeSGP(sgp_object,
           state,
           years,
           content_areas,
           grades,
           sgp.config,
           sgp.percentiles=TRUE,
           sgp.projections=TRUE,
           sgp.projections.lagged=TRUE,
           simulate.sgps=TRUE,
           goodness.of.fit.print=TRUE)

Arguments

sgp_object
A list containing long formatted data in the Student (from prepareSGP) slot.
state
Acronym indicating state associated with the data for access to embedded knot and boundaries, cutscores, CSEMs, and other state related assessment data.
years
A vector indicating year(s) in which to produce student growth percentiles and/or student growth projections/trajectories. If missing the function will use the data to infer the year(s) based upon the assumption of having at least three years of panel da
content_areas
A vector indicating content area(s) in which to produce student growth percentiles and/or student growth projections/trajectories. If left missing the function will use the data to infer the content area(s) available for analyses.
grades
A vector indicating grades for which to calculate student growth percentiles and/or student growth projections/trajectories. If left missing the function will use the data to infer all the grade progressions for student growth percentile and student grow
sgp.config
If years, content_areas, and grades are missing, user can directly specify a list containing three vectors: sgp.content.areas, sgp.panel.years, and sgp.grade.sequences. This ad
sgp.percentiles
Boolean variable indicating whether to calculate student growth percentiles. Defaults to TRUE.
sgp.projections
Boolean variable indicating whether to calculate student growth projections. Defaults to TRUE.
sgp.projections.lagged
Boolean variable indicating whether to calculate lagged student growth projections often used for growth to standard analyses. Defaults to TRUE.
simulate.sgps
Boolean variable indicating whether to simulate SGP values for students based on test-specific Conditional Standard Errors of Measurement (CSEM). Test CSEM data must be available for simulation and included in stat
goodness.of.fit.print
Boolean variable indicating whether to print out Goodness of Fit figures as pdf into a directory labeled Goodness of Fit. Defaults to TRUE.

Value

  • Function returns a list containing the long data set in the Student slot as a data.table keyed using VALID_CASE, CONTENT_AREA, YEAR, ID and the student growth percentile and/or student growth projection/trajectory results in the SGP slot.

See Also

prepareSGP, combineSGP

Examples

Run this code
## analyzeSGP is Step 2 of 5 of abcSGP
DEMO_Data <- analyzeSGP(DEMO_Data, state="DEMO")

Run the code above in your browser using DataLab