SGP (version 0.7-1.0)

summarizeSGP: Summarize student scale scores, proficiency levels and student growth percentiles according to user specified summary group variables

Description

Utility function used to produce summary tables using long formatted data that contain student growth percentiles. An exemplar is provided from the successive execution of prepareSGP, analyzeSGP and combineSGP.

Usage

summarizeSGP(sgp_object,
           state,
           years,
           content_areas,
           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('Proficient', 'Advanced')), list(c('Unsatisfactory', 'Partially Proficient', 'Proficient', 'Advanced')))",
             PERCENT_AT_ABOVE_PROFICIENT_COUNT="num_non_missing(ACHIEVEMENT_LEVEL)",
             PERCENT_AT_ABOVE_PROFICIENT_PRIOR="percent_in_category(ACHIEVEMENT_LEVEL_PRIOR, list(c('Proficient', 'Advanced')), list(c('Unsatisfactory', 'Partially Proficient', 'Proficient', 'Advanced')))",
             PERCENT_AT_ABOVE_PROFICIENT_PRIOR_COUNT="num_non_missing(ACHIEVEMENT_LEVEL_PRIOR)"),
           summary.groups=list(institution=c("STATE", "DISTRICT_NUMBER", "SCHOOL_NUMBER"),
             content="CONTENT_AREA",
             time="YEAR",
             institution_level="GRADE",
             demographic=c("GENDER", "ETHNICITY", "FREE_REDUCED_LUNCH_STATUS", "ELL_STATUS", "IEP_STATUS", "GIFTED_AND_TALENTED_PROGRAM_STATUS", "CATCH_UP_KEEP_UP_STATUS"),
             institution_inclusion=list(STATE="STATE_ENROLLMENT_STATUS", DISTRICT_NUMBER="DISTRICT_ENROLLMENT_STATUS", SCHOOL_NUMBER="SCHOOL_ENROLLMENT_STATUS")),
           confidence.interval.groups=list(TYPE="Bootstrap",
             VARIABLES=c("SGP"),
             QUANTILES=c(0.025, 0.975),
             GROUPS=list(institution="SCHOOL_NUMBER",
               content="CONTENT_AREA",
               time="YEAR",
               institution_level= NULL,
               demographic=NULL,
               institution_inclusion=list(STATE=NULL, DISTRICT_NUMBER=NULL, SCHOOL_NUMBER="SCHOOL_ENROLLMENT_STATUS"))))

Arguments

sgp_object

A list containing long formatted data in the Student slot. If summaries of student growth percentiles are requested, those quantities must first be produced (possibly by first using analyzeSGP

state

Acronym indicating state associated with the summaries for access to assessment program information embedded in stateData.

years

A vector indicating year(s) in which to produce summary tables associated with student growth percentile and percentile growth trajectory/projection analyses. If missing the function will use the data to calculate years and produce summaries for the most

content_areas

A vector indicating content area(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 content area(s) available for analyses.

sgp.summaries

A list giving the summaries requested for each group analyzed based upon the summary.group argument. The default summaries include: ll{ MEDIAN_SGP The group level median student growth percentile. MEDIAN

summary.groups

A list consisting of 5 types of groups across which all summaries are taken (Inclusion means that summaries will be calculated for levels of the associated variable) including: ll{ institution: State, District and/or Sch

confidence.interval.groups

A list consisting of information used to calculate group confidence intervals: ll{ TYPE: Either Bootstrap (default) or CSEM indicating Bootstrap confidence interval calculation (the default) or c

Value

• Function returns lists containing the summary tables as data.table objects in the Summary slot of the SGP data object. Each institution has a slot in the Summary list.

Details

Function makes use of the foreach package to parallel process summary tables of student data. Currently, it is the user's responsibility to register a parallel back end of their choice before running the summarizeSGP function. The proper choice may be dependent upon the user's operating system, software and system memory capacity. Please see the foreach documentation for details. If no parallel back end is specified, the function will process the summary tables sequentially.

See Also

prepareSGP, analyzeSGP, combineSGP

Examples

## summarizeSGP is Step 4 of 5 of abcSGP
Demonstration_Data <- sgpData_LONG
Demonstration_Data <- prepareSGP(Demonstration_Data)
Demonstration_Data <- analyzeSGP(Demonstration_Data)
Demonstration_Data <- combineSGP(Demonstration_Data)
Demonstration_Data <- summarizeSGP(Demonstration_Data)