Subscores are a breakdown of a total score achieved for an Activity. They allow you to extract groups of Items, and focus on scoring them separately.
To create a subscore definition you need to decide which Items, or Item Tags, must be used to create subscore groups for calculations. Currently subscore definitions can only be added using JSON in the Source tab of the Activity Editor.
Review the following example showing an Activity Definition (as you might see in the Source tab), where three subscore groups have been defined:
{
"items": [
"instructions",
"Practice Test 10",
"ELA_Practice Test_2-11_EBSR",
"Practice Test 2",
"Practice Test 13",
"Practice Test 1",
"379811379",
"379805300",
"379805290",
"379808350",
"379811299"
],
"config": {},
"subscores": [
{
"id": "subscore-test-1",
"title": "Subscore Test 1",
"items": [
"Practice Test 10",
"ELA_Practice Test_2-11_EBSR",
"Practice Test 2",
"Practice Test 13"
]
},
{
"id": "subscore-test-1",
"title": "Subscore Test 2",
"items": [
"Practice Test 1",
"379811379",
"379805300",
"379805290",
"379808350",
"379811299"
]
},
{
"id": "subscore-test-3",
"title": "Subscore Test 3",
"tags": [
{
"type": "form",
"name": "CCASFall13Practice"
},
{
"type": "technology-enhanced",
"name": "Yes"
}
]
}
]
}
Code Example 1: an Activity definition with three subscore groups
Subscore reporting
You can use the Data API to retrieve subscore results, from either of the following endpoints:
- Responses
- Scores
After completing an Activity, a learner's response will include subscore calculations, as below:
{
"subscores": [
{
"id": "subscore-test-1",
"title": "Subscore Test 1",
"num_questions": 5,
"num_attempted": 5,
"score": 2,
"max_score": 5,
"attempted_max_score": 5,
"items": [
"Practice Test 10",
"ELA_Practice Test_2-11_EBSR",
"Practice Test 2",
"Practice Test 13"
],
"ability_estimate": {
"ability_estimate": 0.5,
"standard_error": 0.2
}
},
{
"id": "subscore-test-2",
"title": "Subscore Test 2",
"num_questions": 6,
"num_attempted": 6,
"score": 5,
"max_score": 6,
"attempted_max_score": 5,
"items": [
"Practice Test 1",
"379811379",
"379805300",
"379805290",
"379808350",
"379811299"
],
"ability_estimate": {
"ability_estimate": 2.4,
"standard_error": 0.3
}
},
{
"id": "subscore-test-3",
"title": "Subscore Test 3",
"num_questions": 5,
"num_attempted": 5,
"score": 5,
"max_score": 5,
"attempted_max_score": 5,
"items": [
"379811379",
"379811299",
"379808350",
"379805300",
"379805290"
],
"ability_estimate": {
"ability_estimate": 3.5,
"standard_error": 0.2
}
}
]
}
Code Example 2: a learner's response with subscore calculations.