Description
Calculate a grade fraction under an explicit extra-credit denominator policy, preserving undefined zero support.
Scoring rules combine points, item weights, boundaries and policies for omission, extra credit or missing items. A computed mark is meaningful only under those explicit rules; applying a rule does not establish its fairness or official status.
Calculate a grade fraction under an explicit extra-credit denominator policy, preserving undefined zero support.
When to use this tool
Use Education: Grade Extra Credit Denominator Policy when checking one supplied scoring contribution or policy boundary.
How to use the tool and how it works
- Enter earned, ordinaryMaximum, extraEarned, extraMaximum, policy. Use the units and conventions below.
- Run the tool. Correct any format, range, or cross-field input error before interpreting the output.
- Read result. Expand result to inspect the returned fields.
Require nonnegative ordinary and extra maxima and earned values within their respective maxima. denominator is ordinaryMaximum, adding extraMaximum only for include-extra-maximum policy. gradeFraction = (earned+extraEarned)/denominator, or zero with defined = false for zero denominator.1
| Input field | Meaning and units | Accepted input |
|---|---|---|
| earned | Earned | Required. Finite number. |
| ordinaryMaximum | Ordinary Maximum | Required. Finite number. |
| extraEarned | Extra Earned | Required. Finite number. |
| extraMaximum | Extra Maximum | Required. Finite number. |
| policy | Policy | Required. Text; one of "exclude-extra-maximum", "include-extra-maximum". Implementation limit: 8192 Unicode code points and 16384 UTF-16 code units. |
| Output field | Interpretation | Returned shape |
|---|---|---|
| result | Object containing the named calculated members below. | Required. Object. |
| result.denominator | Denominator | Calculated result member: number. |
| result.gradeFraction | Earned ordinary-plus-extra points divided by the selected maximum basis; can exceed one. | Calculated result member: number. |
| result.defined | Whether the stated denominator has positive support; read this before interpreting a zero placeholder. | Calculated result member: boolean. |
{
"input": {
"earned": 8,
"ordinaryMaximum": 10,
"extraEarned": 2,
"extraMaximum": 2,
"policy": "exclude-extra-maximum"
},
"output": {
"result": {
"denominator": 10,
"gradeFraction": 1,
"defined": true
}
}
}Limitations and assumptions
- Excluding extra maximum can produce a fraction above one. This applies a supplied grading policy and does not round, cap or establish an official grade.
- Outputs are nested inside result. Inputs must satisfy both the field types and the cross-field conditions above. Invalid input causes an error; a successful false flag or documented placeholder is a different result.
- Numeric calculations use binary floating point unless exact decimal-integer arithmetic is explicitly stated. No hidden measurement tolerance or decimal rounding is added; nonfinite or out-of-contract results are rejected. Numeric signed-zero results are exported as zero.
Alternative or Complementary methods
Use the complete approved rubric and score record for an official outcome, and examine measurement quality separately.
References
Similar or alternative tools
- Grade Boundary Needed Next Item Mark
needed = max(0,targetFraction*maximumFinalPoints-currentPoints); possible tests the unclamped deficit <= nextItemMaximum.
- Credit Component Rounding Gap
Round each value as Math.round(value/quantum)*quantum and sum for sumOfRounded; separately round the unrounded total for roundedSum; gap is their difference.