Rango percentile di classe
Un 85 in una classe di 10 dove 5 hanno preso meno, 2 lo stesso voto e 3 di più si colloca al 50° percentile. Incolli i voti della classe e un voto per vedere la quota di compagni sotto e quella uguale o sotto. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Punteggio
- 85
- N
- 10
- Sotto
- 5
- Uguali
- 2
- Sopra
- 3
Un rango percentile di classe risponde alla domanda che ogni registro finisce per porsi: dato il voto di questo studente, quale quota della classe ha ottenuto un risultato strettamente inferiore? Docenti, orientatori, autori di un LMS e famiglie non vogliono una soglia del k-esimo percentile né una fascia verbale; vogliono un rango calcolato sulla lista reale che hanno davanti. Le ricette da foglio oscillano fra formule esclusive, inclusive e di rango medio, e due sezioni dello stesso corso possono riferire ranghi diversi per lo stesso voto se la lista di confronto non è fissata. Questo calcolatore prende un voto di interrogazione e una lista finita di voti di classe, conta quante marche della lista cadono strettamente sotto l'interrogazione e restituisce quel conteggio come percentuale dell'organico. Senza rete, senza modello e senza casualità: Lei fornisce la lista e il voto, e il rango è riproducibile per ogni ingresso valido.
Come si definisce il rango percentile di classe dalla lista
Il rango percentile di classe non è la stessa statistica del k-esimo percentile di un insieme di dati. Il k-esimo percentile dice quale voto occupa una posizione scelta su una lista ordinata; il rango di classe risponde alla domanda inversa dell'aula: tra le marche già presenti sulla lista, quale percentuale sta strettamente sotto il voto di questo studente.
La formula esclusiva usata qui è PR uguale a B su N per cento, dove N è la lunghezza della lista scores che Lei invia e B è il conteggio dei valori strettamente minori del voto interrogato.
I pareggi non gonfiano il rango esclusivo: i compagni che eguagliano l'interrogazione contano in equal, non in below, così una marca unica in cima a una classe di dieci ha B uguale a nove e un rango di novanta, mentre un voto che altri quattro compagni hanno ottenuto riferisce ancora solo la quota di chi ha preso meno.
Non è la convenzione di rango medio che dà mezzo credito ai pareggi, né uno z-score né una lettera a curva di Gauss; quegli strumenti partono da una media e da una deviazione standard invece che da una lista concreta. Lei decide se la lista include lo studente interrogato. Se la lista è l'intera classe con quello studente, N è l'organico e una coincidenza con sé stessi compare in equal.
Se la lista è il resto, N è il numero di compagni e il rango è la quota dei pari più bassi. Entrambe le letture sono valide; il calcolatore non inserisce né toglie da solo il voto interrogato. I casi al confine sono onesti: la marca unica più bassa dà rango zero, un voto sopra tutte le marche della lista dà cento, e una classe di uno con voto coincidente dà rango esclusivo zero e cento per cento al di sotto o uguale.
Il motore non stima mai una media, non interpola mai fra statistiche d'ordine e non proietta mai il rango su fasce basso, medio o alto. Conta, divide e restituisce le due percentuali più i conteggi below, equal e above così un docente può mostrare l'aritmetica alla lavagna.
Dove un rango percentile di classe trova impiego
I registri di classe e i plugin LMS hanno bisogno di una mappatura documentata da un voto grezzo più una lista a un rango 0–100, così la pagella stampata, il portale delle famiglie e la spiegazione in ricevimento non si contraddicono sullo stesso studente. I responsabili che confrontano le sezioni vogliono la cifra esclusiva di chi ha preso meno, non che ogni docente inventi una regola di pareggio diversa nel foglio personale.
I prodotti ed-tech che già memorizzano voti di item possono attaccare un percentile di classe al bordo senza imbarcare un secondo motore statistico né caricare una lista su un sito di terzi. I siti di contenuto che competono su rango percentile di classe o percentile di un voto beneficiano di un percorso gratuito nel browser che coincide byte per byte con l'automazione a pagamento sulla stessa libreria analitica. Una convalida fallita non consuma il saldo.
Abbini questo estremo a un classificatore di fasce se in seguito vorrà un'etichetta verbale, e a uno strumento a parte di k-esimo percentile se le serve una soglia anziché il rango di un solo voto.
Casi d'uso
Rango sul registro da una lista pubblicata
Trasformi un voto dello studente più la lista della sezione nel rango percentile esclusivo per la pagella e il LMS.
Spiegazioni in ricevimento e alle famiglie
Mostri i conteggi below, equal e above così una famiglia vede quanti compagni hanno preso meno di un voto dato.
Domande frequenti
Un pareggio alza il rango percentile?
No. I compagni che eguagliano l'interrogazione contano in equal, non in below.
Il voto dello studente deve comparire nella lista scores?
Entrambe le letture sono valide. Se la lista include quello studente, n è l'organico e una coincidenza con sé stessi compare in equal. Se la lista è il resto, n è il numero di compagni. Il calcolatore non inserisce né toglie il voto interrogato.
È lo stesso calcolo di un k-esimo percentile o di un rango medio?
No. Un k-esimo percentile trova una soglia su una lista ordinata. Il rango medio dà mezzo credito ai pareggi. Questo strumento riferisce la quota esclusiva dell'aula che ha ottenuto un risultato strettamente inferiore.
Che differenza c'è tra rango percentile e percentuale uguale o inferiore?
Il rango percentile conta solo i voti strettamente più bassi, mentre il secondo valore aggiunge i pari merito. Nell'esempio, 5 su 10 hanno preso meno, il che dà 50, e con i 2 voti uguali si passa a 70.
Servono la media e la deviazione standard della classe?
No. Il rango si ricava direttamente dall'elenco dei voti che incolla, senza supporre media, dispersione o curva a campana. Per questo risponde sulla classe reale e non stima partendo da un punteggio z.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo 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)Esempio di richiesta
{
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.percentile_rank_class",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Limiti
max_n | 10000 |
max_abs | 1000000000000000 |
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Lo stesso modulo analitico deterministico alimenta lo strumento gratuito del browser e il percorso API, così un plugin del registro e un controllo in ricevimento non discordano.
Come si definisce il rango percentile di classe dalla lista
La risposta riferisce anche percent_at_or_below, cioè B più E su N per cento, perché le pagelle a volte necessitano di quel compagno inclusivo.
Contratto di ingresso, campi di risposta e convalida
Esempio: score settantacinque di fronte a cinquanta, sessanta, settanta, ottanta, novanta — un'interrogazione assente dalla lista — produce below tre, equal zero, above due e un rango di sessanta. Invii con POST un corpo JSON con due campi obbligatori: score, un numero finito sulla stessa scala della lista, e scores, una lista non vuota di marche di classe finite. score accetta gli alias value, mark, raw e x. scores accetta class_scores, roster, data e values, e si accetta anche una stringa di numeri separati da virgole o spazi quando un modulo invia testo semplice invece di una matrice JSON. Ogni elemento è letto come decimale finito; segni iniziali opzionali e notazione scientifica sono ammessi, mentre token vuoti, booleani, oggetti, Infinity e NaN falliscono con invalid_input perché una cella errata non diventi mai uno zero silenzioso. Il motore impone un massimo rigido di diecimila marche nella lista e un tetto di magnitudine per valore, così memoria e latenza restano in un bilancio prevedibile sul percorso gratuito del browser e sul Worker. Mancanza di score, mancanza di scores, lista vuota o lista oltre la lunghezza pubblicata falliscono con invalid_input e non sono fatturate. In caso di successo il corpo ripete score, restituisce n come lunghezza della lista, below, equal e above come la partizione in tre di quella lista, percentile_rank come cento volte below su n, percent_at_or_below come cento volte below più equal su n, class_min e class_max come gli estremi osservati, method come exclusive_below, una breve stringa formula, il tetto pubblicato max_n e un message di una riga per l'interfaccia. Esempio: score 85 di fronte alla lista di dieci marche sessantadue, settantuno, settantaquattro, settantotto, ottantuno, ottantacinque, ottantacinque, ottantotto, novantadue, novantasette produce below cinque, equal due, above tre, percentile_rank cinquanta e percent_at_or_below settanta.
Dove un rango percentile di classe trova impiego
I centri di tutorato e gli uffici di successo accademico spiegano alle famiglie perché un ottantadue sta vicino al centro in una prova difficile e vicino al fondo in una facile; un'API deterministica consente a quei colloqui di partire dagli stessi conteggi. Poiché l'implementazione è parse di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita. Tenga i carichi piccoli, fissi percentile_rank insieme a below e n nei test, e ottiene ranghi di aula riproducibili per plugin del registro, script di segreteria e rapporti alle famiglie senza erigere una pila psicometrica completa da solo.
Casi di integrazione
Automazione LMS e di segreteria
Attacchi un percentile_rank stabile per macchina alle liste memorizzate, con la stessa formula esclusiva dello strumento gratuito del browser.
Domande tecniche
Come si calcola il rango percentile di classe?
Invii score e la lista scores della classe. L'API conta le marche strettamente sotto il voto, divide per n e moltiplica per 100. Quella quota esclusiva è percentile_rank.
Quanto costa il calcolatore di rango percentile di classe?
Lo strumento del browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; un ingresso non valido non è fatturato.