Note pondérée sur un total

Saisissez chaque catégorie avec les points obtenus, les points possibles et le poids, puis fixez out_of (par exemple 20 pour une note classique sur 20). Le moteur normalise chaque ligne en un ratio, moyenne ces ratios par poids, multiplie par votre total et renvoie mark, mark_display et le détail par catégorie.

Ce que signifie un score pondéré sur un total

Les mathématiques sont les mêmes partout : chaque catégorie contribue par score divisé par max_score, ce ratio est multiplié par le poids de la catégorie, ces produits sont additionnés, la somme est divisée par le poids total, et le résultat est multiplié par out_of. Exemple : devoirs quatre-vingt-cinq sur cent au poids trente, partiel seize sur vingt au poids trente, final quarante-deux sur cinquante au poids quarante, out_of vingt. Les personnes qui cherchent une note pondérée sur un total, une note sur 20 ou une marque par catégories sur échelle fixe veulent cette conversion comme résultat principal, avec une chaîne mark_display claire à coller dans un rapport ou un message aux parents. Comme chaque catégorie est normalisée par son propre max_score, vous pouvez mélanger un quiz noté sur dix et un projet noté sur cent sans forcer tout dans un même bassin de points bruts.

Contrat d’entrée, arrondi et comportement d’erreur

Le label optionnel nomme la catégorie dans le détail. Les poids n’ont pas besoin de sommer à cent : le moteur renormalise automatiquement, vous pouvez donc saisir trente, trente, quarante ou 0.3, 0.3, 0.4 avec les mêmes ratios et la même note. Envoyez en POST un corps JSON avec deux champs obligatoires. categories est un tableau non vide d’au plus cinquante objets ; chaque objet doit inclure score (points finis non négatifs obtenus), max_score (points possibles strictement positifs) et weight (poids relatif strictement positif). Les alias items, rows et components se mappent sur categories. out_of est le total cible strictement positif de la note combinée ; les alias total, scale et max_mark sont acceptés. decimals optionnel est un entier de zéro à six inclus et vaut deux par défaut ; l’alias precision est accepté. En cas de succès la réponse inclut mark (arrondi half-up à decimals), out_of, mark_display tel que 16.62 / 20, weighted_percent, weighted_ratio, total_weight, category_count, decimals, un tableau categories avec ratio, weight_share et contribution_to_mark par ligne, plus formula et method weighted_category_scale pour des clients stables. L’absence de categories ou out_of, les tableaux vides, les non-objets dans la liste, les scores négatifs, max_score ou weight non positifs, out_of non positif et decimals hors de zéro à six échouent avec invalid_input et des messages qui nomment le champ ; les échecs de validation ne sont pas facturés.

Où une API de note sur N pondérée apporte de la valeur

Les enseignants qui notent avec des instruments mixtes mais rapportent sur une échelle institutionnelle fixe ont besoin d’un oracle en lequel élèves, parents et tableurs peuvent tous avoir confiance. Les tuteurs peuvent parcourir avec l’apprenant chaque contribution de catégorie sans inventer une arithmétique sur mesure à chaque séance. Une validation échouée ne consomme pas le solde. Les bureaux d’orientation près des partiels répondent des dizaines de fois combien cela fait sur vingt après pondération ; un endpoint déterministe partagé supprime la dérive des bots Discord et les erreurs de calculatrice à la main. Comme l’implémentation est parse de niveau A pur, 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 petites, figez mark et mark_display dans les tests, et vous obtenez des notes mises à l’échelle reproductibles pour démos de classe, workers en bordure et calculateurs de programme sans monter votre propre infrastructure de notation.