SGP (version 0.7-1.0)

baselineSGP: Analyze student data to produce student growth percentiles and coefficient matrices from a baseline (i.e. multiple cohort) norm group

Description

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

Usage

baselineSGP(sgp_object,
        state,
        years,
        content_areas,
        grade.sequences,
        baseline.max.order,
        return.matrices.only=FALSE,
         ...)

Arguments

sgp_object

An object of class SGP containing long formatted data in the code (from prepareSGP) slot.

state

Acronym indicating state associated with the data for access to embedded knot and boundaries, cutscores 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.

grade.sequences

A vector indicating acceptable grade sequences 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 percenti

baseline.max.order

Maximum number of prior scores one wishes to use in the analysis. Defaults to num.panels-2 so that at least two cohorts comprise each baseline norm group. If baseline.max.order=1, then only 1st order growth percentiles are comput

return.matrices.only

Boolean variable indicating whether to calculate student growth percentiles. Defaults to FALSE returning only coefficient matrices.

...

Arguments to be passed to studentGrowthPercentiles for finer control over SGP calculations.

Value

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

See Also

prepareSGP, analyzeSGP, combineSGP

Examples

##  Create baseline coefficient matrices using all available cohorts in the example data
Demonstration_Data <- prepareSGP(sgpData_LONG)
Demonstration_Data <-  baselineSGP(Demonstration_Data)