naep_gap_variable_years
Compare achievement gaps between demographic groups over multiple years to determine if they are increasing or decreasing.
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.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"subject": "<subject>",
"grade": "<grade>",
"variable": "<variable>",
"years": "<years>"
},
"name": "naep_gap_variable_years"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| grade | Yes | Grade: 4, 8, or 12. | |
| years | Yes | 2+ years comma-separated: '2022,2019' or '2022,2017' | |
| subject | Yes | Subject: 'reading', 'math', 'science', etc. Aliases accepted. | |
| variable | Yes | Non-TOTAL variable with 2+ categories: 'SDRACE', 'GENDER', 'SLUNCH3' | |
| jurisdiction | No | 'NP' (default), or state/district code |