SGP (version 1.0-3.0)

combineSGP: Combine student data and SGP results

Description

Utility function/exemplar used to merge student long data with results from student growth percentiles and/or student growth projections calculations. Default values of this function are designed to be used following use of other utility functions: prepareSGP and analyzeSGP. Function is integrate with cutscores embedded in SGPstateData to calculate growth-to-standard targets associated with catch-up/keep-up to proficient status and move-up/stay-up to advanced status.

Usage

combineSGP(sgp_object,
	state=NULL,
	years=NULL,
	content_areas=NULL,
	sgp.percentiles=TRUE,
        sgp.percentiles.baseline=TRUE,
	sgp.projections.lagged=TRUE,
        sgp.projections.lagged.baseline=TRUE,
	max.sgp.target.years.forward=3,
	update.all.years=FALSE)

Arguments

sgp_object

A list containing both Student (from prepareSGP) and SGP (from analyzeSGP) slots.

state

Acronym for which state is to be used for the lagged projections and growth to standard analyses. Function will try to guess state name from passed sgp_object is missing.

years

A vector of years indicating years of data to merge with @Data. If missing, merge will use all available years of student growth percentile results.

content_areas

A vector of content areas indicating content areas of student growth percentile data to merge with @Data. If missing, merge will use all available content areas of student growth percentile results.

sgp.percentiles

A boolean variable indicating whether to combine student growth percentiles.

sgp.percentiles.baseline

A boolean variable indicating whether to combine baseline student growth percentiles.

sgp.projections.lagged

A boolean variable indicating whether to combine lagged student growth projections and calculate catch-up/keep-up and move-up/stay-up values.

sgp.projections.lagged.baseline

A boolean variable indicating whether to combine lagged baseline student growth projections and calculate catch-up/keep-up move-up/stay-up values.

max.sgp.target.years.forward

A integer indicating the number of years forward from the lagged (last year's) score to project forward for growth to standard calculations. Default is 3 years from the present, 4 years from the lagged year, which is the standard in most growth to standar

update.all.years

A boolean argument defaulting to FALSE indicating whether combineSGP should delete previously merged variables calculated in analyzeSGP and re-merge all available data.

Value

• Function returns a list containing the input long data set in the Student slot as a data.table keyed using VALID_CASE, CONTENT_AREA, YEAR, ID merged with student growth percentiles and/or lagged projection targets and catch-up/keep-up and move-up/stay-up status.

See Also

prepareSGP, analyzeSGP

Examples

## combineSGP is Step 3 of 5 of abcSGP
Demonstration_SGP <- sgpData_LONG
Demonstration_SGP <- prepareSGP(Demonstration_SGP)
Demonstration_SGP <- analyzeSGP(Demonstration_SGP)
Demonstration_SGP <- combineSGP(Demonstration_SGP)