Klassen-Prozentrang
Eine Note von 85 in einer Klasse mit 10 Personen, von denen 5 schlechter, 2 gleich und 3 besser abschnitten, liegt beim Prozentrang 50. Fügen Sie die Klassennoten und eine Note ein und sehen Sie den Anteil darunter sowie gleich oder darunter. Kostenlos in Ihrem Browser.
- Kostenlos
- Läuft in Ihrem Browser
- Ohne Anmeldung
- Ihre Daten bleiben auf Ihrem Gerät
Im Browser ausführen – kostenlos
Rechenbeispiel
- Punktzahl
- 85
- N
- 10
- Darunter
- 5
- Gleich
- 2
- Darüber
- 3
Ein Klassen-Prozentrang beantwortet die Frage, die jedes Notenbuch irgendwann stellt: Welcher Anteil der Klasse hat bei dieser Note ein streng niedrigeres Ergebnis erzielt? Lehrkräfte, Beratung, LMS-Autorinnen und Familien wollen keinen k-ten Perzentil-Schnitt und kein Wortband; sie wollen einen Rang, der aus der konkreten Liste vor ihnen berechnet wird. Tabellenrezepte schwanken zwischen exklusiver, inklusiver und Mittelrang-Formel, und zwei Kurse desselben Fachs können für dieselbe Marke verschiedene Ränge nennen, wenn die Vergleichsliste nicht festliegt. Dieser Rechner nimmt eine Abfragenote und eine endliche Liste von Klassennoten, zählt, wie viele Listenwerte streng unter der Abfrage liegen, und liefert diese Zahl als Prozent der Klassengröße. Kein Netz, kein Modell und kein Zufall: Sie liefern Liste und Note, und der Rang ist für jede gültige Eingabe reproduzierbar.
Wie ein Klassen-Prozentrang aus der Liste definiert wird
Der Klassen-Prozentrang ist nicht dieselbe Statistik wie das k-te Perzentil eines Datensatzes. Das k-te Perzentil sagt, welche Note an einer gewählten Stelle einer geordneten Liste sitzt; der Klassenrang beantwortet die umgekehrte Unterrichtsfrage: Von den Marken, die bereits auf der Liste stehen, welcher Anteil liegt streng unter der Note dieses Schülers. Die hier verwendete exklusive Formel lautet PR gleich B durch N mal hundert, wobei N die Länge der scores-Liste ist, die Sie senden, und B die Anzahl der Werte streng kleiner als die abgefragte Note.
Gleichstände blähen den exklusiven Rang nicht auf: Mitschülerinnen, die die Abfrage treffen, zählen in equal, nicht in below, sodass eine einzigartige Spitzenmarke in einer Klasse von zehn B gleich neun und einen Rang von neunzig hat, während eine Note, die vier Mitschüler ebenfalls erreicht haben, weiterhin nur den Anteil mit niedrigerem Ergebnis nennt. Sie entscheiden, ob die Liste die abgefragte Person enthält. Ist die Liste die volle Klasse einschließlich dieser Person, ist N die Klassengröße und ein Selbsttreffer erscheint in equal.
Ist die Liste alle anderen, ist N die Zahl der Mitschüler und der Rang der Anteil der Peers mit niedrigerem Ergebnis. Beide Lesarten gelten; der Rechner fügt die Abfragenote nicht selbst ein und streicht sie nicht. Grenzfälle sind ehrlich: die niedrigste einzigartige Marke ergibt Rang null, eine Note über jeder Listenmarke ergibt hundert, und eine Klasse von eins mit passender Note ergibt exklusiven Rang null und hundert Prozent auf oder unter der Marke.
Die Engine schätzt niemals einen Mittelwert, interpoliert niemals zwischen Ordnungsstatistiken und legt den Rang niemals auf Bänder niedrig, mittel oder hoch. Sie zählt, teilt und liefert die beiden Prozente plus die Zähler below, equal und above, damit eine Lehrkraft die Rechnung an der Tafel zeigen kann.
Wo ein Klassen-Prozentrang seinen Nutzen hat
Klassen-Notenbücher und LMS-Plugins brauchen eine dokumentierte Abbildung von Rohnote plus Liste auf einen Rang 0–100, damit der gedruckte Bericht, das Familienportal und die Sprechstundenerklärung sich bei derselben Person nicht widersprechen. Fachleitungen, die Kurse vergleichen, wollen die exklusive Zahl derjenigen mit niedrigerem Ergebnis, nicht dass jede Lehrkraft in der persönlichen Tabelle eine andere Gleichstandsregel erfindet. Ed-Tech-Produkte, die bereits Item-Noten speichern, können am Rand einen Klassenperzentil anhängen, ohne eine zweite Statistik-Engine mitzuliefern oder eine Liste auf eine Drittseite zu laden.
Inhaltssites, die um Klassen-Prozentrang oder Prozentrang einer Note werben, gewinnen einen kostenlosen Browserpfad, der Byte für Byte mit der bezahlten Automatisierung auf derselben Analysbibliothek übereinstimmt. Fehlgeschlagene Prüfung wird nicht berechnet. Koppeln Sie diesen Endpunkt mit einem Bandklassifikator, wenn Sie später ein Wortlabel wollen, und mit einem getrennten k-ten-Perzentil-Werkzeug, wenn Sie einen Schnitt statt des Rangs einer einzelnen Note brauchen.
Anwendungsfälle
Notenbuchrang zu einer veröffentlichten Liste
Machen Sie aus einer Schülernote plus der Kursliste den exklusiven Prozentrang für Zeugnis und LMS.
Sprechstunden- und Familienerklärungen
Zeigen Sie die Zähler below, equal und above, damit eine Familie sieht, wie viele Mitschülerinnen unter einer gegebenen Marke lagen.
Häufige Fragen
Hebt ein Gleichstand den Prozentrang an?
Nein. Mitschülerinnen, die die Abfrage treffen, zählen in equal, nicht in below.
Soll die eigene Note der Person in der scores-Liste stehen?
Beide Wege gelten. Enthält die Liste diese Person, ist n die Klassengröße und ein Selbsttreffer erscheint in equal. Ist die Liste alle anderen, ist n die Zahl der Mitschüler. Der Rechner fügt die Abfragenote nicht ein und streicht sie nicht.
Ist das dasselbe wie ein k-tes Perzentil oder ein Mittelrang?
Nein. Ein k-tes Perzentil findet einen Schnitt auf einer geordneten Liste. Mittelrang gibt Gleichständen einen halben Kredit. Dieses Werkzeug nennt den exklusiven Unterrichtsanteil mit streng niedrigerem Ergebnis.
Was unterscheidet den Prozentrang vom Anteil gleich oder darunter?
Der Prozentrang zählt nur Noten, die echt niedriger sind, der zweite Wert rechnet die Gleichstände hinzu. Im Beispiel lagen 5 von 10 darunter, das ergibt 50, und mit den 2 gleichen Noten werden es 70.
Brauche ich Mittelwert und Standardabweichung der Klasse?
Nein. Der Rang ergibt sich direkt aus der Notenliste, die Sie einfügen, ohne Annahmen über Schnitt, Streuung oder Glockenkurve. So gilt die Antwort für Ihre echte Klasse und ist keine Schätzung aus einem z-Wert.
Verwandte Tools
Für Entwickler — API-Zugang
Alles auf dieser Seite ist auch per API verfügbar. Dieser Abschnitt richtet sich an Teams, die es in ihre eigenen Systeme einbinden möchten; alle anderen nutzen einfach das Tool oben.
Endpunkt
Authentifizierung per Bearer-Token. Ein einziger POST stellt die Aufgabe in die Warteschlange; das Ergebnis erhalten Sie per Webhook oder über einen signierten Link.
Aufruf aus Ihrem 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)Beispiel-Anfrage
{
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
}Beispiel-Antwort
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.percentile_rank_class",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}Die API arbeitet asynchron: Sie erhalten sofort eine task_id. Polling ist mit 1 Anfrage pro Sekunde erlaubt.
Preis
Der Preis steht auf der Seite – keine Tokens, keine Credits. Fehlgeschlagene Aufgaben werden nicht berechnet.
Limits
max_n | 10000 |
max_abs | 1000000000000000 |
Fehler
| HTTP | Code | Bedeutung |
|---|---|---|
401 | unauthorized | Der API-Schlüssel fehlt oder ist ungültig – prüfen Sie den Authorization-Header (Bearer). |
402 | insufficient_balance | Ihr Guthaben reicht für diese Aufgabe nicht aus – Aufladungen verfallen nicht. |
404 | unknown_type | Unbekannter Aufgabentyp – prüfen Sie das Feld „type“ gegen den Katalog. |
429 | rate_limited | Zu viele Anfragen – warten Sie kurz; Polling ist mit 1 Anfrage pro Sekunde erlaubt. |
Technische Hinweise
Dasselbe deterministische Analysemodul speist das kostenlose Browser-Werkzeug und den API-Pfad, sodass ein Notenbuch-Plugin und eine Sprechstundenprüfung nicht auseinanderlaufen.
Wie ein Klassen-Prozentrang aus der Liste definiert wird
Die Antwort nennt außerdem percent_at_or_below, also B plus E durch N mal hundert, weil Zeugnisse manchmal diesen inklusiven Begleiter brauchen. Das ist nicht die Mittelrang-Konvention, die Gleichständen einen halben Kredit gibt, und kein z-Wert und kein Buchstabe auf einer Glockenkurve; jene Werkzeuge starten von Mittelwert und Standardabweichung statt von einer konkreten Liste.
Eingabevertrag, Antwortfelder und Prüfung
Beispiel: score fünfundsiebzig gegen fünfzig, sechzig, siebzig, achtzig, neunzig — eine Abfrage, die selbst nicht auf der Liste steht — ergibt below drei, equal null, above zwei und einen Rang von sechzig. Senden Sie per POST einen JSON-Körper mit zwei Pflichtfeldern: score, eine endliche Zahl auf derselben Skala wie die Liste, und scores, eine nichtleere Liste endlicher Klassenmarken. score akzeptiert die Aliasse value, mark, raw und x. scores akzeptiert class_scores, roster, data und values, und eine durch Kommas oder Leerzeichen getrennte Zahlenkette wird ebenfalls angenommen, wenn ein Formular Klartext statt eines JSON-Feldes sendet. Jedes Element wird als endliche Dezimalzahl gelesen; optionale Vorzeichen und wissenschaftliche Schreibweise sind erlaubt, während leere Token, Boolesche Werte, Objekte, Infinity und NaN mit invalid_input scheitern, damit eine schlechte Zelle nie zu einer stillen Null wird. Die Engine erzwingt ein hartes Maximum von zehntausend Listenmarken und eine Betragsgrenze je Wert, sodass Speicher und Latenz im kostenlosen Browserpfad und im Worker in einem planbaren Budget bleiben. Fehlendes score, fehlendes scores, eine leere Liste oder eine Liste über der veröffentlichten Länge scheitern mit invalid_input und werden nicht berechnet. Bei Erfolg spiegelt der Körper score wider, liefert n als Listenlänge, below, equal und above als Dreiteilung dieser Liste, percentile_rank als hundertmal below durch n, percent_at_or_below als hundertmal below plus equal durch n, class_min und class_max als beobachtete Enden, method als exclusive_below, eine kurze formula-Zeichenkette, die veröffentlichte max_n-Decke und ein einzeiliges message für die Oberfläche. Beispiel: score 85 gegen die Zehn-Marken-Liste zweiundsechzig, einundsiebzig, vierundsiebzig, achtundsiebzig, einundachtzig, fünfundachtzig, fünfundachtzig, achtundachtzig, zweiundneunzig, siebenundneunzig ergibt below fünf, equal zwei, above drei, percentile_rank fünfzig und percent_at_or_below siebzig. Optionale Felder werden weggelassen statt null, und alle Namen sind DOM-sicheres snake_case für Widgets und SDKs.
Wo ein Klassen-Prozentrang seinen Nutzen hat
Nachhilfezentren und Büros für Studienerfolg erklären Familien, warum eine zweiundachtzig in einer schweren Klausur nahe der Mitte und in einer leichten nahe dem unteren Rand liegt; eine deterministische API lässt diese Gespräche bei denselben Zählern beginnen. Weil die Umsetzung parse der Stufe A ist, kostet jeder erfolgreiche Aufruf den veröffentlichten Grundpreis $0.002 ohne Modell-Tokens und ohne ausgehendes Netz. Halten Sie die Lasten klein, pinnen Sie percentile_rank zusammen mit below und n in Tests, und Sie erhalten reproduzierbare Unterrichtsränge für Notenbuch-Plugins, Sekretariatsskripte und Familienberichte, ohne selbst einen vollen psychometrischen Stapel aufzubauen.
Integrationsbeispiele
LMS- und Sekretariatsautomatisierung
Hängen Sie einen maschinenstabilen percentile_rank an gespeicherte Klassenlisten mit derselben exklusiven Formel wie das kostenlose Browser-Werkzeug.
Technische Fragen
Wie wird der Klassen-Prozentrang berechnet?
Senden Sie score und die scores-Liste der Klasse. Die API zählt Marken streng unter der Note, teilt durch n und multipliziert mit 100. Dieser exklusive Anteil ist percentile_rank.
Was kostet der Klassen-Prozentrang-Rechner?
Das Browser-Werkzeug ist gratis. API-Anfragen nutzen vorausbezahltes KIT-Guthaben zu $0.002 je erfolgreichem Aufruf; ungültige Eingabe wird nicht berechnet.