Subscores

Adding Subscore Definitions

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 Advanced mode of the Activity Builder.

Review the following example showing an Activity Definition (as you might see in the Advanced panel), where 3 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"
                }
            ]
        }
    ]
}

Subscore Reporting

You can use the Data API to retrieve subscore results, from either of the following endpoints:

After completing an activity, a students 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
        }
    }
]