SGP (version 0.0-6.9)

abcSGP: Perform 4 step sequence: prepareSGP, analyzeSGP, combineSGP, and summarizeSGP

Description

Utility function to perform sequence of steps going from data preparation, prepareSGP, SGP data analysis, analyzeSGP, data combining, combineSGP, and data summarization, summarizeSGP. Calculating and using student growth percentiles is as easy as ABC.

Usage

abcSGP(sgp_object=sgpData_LONG,
    state="DEMO",
    years,
    content_areas,
    grades,
    sgp.config,
    sgp.percentiles=TRUE,
    sgp.projections=TRUE,
    sgp.projections.lagged=TRUE,
    simulate.sgps=TRUE,
    sgp.summaries=list(MEDIAN_SGP="median_na(SGP)",
       MEDIAN_SGP_COUNT="num_non_missing(SGP)",
       PERCENT_AT_ABOVE_PROFICIENT=
           "percent_in_category(ACHIEVEMENT_LEVEL, list(c(1,4)), list(1:5))",
       PERCENT_AT_ABOVE_PROFICIENT_COUNT=
           "num_non_missing(ACHIEVEMENT_LEVEL)"),
    summary.groups=list(institution=c("STATE", "SCHOOL_NUMBER"),
       content="CONTENT_AREA",
       time="YEAR",
       institution_level="GRADE",
       demographic=c("GENDER", "ETHNICITY", "FREE_REDUCED_LUNCH_STATUS",
           "ELL_STATUS", "CATCH_KEEP_UP"),
       institution_inclusion=list(STATE="OCTOBER_ENROLLMENT_STATUS", 
            SCHOOL_NUMBER="OCTOBER_ENROLLMENT_STATUS")),
    confidence.interval.groups=list(institution="SCHOOL_NUMBER",
       content="CONTENT_AREA",
       time="YEAR",
       institution_level= NULL,
       demographic=NULL,
       institution_inclusion=list(STATE=NULL, 
            SCHOOL_NUMBER="OCTOBER_ENROLLMENT_STATUS")))

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 and cutscores.

years

A vector indicating years 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 years based upon the assumption of having at least three years of panel d

content_areas

A vector indicating content areas 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 areas 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. Must be set to TRUE for confidence interval construction.

sgp.summaries

A list giving the summaries requested for each group analyzed based upon the summary.group argument.

summary.groups

A list consisting of 5 types of groups across which all summaries are taken: institution, content, time, institution_level, demographic, and institution_inclusion. Summaries gen

confidence.interval.groups

A subset of the groups provided in the summary.groups argument indicating which groups to provide confidence intervals for. See documentation for summarizeSGP and

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, SGP results including student growth percentile and student growth projections/trajectories in the SGP slot, and summary results in the Summary slot.

See Also

sgpData_LONG, prepareSGP, analyzeSGP, combineSGP, summarizeSGP, studentGrowthPercentiles, and studentGrowthProjections

Examples

DEMO_Data <- abcSGP(sgpData_LONG)