Calculateur de courbe linéaire

Ce calculateur de courbe linéaire de notes accepte un tableau de scores bruts et un bonus de points non négatif, calcule curved_i égal au minimum entre cent et raw_i plus points pour chaque étudiant, et renvoie la liste courbée complète, le nombre de scores qui ont atteint le plafond, ainsi que les moyennes de classe avant et après l’ajustement. La même arithmétique pure alimente l’outil gratuit du navigateur et le chemin API, de sorte que les scripts de notation et les démonstrations de devoirs restent stables octet par octet. Scores manquants, tableaux vides, points négatifs et valeurs non finies échouent avec invalid_input au lieu d’inventer une courbe.

Ce qu’est une courbe linéaire à points et comment fonctionne le plafond à 100 %

Ce point d’accès encode directement cette convention de salle de classe : curved est égal à min(100, raw plus points) pour chaque entrée du tableau scores, dans le même ordre que vous les avez envoyées. Ici, les seuls paramètres libres sont la liste des scores bruts en pourcentage et la constante non négative de points à ajouter. Les scores peuvent légèrement sortir de zéro à cent si le carnet source utilise des bonus ou des données incomplètes ; la courbe ajoute quand même des points et ne plafonne que le côté supérieur à cent. Les bonus négatifs sont rejetés car cette page produit et le contrat API décrivent une courbe linéaire d’ajout de points, non une déduction générale. Zéro point est autorisé et agit comme une pure validation qui rapporte encore les moyennes et un capped_count de zéro, sauf si un score brut dépassait déjà cent et est plafonné par la même règle de maximum.

Contrat d’entrée, forme de la réponse et comportement d’erreur

Associez les listes à vos propres bandes de lettres si vous avez besoin d’étiquettes A–F ; ce point d’accès n’applique que la courbe linéaire numérique et n’émet ni lettres, ni poids, ni moyennes par catégorie. Envoyez en POST un corps JSON avec deux champs obligatoires : scores, un tableau non vide de nombres finis (une à cinq cents entrées), et points, un nombre fini non négatif de points bonus à ajouter à chaque score brut. Chaque élément de score et le champ points peuvent arriver comme nombre JSON ou comme chaîne numérique ; les alias raw_scores, grades et values correspondent à scores, tandis que points_to_add, bonus, curve_points et add correspondent à points. Scores manquants, valeur scores non tableau, liste vide, plus de cinq cents entrées, points manquants, points négatifs, NaN, Infinity et éléments non numériques échouent avec invalid_input et des messages qui nomment le champ ou l’index. Ces échecs de validation ne sont pas facturés. En cas de succès, le corps renvoie le tableau scores nettoyé et la valeur points, curved_scores dans le même ordre, max_score à cent, count comme taille de la classe, capped_count comme le nombre d’étudiants exactement au plafond parce que raw plus points dépassait cent, ainsi que mean_raw et mean_curved comme moyennes arithmétiques pour une comparaison rapide avant/après. La chaîne formula réaffirme que curved égale min(100, raw plus points) et method est linear_grade_curve. Exemple : scores soixante-douze, quatre-vingt-cinq, quatre-vingt-onze, soixante-huit avec cinq points donnent soixante-dix-sept, quatre-vingt-dix, quatre-vingt-seize, soixante-treize, sans plafonnement si aucun n’a dépassé cent ; un brut de quatre-vingt-dix-huit avec cinq points devient cent et incrémente capped_count.

Où une API de courbe linéaire de notes apporte de la valeur

Les systèmes de gestion de l’apprentissage et les pipelines d’export de notes ont besoin d’un oracle déterministe afin que chaque client—web, mobile ou import CSV par lots—s’accorde sur les pourcentages courbés pour la même liste brute et le même bonus. Les sites de contenu peuvent démontrer une courbe équitable sans livrer des macros de tableur qui cassent selon le séparateur décimal local. Une validation échouée ne consomme pas de solde. Les assistants peuvent coller les scores d’une section, essayer deux ou trois valeurs de points et choisir une courbe qui relève la moyenne sans créer un amas au-dessus de cent que le secrétariat des scolarités n’acceptera pas. Comme l’implémentation est pure 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. Gardez les requêtes sous la limite de cinq cents scores, figez curved_scores et les moyennes dans les tests, et vous obtenez des courbes linéaires reproductibles pour plugins LMS, démonstrations de permanence et workers en périphérie sans déployer votre propre infrastructure de notation.