naep_gap_variable_years
Analyze changes in achievement gaps between demographic groups over time using NAEP data. Compare gaps across years to identify trends in educational equity.
Instructions
Compare how achievement gaps between demographic groups change over time. Example: Is the racial achievement gap in reading getting bigger or smaller since 2017? Returns innerdiff1 (group gap for focal year), innerdiff2 (group gap for target year), and the gap between them.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| subject | Yes | Subject: 'reading', 'math', 'science', etc. Aliases accepted. | |
| grade | Yes | Grade: 4, 8, or 12. | |
| variable | Yes | Non-TOTAL variable with 2+ categories: 'SDRACE', 'GENDER', 'SLUNCH3' | |
| years | Yes | 2+ years comma-separated: '2022,2019' or '2022,2017' | |
| jurisdiction | No | 'NP' (default), or state/district code |