Submit a request
Submit a request

Using Subscores with Your Activities

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.

Was this article helpful?

Did you arrive here by accident? If so, learn more about Learnosity by clicking here.