ForHosting KIT · Outils pour développeurs

Calculateur de moyenne pondérée des notes par catégorie

Ce calculateur combine les notes des catégories selon leur importance relative. Saisissez une note en pourcentage et un poids pour les devoirs, projets, examens, la participation ou toute autre catégorie.

● BetaGratuit · dans votre navigateur
Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Il multiplie chaque note par son poids, additionne les produits, puis divise cette somme par le total des poids. Comme les poids sont automatiquement normalisés, leur total peut être 100, 1, 20 ou une autre valeur positive. Le résultat comprend la moyenne finale et le détail des contributions pour contrôler une formule, expliquer une note ou intégrer le calcul à un processus pédagogique.

Saisissez des notes et des poids cohérents

Créez une ligne pour chaque catégorie qui contribue à la note globale. Donnez-lui un nom explicite, saisissez la note obtenue sous forme de pourcentage compris entre 0 et 100, puis indiquez un poids non négatif. Un cours peut, par exemple, attribuer 20 aux devoirs, 35 aux projets et 45 aux examens. Ces valeurs totalisent 100, mais ce n’est pas obligatoire. Vous pouvez utiliser 2, 3.5 et 4.5 et obtenir la même moyenne, car seule la proportion entre les poids compte. Les valeurs décimales 0.2, 0.35 et 0.45 conviennent également. Employez une seule échelle dans une requête : mélanger 20 et 0.35 créerait probablement une proportion involontaire. Les notes doivent déjà être des pourcentages ; convertissez donc 42 points sur 50 en 84. Une catégorie de poids nul peut rester visible sans modifier la moyenne. Au moins un poids doit être positif et chaque requête accepte jusqu’à 100 catégories.

Comprenez la formule de moyenne pondérée

Le calcul suit la moyenne pondérée classique : chaque note est multipliée par son poids, tous les produits sont additionnés, puis la somme pondérée est divisée par le total des poids. Si les devoirs valent 88 avec un poids de 20, les projets 94 avec 35 et les examens 81 avec 45, les produits sont cumulés avant la division. Une catégorie plus fortement pondérée influence donc davantage le résultat. La réponse fournit la somme pondérée et le poids total afin que vous puissiez reproduire la formule. Elle indique aussi le poids normalisé de chaque catégorie sous forme de part décimale et sa contribution en points. Les contributions correspondent à la moyenne affichée, à de faibles écarts d’arrondi près à la sixième décimale. Les poids ne sont jamais forcés à totaliser 100 : la division par leur total réel assure déjà la normalisation. Les nombres invalides, poids négatifs, notes hors limites, noms vides et totaux nuls provoquent une erreur plutôt qu’une note trompeuse.

Interprétez et contrôlez le résultat

Utilisez weighted_average comme pourcentage combiné des catégories transmises. La liste conserve l’ordre initial et ajoute normalized_weight et weighted_contribution, ce qui montre précisément l’effet de chaque ligne. Ce détail aide à expliquer pourquoi une excellente note de devoirs n’a pas compensé un examen plus faible, ou à vérifier qu’une plateforme pédagogique applique correctement le barème du cours. Le calculateur n’attribue pas de lettre, ne courbe pas les résultats, ne retire pas la plus mauvaise note, ne remplace pas les travaux manquants et n’impose pas un total de 100. Ces choix relèvent du règlement d’évaluation. Si les poids couvrent seulement les catégories terminées, décidez s’il faut normaliser sur le travail achevé ou représenter les catégories restantes par des zéros ; les deux méthodes sont mathématiquement valides mais donnent des résultats différents. L’algorithme est déterministe, n’utilise aucun service réseau et arrondit les champs numériques à six décimales. Une même entrée valide produit donc le même résultat structuré dans le navigateur et via l’API.

Vérifier la note actuelle d’un cours

Combinez devoirs, contrôles, projets et examens selon les poids par catégorie publiés dans le programme.

Contrôler les calculs d’un carnet de notes

Comparez le résultat d’une plateforme avec la somme pondérée, le poids total et le détail des contributions.

Automatiser les rapports pédagogiques

Calculez des moyennes pondérées cohérentes sans maintenir une formule de tableur pour chaque élève.

Quel est le prix d’une requête API ?

Chaque requête API coûte $0.002. Le calculateur de niveau A fonctionne aussi dans le navigateur.

Les poids doivent-ils totaliser 100 ?

Non. Toute échelle cohérente et non négative convient, car la somme pondérée est divisée par le poids total réel.

Puis-je employer des poids décimaux ?

Oui. Les valeurs 0.2, 0.35 et 0.45 donnent la même moyenne que 20, 35 et 45.

Que devient une catégorie de poids nul ?

Elle reste dans le détail mais ne contribue pas à la moyenne. Au moins un poids doit être positif.

Le calculateur attribue-t-il une lettre ?

Non. Il renvoie uniquement le pourcentage pondéré, car les seuils varient selon les établissements et les cours.

Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.

POSThttps://api.kit.forhosting.com/edu/weighted-grade-average

Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.

curl -X POST https://api.kit.forhosting.com/edu/weighted-grade-average \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"categories":[{"name":"Homework","score":88,"weight":20},{"name":"Projects","score":94,"weight":35},{"name":"Exams","score":81,"weight":45}]}'
{
  "categories": [
    {
      "name": "Homework",
      "score": 88,
      "weight": 20
    },
    {
      "name": "Projects",
      "score": 94,
      "weight": 35
    },
    {
      "name": "Exams",
      "score": 81,
      "weight": 45
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.weighted_grade_average",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.

par requête$0.002

Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.

HTTPCodeSignification
401unauthorizedClé API absente ou invalide : vérifiez l’en-tête Authorization.
402insufficient_balanceSolde insuffisant : rechargez votre compte pour lancer cette tâche.
404unknown_typeType de tâche inconnu : vérifiez le champ type de votre requête.
429rate_limitedTrop de requêtes : ralentissez la cadence, puis réessayez.

Consulter la documentation complète du KIT →