Rang percentile de classe
Un 85 dans une classe de 10 où 5 élèves ont moins, 2 autant et 3 plus se situe au 50e percentile. Collez les notes de la classe et une note pour voir la part de camarades en dessous et la part égale ou inférieure. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Score
- 85
- N
- 10
- En dessous
- 5
- Égaux
- 2
- Au-dessus
- 3
Un rang percentile de classe répond à la question que tout carnet de notes finit par poser : pour cette note d'élève, quelle part de la classe a obtenu un résultat strictement inférieur ? Les enseignants, les conseillers, les auteurs d'un LMS et les familles ne veulent pas d'un seuil de k-ième percentile ni d'une bande verbale ; ils veulent un rang calculé sur la liste réelle qu'ils ont sous les yeux. Les recettes de tableur oscillent entre formules exclusive, inclusive et de rang médian, et deux sections du même cours peuvent afficher des rangs différents pour la même marque si la liste de comparaison n'est pas figée. Ce calculateur prend une note de requête et une liste finie de notes de classe, compte combien de marques de la liste tombent strictement sous la requête et renvoie ce décompte en pourcentage de l'effectif. Sans réseau, sans modèle et sans hasard : vous fournissez la liste et la note, et le rang est reproductible pour chaque entrée valide.
Comment le rang percentile de classe se définit à partir de la liste
Le rang percentile de classe n'est pas la même statistique que le k-ième percentile d'un jeu de données. Le k-ième percentile dit quelle note occupe une position choisie sur une liste ordonnée ; le rang de classe répond à la question inverse de la salle : parmi les marques déjà présentes sur la liste, quel pourcentage se situe strictement sous la note de cet élève.
La formule exclusive utilisée ici est PR égal à B sur N fois cent, où N est la longueur de la liste scores que vous envoyez et B le nombre de valeurs strictement inférieures à la note consultée.
Les égalités n'enflent pas le rang exclusif : les camarades qui égalent la requête comptent dans equal, pas dans below, si bien qu'une marque unique en tête d'une classe de dix a B égal à neuf et un rang de quatre-vingt-dix, tandis qu'une note que quatre camarades ont aussi obtenue n'indique toujours que la part de ceux qui ont moins réussi.
Ce n'est pas la convention de rang médian qui accorde un demi-crédit aux égalités, ni un score z ni une lettre en courbe de Gauss ; ces outils partent d'une moyenne et d'un écart-type plutôt que d'une liste concrète. Vous décidez si la liste inclut l'élève consulté. Si la liste est la classe entière avec cet élève, N est l'effectif et une auto-coïncidence apparaît dans equal.
Si la liste est le reste, N est le nombre de camarades et le rang est la part des pairs plus bas. Les deux lectures sont valides ; le calculateur n'insère ni n'ôte de lui-même la note consultée. Les cas limites sont honnêtes : la marque unique la plus basse donne un rang de zéro, une note au-dessus de toutes celles de la liste donne cent, et une classe d'un avec note coincidente donne un rang exclusif de zéro et cent pour cent au-dessous ou égal.
Le moteur n'estime jamais une moyenne, n'interpole jamais entre statistiques d'ordre et ne projette jamais le rang sur des bandes bas, moyen ou élevé. Il compte, divise et renvoie les deux pourcentages plus les décomptes below, equal et above afin qu'un enseignant puisse montrer l'arithmétique au tableau.
Où un rang percentile de classe trouve son utilité
Les carnets de classe et les greffons LMS ont besoin d'un mapping documenté d'une marque brute plus une liste vers un rang 0–100, pour que le bulletin imprimé, le portail des familles et l'explication en permanence ne se contredisent pas sur le même élève. Les responsables qui comparent les sections veulent le chiffre exclusif de ceux qui ont moins réussi, plutôt que chaque enseignant invente une règle d'égalité différente dans son tableur personnel.
Les produits ed-tech qui stockent déjà des notes d'items peuvent attacher un percentile de classe à la bordure sans embarquer un second moteur statistique ni envoyer une liste vers un site tiers. Les sites de contenu qui visent rang percentile de classe ou percentile d'une note bénéficient d'un chemin gratuit dans le navigateur qui coïncide octet par octet avec l'automatisation payante sur la même bibliothèque analytique. Une validation en échec ne consomme pas le solde.
Associez ce point d'accès à un classifieur de bandes si vous voulez plus tard une étiquette verbale, et à un outil distinct de k-ième percentile si vous avez besoin d'un seuil plutôt que du rang d'une seule note.
Cas d’usage
Rang au carnet sur une liste publiée
Transformez une marque d'élève plus la liste de la section en rang percentile exclusif pour le bulletin et le LMS.
Explications en permanence et aux familles
Montrez les décomptes below, equal et above pour qu'une famille voie combien de camarades ont moins réussi qu'une marque donnée.
Questions fréquentes
Une égalité relève-t-elle le rang percentile ?
Non. Les camarades qui égalent la requête comptent dans equal, pas dans below.
La propre note de l'élève doit-elle figurer dans scores ?
Les deux lectures sont valides. Si la liste inclut cet élève, n est l'effectif et une auto-coïncidence apparaît dans equal. Si la liste est le reste, n est le nombre de camarades. Le calculateur n'insère ni n'ôte la note consultée.
Est-ce le même calcul qu'un k-ième percentile ou un rang médian ?
Non. Un k-ième percentile trouve un seuil sur une liste ordonnée. Le rang médian accorde un demi-crédit aux égalités. Cet outil indique la part exclusive de la classe qui a obtenu un résultat strictement inférieur.
Quelle différence entre le rang percentile et le pourcentage égal ou inférieur ?
Le rang percentile ne compte que les notes strictement plus basses, tandis que le second chiffre ajoute les égalités. Dans l'exemple, 5 élèves sur 10 ont moins, ce qui donne 50, et avec les 2 notes égales on passe à 70.
Faut-il la moyenne et l'écart-type de la classe ?
Non. Le rang se calcule directement à partir de la liste de notes que vous collez, sans supposer de moyenne, de dispersion ni de courbe en cloche. Il répond donc sur la classe réelle, sans estimation tirée d'un score z.
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
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/percentile-rank-class \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}'const res = await fetch("https://api.kit.forhosting.com/edu/percentile-rank-class", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/edu/percentile-rank-class",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/percentile-rank-class", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"score":85,"scores":[62,71,74,78,81,85,85,88,92,97]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/percentile-rank-class", 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
{
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.percentile_rank_class",
"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
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Limites
max_n | 10000 |
max_abs | 1000000000000000 |
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
Le même module analytique déterministe alimente l'outil gratuit du navigateur et le chemin API, ainsi un greffon de carnet et un contrôle en permanence n'entrent pas en contradiction.
Comment le rang percentile de classe se définit à partir de la liste
La réponse indique aussi percent_at_or_below, soit B plus E sur N fois cent, car les bulletins ont parfois besoin de ce compagnon inclusif.
Contrat d'entrée, champs de réponse et validation
Exemple : score soixante-quinze face à cinquante, soixante, soixante-dix, quatre-vingts, quatre-vingt-dix — une requête absente de la liste — produit below trois, equal zéro, above deux et un rang de soixante. Envoyez par POST un corps JSON avec deux champs obligatoires : score, un nombre fini sur la même échelle que la liste, et scores, une liste non vide de marques de classe finies. score accepte les alias value, mark, raw et x. scores accepte class_scores, roster, data et values, et une chaîne de nombres séparés par des virgules ou des espaces est aussi acceptée lorsqu'un formulaire envoie du texte brut plutôt qu'un tableau JSON. Chaque élément est lu comme un décimal fini ; les signes initiaux facultatifs et la notation scientifique sont admis, tandis que les jetons vides, les booléens, les objets, Infinity et NaN échouent avec invalid_input pour qu'une mauvaise cellule ne devienne jamais un zéro silencieux. Le moteur impose un maximum dur de dix mille marques dans la liste et un plafond de magnitude par valeur, afin que mémoire et latence restent dans un budget prévisible sur le chemin gratuit du navigateur et sur le Worker. L'absence de score, l'absence de scores, une liste vide ou une liste trop longue échouent avec invalid_input et ne sont pas facturées. En cas de succès le corps répète score, renvoie n comme longueur de la liste, below, equal et above comme le partage en trois de cette liste, percentile_rank comme cent fois below sur n, percent_at_or_below comme cent fois below plus equal sur n, class_min et class_max comme les extrêmes observés, method comme exclusive_below, une courte chaîne formula, le plafond publié max_n et un message d'une ligne pour l'interface. Exemple : score 85 face à la liste de dix marques soixante-deux, soixante et onze, soixante-quatorze, soixante-dix-huit, quatre-vingt-un, quatre-vingt-cinq, quatre-vingt-cinq, quatre-vingt-huit, quatre-vingt-douze, quatre-vingt-dix-sept produit below cinq, equal deux, above trois, percentile_rank cinquante et percent_at_or_below soixante-dix. Les champs facultatifs sont omis plutôt que null, et tous les noms sont du snake_case sûr pour le DOM dans les widgets et les SDK.
Où un rang percentile de classe trouve son utilité
Les centres de tutorat et les bureaux de réussite expliquent aux familles pourquoi un quatre-vingt-deux se situe près du milieu d'une épreuve difficile et près du bas d'une épreuve facile ; une API déterministe permet à ces échanges de partir des mêmes décomptes. Comme l'implémentation est parse de niveau A, chaque appel réussi coûte le prix de base publié $0.002 sans jetons de modèle et sans réseau sortant. Gardez les charges petites, figez percentile_rank avec below et n dans les tests, et vous obtenez des rangs de classe reproductibles pour greffons de carnet, scripts de scolarité et rapports aux familles sans dresser une pile psychométrique complète vous-même.
Cas d'intégration
Automatisation LMS et de scolarité
Attachez un percentile_rank stable pour machine aux listes stockées, avec la même formule exclusive que l'outil gratuit du navigateur.
Questions techniques
Comment calcule-t-on le rang percentile de classe ?
Envoyez score et la liste scores de la classe. L'API compte les marques strictement sous la note, divise par n et multiplie par 100. Cette part exclusive est percentile_rank.
Combien coûte le calculateur de rang percentile de classe ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.