compare_providers
Compare NSS results across multiple higher education providers side by side, using OfS benchmarks to see which exceed expectations.
Instructions
Compare NSS results across two or more providers, side by side.
Returns one entry per question/theme, each holding every provider's
positivity score, its OfS benchmark and its position against it, plus the
UK sector average for context. Because each provider is judged against
its own benchmark, this comparison is fairer than ranking raw scores —
say which providers beat their benchmark, not just who scored highest.
Args:
ukprns: Two or more provider ids from search_providers.
subject: Optional CAH subject name filter, e.g. "Computing". Omit to
compare at whole-provider level.
question: Filter on question/theme text. Defaults to "Theme" (the
seven headline themes), which keeps the comparison readable.
Pass None (or a specific question) to widen or narrow it.
subject_level, population, mode_of_study, level_of_study: As in
nss_scores.
A provider missing from a row has suppressed data on that cut (under 10
respondents) — report the gap, don't fill it.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ukprns | Yes | ||
| subject | No | ||
| question | No | Theme | |
| population | No | Registered | |
| mode_of_study | No | All modes | |
| subject_level | No | CAH2 | |
| level_of_study | No | First degree |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |