Mastery Scale Mapper
Map an assessment score onto a caller-defined standards-based mastery scale.
Description
A mastery scale maps a numeric score to the highest attained lower bound.
A mastery scale maps a numeric score to the highest attained lower bound. The next-bound distance helps interpret scores below the top mapped level.1
Map an assessment score onto a caller-defined standards-based mastery scale.
When to use Mastery Scale Mapper
Use this tool to map an assessment score onto a caller-defined standards-based mastery scale.
Prepare the lesson timeline, roster, observations or assessment labels requested. Use consistent units and exact identifiers, then choose comparison criteria appropriate to the activity.
How to use Mastery Scale Mapper and understand its results
- Prepare the lesson timeline, roster, observations or assessment labels requested. Use consistent units and exact identifiers, then choose comparison criteria appropriate to the activity.
- Enter score, minimumScores, levelLabels using the field table and calculation rules, then run the tool.
- Read level, distanceToNext. The explanation below defines the units, signs, ordering and any flags or placeholder values.
- If the tool reports an input issue, correct the values and run it again. Apply the stated assumptions when interpreting a successfully returned result.
| Input field | Meaning | Value type; see rules below | Requirement |
|---|---|---|---|
| score | Score | number | Required |
| minimumScores | Minimum scores | list of number | Required |
| levelLabels | Level labels | list of string | Required |
Enter nonempty strictly increasing finite cutoffs and aligned distinct exact labels with a finite score. Reject scores below the first cutoff; return mapped label and next-level distance.
level=last i with score≥minimumScores_i; distance=nextMinimum−score, or0 at top Units, indexing, boundary conditions and exceptional cases are defined in the calculation rules above.
| Output field | Meaning | Value type |
|---|---|---|
| level | Level | string |
| distanceToNext | Distance to next | number |
{
"input": {
"score": 82,
"minimumScores": [
0,
60,
80
],
"levelLabels": [
"beginning",
"developing",
"mastered"
]
},
"output": {
"level": "mastered",
"distanceToNext": 0
}
}Limitations and assumptions
Labels and thresholds are supplied. The top-level zero distance is a placeholder because no next level exists, not evidence that a ceiling score was reached.
Numeric inputs must be finite. Follow the calculation-specific rules for overflow, underflow and exceptional cases. Lists are limited to 100,000 entries; the rules above may require smaller limits. Missing required fields, extra fields, wrong value types and violations of the calculation rules are input errors.
Alternative or Complementary methods
Use Readiness Tier Assignments: Assign differentiated activity tiers using current readiness scores. For a complementary task, use Mastery Retry Tracker: Classify student mastery, remaining retry eligibility, and exhausted attempts.
References
-
Mastery Scale Mapper — tool.io
Similar or alternative tools
- Readiness Tier Assignments
Assign differentiated activity tiers using current readiness scores.
- Mastery Retry Tracker
Classify student mastery, remaining retry eligibility, and exhausted attempts.