Rééchelonner une note

Lorsqu'un quiz, un partiel ou une grille change son total de points, le même score brut ne signifie plus la même chose sur la nouvelle échelle. Ce calculateur de rééchelonnement vers un nouveau maximum applique la proportion linéaire transparente : le score mis à l'échelle égale le score divisé par l'ancien maximum multiplié par le nouveau maximum, de sorte que les pourcentages restent constants tandis que les points affichés correspondent au plafond mis à jour. Enseignants, étudiants, conseillers et intégrations LMS utilisent la même arithmétique pure en ligne ou via l'API, sans tableurs, sans jetons de modèle et sans effets de réseau.

Comment fonctionne le rééchelonnement proportionnel des notes

Un score est toujours une paire de nombres : les points obtenus et le maximum par rapport auquel ils ont été mesurés. Mathématiquement, scaled_score égale score divisé par old_max, puis multiplié par new_max. De façon équivalente, calculez d'abord le pourcentage comme score sur old_max fois cent, puis multipliez ce pourcentage par new_max sur cent. La capacité renvoie toujours score, old_max, new_max, le résultat échelonné, le pourcentage, le ratio exact, la chaîne de formule, une courte étiquette du type 42/50 → 84/100, et un message lisible que vous pouvez afficher à côté d'une cellule du carnet.

Contrat d'entrée, validation et champs de réponse

Envoyez un objet JSON avec trois nombres obligatoires. score représente les points obtenus et doit être une valeur finie non négative ; les chaînes numériques sont acceptées, tandis que booléens, objets et chaînes vides sont rejetés. Les alias points, earned, value et marks résolvent le même champ pour les clients légers. old_max est le maximum d'origine et doit être strictement supérieur à zéro ; les alias incluent from_max, current_max, original_max et out_of. new_max est le maximum cible après rééchelonnement et doit aussi être strictement supérieur à zéro ; les alias incluent to_max, target_max et new_out_of. L'option decimals est un entier de zéro à six et vaut deux par défaut ; elle contrôle l'arrondi half-up de scaled_score et percentage, ainsi que le plancher de précision des entrées renvoyées. En cas de succès le corps renvoie score, old_max, new_max, scaled_score, percentage, ratio, formula rappelant scaled_score equals score over old_max times new_max, label comme chaîne compacte avant/après, decimals et message. Les scores au-dessus de old_max sont autorisés pour convertir le crédit supplémentaire ; un score zéro produit un résultat échelonné zéro. Champs manquants, valeurs non finies, old_max ou new_max non positifs, ou score négatif lèvent invalid_input et ne sont pas facturés. Associez le scaled_score numérique à votre propre table de lettres seulement si le syllabus la publie : ce endpoint n'invente jamais de notes littérales à partir de la seule proportion.

Où le rééchelonnement vers un nouveau maximum s'inscrit dans les flux réels

Les plugins LMS et les scripts d'export de notes appellent l'API lors de l'import de scores externes dont le maximum diffère de celui du cours de destination. Comme l'implémentation est un travail analytique parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant.