ForHosting KIT · Éducation

Calculateur d'étendue des notes

Pour cinq notes dont la plus haute est 91 et la plus basse 68, l'étendue vaut 23 : la plus haute moins la plus basse. Collez les notes d'une classe après la correction et obtenez la dispersion en une étape, sur n'importe quelle échelle. Gratuit dans votre navigateur.

Gratuit
Fonctionne dans votre navigateur
Sans inscription
Vos données restent sur votre appareil

Lancer gratuitement Voir l’API

Utilisez-le depuis WebAPIE-mailTelegramApp bientôt

Exemple résolu

Si vous saisissez

Notes: 72, 85, 91, 68, 77

Vous obtenez

Quantité: 5
Le plus élevé: 91
Le plus bas: 68
Image: 23

Lorsqu'un quiz, un partiel ou un examen final est noté, les enseignants et assistants ont souvent besoin d'un seul chiffre clair sur l'écart des résultats des élèves — pas d'une suite statistique complète. Ce calculateur d'étendue des notes prend une liste de notes, trouve la plus haute et la plus basse, et renvoie l'étendue comme maximum moins minimum, afin que vous résumiez la dispersion en une réponse déterministe. Utilisez-le lorsque l'intention de recherche est la dispersion des notes elle-même — réunions avec les familles, comparaisons de sections ou discussions de courbe — sans calculer moyennes, médianes ni bandes de lettres que vous n'avez pas demandées.

Ce que signifie l'étendue des notes et comment elle se calcule

L'étendue d'un ensemble de notes est la mesure de dispersion la plus simple en classe : identifiez la valeur la plus haute de la liste, la plus basse, et soustrayez le minimum du maximum. Cette seule différence répond à « quelle a été l'amplitude de la distribution des résultats ? » sans quartiles ordonnés, formules de variance ni manuel de statistiques.

Une petite étendue signifie une performance resserrée — la plupart des notes près de la même bande —, tandis qu'une grande étendue signifie des résultats étalés et peut motiver une analyse d'items, un soutien différencié ou une discussion transparente sur les effets plafond et plancher. Ce calculateur reste délibérément sur ce résumé orienté enseignement : il renvoie la liste de notes nettoyée, le nombre d'entrées, le maximum, le minimum et l'étendue, plus une courte chaîne de formule et une étiquette de méthode pour les journaux d'audit.

Il n'invente ni moyenne de classe, ni écart type, ni notes lettres, ni mélanges pondérés par catégorie ; ce sont d'autres intentions de recherche et d'autres outils. Les notes peuvent reposer sur n'importe quelle échelle numérique finie — pourcent 0–100, points sur cinquante, totaux de rubrique — car l'arithmétique du max moins min ne dépend pas de l'échelle choisie. Lorsque toutes les notes sont identiques, l'étendue est zéro et le maximum égale le minimum.

Lorsque la liste n'a qu'une note, maximum et minimum coïncident et l'étendue est zéro, ce qui est mathématiquement correct même si peu informatif. Les marques en double sont autorisées et ne changent pas la définition ; seuls les extrêmes comptent pour l'étendue. Les valeurs négatives ou au-dessus de cent sont acceptées lorsque votre échelle les utilise, de sorte que bonus de courbe et pénalités produisent encore une dispersion fidèle.

Quand l'étendue d'un contrôle vous est utile

Les enseignants collent les notes de section après un contrôle d'unité pour publier le haut, le bas et l'étendue en toute transparence, sans ouvrir une feuille complète de formules du carnet. Les centres de tutorat et programmes extrascolaires suivent les étendues de quiz semaine après semaine avec un oracle déterministe qui ne dérive jamais entre la vérification gratuite du navigateur et le rapport automatisé.

Les plugins LMS et portails de devoirs appellent le même module pur pour afficher la « dispersion des notes jusqu'ici » à côté des marques individuelles sans livrer une bibliothèque statistique à chaque client. Lorsque vous avez aussi besoin de la moyenne de classe dans la même requête, utilisez un outil de moyenne dédié ; cette landing reste centrée sur l'intention de recherche max-moins-min afin que la page SEO et le contrat de réponse restent honnêtes sur ce qu'ils livrent.

Cas d’usage

Dispersion post-examen pour les enseignants

Collez les notes de la section après correction pour obtenir maximum, minimum et étendue pour le tableau, la note LMS ou la réunion avec les familles en une seule étape.

Questions fréquentes

Comment calculer l'étendue des notes ?

Envoyez un tableau grades non vide de nombres finis.

Qu'est-ce que l'étendue d'un ensemble de notes ?

L'étendue est la note la plus haute moins la plus basse de votre liste. Une étendue plus grande signifie une plus grande dispersion des résultats des élèves.

Les notes doivent-elles être entre 0 et 100 ?

Non. Tout nombre fini dans la magnitude prise en charge est accepté, donc échelles en pourcent, examens en points et totaux de rubrique fonctionnent.

Que se passe-t-il si j'envoie une liste vide de notes ?

Une étendue exige au moins une note finie ; les listes vides ne sont pas facturées.

L'outil donne-t-il aussi la moyenne de la classe ?

Non. Il indique seulement le nombre de notes, la plus haute, la plus basse et l'étendue entre les deux. La moyenne, la médiane et les notes en lettres relèvent d'autres calculateurs.

Outils associés

Pour les développeurs — accès API

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.

Endpoint

POSThttps://api.kit.forhosting.com/edu/range-of-grades

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é.

Appeler depuis votre stack

curl -X POST https://api.kit.forhosting.com/edu/range-of-grades \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"grades":[72,85,91,68,77]}'

const res = await fetch("https://api.kit.forhosting.com/edu/range-of-grades", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "grades": [
      72,
      85,
      91,
      68,
      77
    ]
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/range-of-grades",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "grades": [
        72,
        85,
        91,
        68,
        77
    ]
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/range-of-grades", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"grades":[72,85,91,68,77]}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"grades":[72,85,91,68,77]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/range-of-grades", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)

Exemple de requête

{
  "grades": [
    72,
    85,
    91,
    68,
    77
  ]
}

Exemple de réponse

{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "edu.range_of_grades",
  "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.

Tarifs

par requête$0.002

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

Erreurs

HTTP	Code	Signification
`401`	`unauthorized`	Clé API absente ou invalide : vérifiez l’en-tête Authorization.
`402`	`insufficient_balance`	Solde insuffisant : rechargez votre compte pour lancer cette tâche.
`404`	`unknown_type`	Type de tâche inconnu : vérifiez le champ type de votre requête.
`429`	`rate_limited`	Trop de requêtes : ralentissez la cadence, puis réessayez.

Notes techniques

Collez les marques depuis un export du carnet, une liste de classe ou le presse-papiers ; le moteur de parse pur valide chaque entrée comme nombre fini, rejette les listes vides et renvoie un contrat JSON stable que vous pouvez figer dans des tests ou intégrer dans un plugin LMS.

Ce que signifie l'étendue des notes et comment elle se calcule

Les listes vides sont invalides : il n'y a pas d'étendue de personne, et l'API échoue avec invalid_input au lieu de renvoyer un zéro creux qui pourrait tromper un tableau de bord.

Contrat d'entrée, forme de la réponse et règles de validation

Il n'est pas exigé que les notes soient entre zéro et cent : l'outil accepte toute magnitude finie dans une borne sûre, de sorte que les examens en points et rubriques échelonnées fonctionnent sans prétraitement. Gardez des listes modestes pour les sections de classe ; le plafond de cinq cents est une garde-fou contre les déversements accidentels, pas une cible d'usage quotidien. Envoyez en POST un objet JSON avec le champ obligatoire grades : un tableau non vide de nombres finis, au moins une entrée et au plus cinq cents. Les alias acceptés pour la même liste incluent scores, marks, values, numbers et exam_scores afin que les exports de carnet avec des noms de colonnes différents se mappent encore correctement. Chaque élément peut être un nombre JSON ou une chaîne numérique ; les valeurs non finies, chaînes vides et jetons non numériques échouent avec invalid_input en nommant le mauvais index. Vous pouvez aussi passer grades comme une seule chaîne séparée par des virgules ou des espaces lorsqu'un formulaire texte est plus pratique qu'un tableau JSON. En cas de succès le corps renvoie le tableau grades nettoyé, count (n), highest, lowest et range (maximum moins minimum), plus une courte chaîne formula range equals highest minus lowest et l'étiquette method range_of_grades pour les clients qui journalisent quel endpoint a produit la ligne. Grades manquants, tableau vide, plus de cinq cents entrées ou un corps qui n'est pas un objet lèvent invalid_input et ne sont pas facturés. Associez ce contrat à vos propres bandes de lettres, moyennes ou courbes si vous avez besoin d'une sortie catégorielle ou de tendance centrale ; cet endpoint ne rapporte que la dispersion descriptive des notes.

Où une API d'étendue des notes apporte une vraie valeur

Les coordinateurs de département envoient par lots les sections parallèles via l'API pour comparer les dispersions avant de décider si une courbe commune est équitable entre salles ayant enseigné le même examen. Comme l'implémentation est parse de niveau A pure, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle ni réseau sortant ; une validation échouée ne consomme pas le solde.

Cas d'intégration

Comparaison de dispersion multi-sections

Envoyez les notes de chaque section parallèle via l'API et comparez les étendues avant de choisir une courbe commune ou une politique de rattrapage.

Tableaux de bord LMS et tutorat

Affichez la dispersion des notes en direct à côté des marques individuelles avec un endpoint de parse déterministe qui correspond au widget gratuit du navigateur.

Questions techniques

Combien coûte le calculateur d'étendue des notes ?

L'outil navigateur est gratuit. Les requêtes API utilisent le solde prépayé KIT à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.

Consulter la documentation complète du KIT →

Lancer gratuitement

Exemple résolu

Ce que signifie l'étendue des notes et comment elle se calcule

Quand l'étendue d'un contrôle vous est utile

Cas d’usage

Dispersion post-examen pour les enseignants

Questions fréquentes

Outils associés

Pour les développeurs — accès API

Endpoint

Appeler depuis votre stack

Exemple de requête

Exemple de réponse

Tarifs

Erreurs

Notes techniques

Ce que signifie l'étendue des notes et comment elle se calcule

Contrat d'entrée, forme de la réponse et règles de validation

Où une API d'étendue des notes apporte une vraie valeur

Cas d'intégration

Comparaison de dispersion multi-sections

Tableaux de bord LMS et tutorat

Questions techniques

merci