Rango percentil de clase
Una nota de 85 en un grupo de 10 donde 5 sacaron menos, 2 empataron y 3 sacaron más ocupa el percentil 50. Pegue las notas del grupo y una nota para ver la parte de compañeros por debajo y la parte igual o inferior. Gratis en su navegador.
- Gratis
- Funciona en su navegador
- Sin registro
- Sus datos no salen de su equipo
Ejecutar — gratis
Ejemplo resuelto
- Nota
- 85
- N
- 10
- Por debajo
- 5
- Iguales
- 2
- Por encima
- 3
Un rango percentil de clase responde a la pregunta que todo diario de calificaciones acaba planteando: dada la nota de este alumno, ¿qué fracción del grupo obtuvo un resultado estrictamente inferior? El profesorado, la orientación, quienes escriben un LMS y las familias no buscan un umbral del percentil k ni una banda verbal; quieren un puesto calculado sobre la lista real que tienen delante. Las recetas de hoja de cálculo oscilan entre fórmulas exclusivas, inclusivas y de rango medio, y dos secciones del mismo curso pueden informar puestos distintos para la misma marca si la lista de comparación no queda fijada. Esta calculadora toma una nota de consulta y una lista finita de calificaciones, cuenta cuántas marcas de la lista caen estrictamente por debajo de la consulta y devuelve ese recuento como porcentaje del tamaño de la clase. Sin red, sin modelo y sin azar: usted aporta la lista y la nota, y el puesto es reproducible para cada entrada válida.
Cómo se define el rango percentil de clase a partir de la lista
El rango percentil de clase no es la misma estadística que el percentil k de un conjunto de datos. El percentil k responde qué nota se sitúa en una posición elegida de una lista ordenada; el rango de clase responde a la pregunta inversa del aula: de las marcas ya presentes en la lista, qué porcentaje queda estrictamente por debajo de la nota de este alumno.
La fórmula exclusiva usada aquí es PR igual a B entre N por cien, donde N es la longitud de la lista scores que usted envía y B es el recuento de valores estrictamente menores que la nota consultada.
Los empates no inflan el rango exclusivo: los compañeros que igualan la consulta cuentan en equal, no en below, así que una marca única en lo alto de una clase de diez tiene B igual a nueve y un rango de noventa, mientras que una nota que también obtuvieron cuatro compañeros sigue informando solo la fracción que puntuó menos. Usted decide si la lista incluye al alumno consultado.
Si la lista es la clase completa con ese alumno, N es el tamaño de la clase y una coincidencia consigo mismo aparece en equal. Si la lista es el resto, N es el número de compañeros y el rango es la fracción de pares que puntuó menos. Ambas lecturas son válidas; la calculadora no inserta ni elimina por su cuenta la nota consultada.
Los casos frontera son honestos: la marca única más baja da un rango de cero, una nota por encima de todas las de la lista da cien, y una clase de uno con nota coincidente da rango exclusivo cero y cien por ciento en o por debajo. El motor nunca estima una media, nunca interpola entre estadísticas de orden y nunca proyecta el rango sobre bandas bajo, medio o alto.
Cuenta, divide y devuelve los dos porcentajes más los recuentos below, equal y above para que un docente pueda mostrar la aritmética en la pizarra.
Dónde un rango percentil de clase aporta valor
Los diarios de aula y los complementos LMS necesitan un mapeo documentado de una marca bruta más una lista a un rango 0–100 para que el boletín impreso, el portal familiar y la explicación en tutoría no se contradigan sobre el mismo alumno. Las jefaturas que comparan secciones quieren la cifra exclusiva de quién puntuó menos, no que cada docente invente una regla de empate distinta en su hoja personal.
Los productos ed-tech que ya guardan notas de ítems pueden adjuntar un percentil de clase en el borde sin embarcar un segundo motor estadístico ni subir una lista a un sitio de terceros. Los sitios de contenido que compiten por rango percentil de clase o percentil de una nota se benefician de una ruta gratuita en el navegador que coincide byte a byte con la automatización de pago sobre la misma biblioteca analítica. La validación fallida no consume saldo.
Combine este extremo con un clasificador de bandas si más adelante desea una etiqueta verbal, y con una herramienta aparte de percentil k si necesita un umbral en lugar del puesto de una sola nota.
Qué puede hacer con ella
Puesto en el diario sobre una lista publicada
Convierta una marca del alumno más la lista de la sección en el rango percentil exclusivo para el boletín y el LMS.
Explicaciones en tutoría y a las familias
Muestre los recuentos below, equal y above para que una familia vea cuántos compañeros puntuaron menos que una marca dada.
Preguntas frecuentes
¿Un empate sube el rango percentil?
No. Los compañeros que igualan la consulta cuentan en equal, no en below.
¿Debe estar la propia nota del alumno en la lista scores?
Ambas opciones son válidas. Si la lista incluye a ese alumno, n es el tamaño de la clase y una coincidencia consigo mismo aparece en equal. Si la lista es el resto, n es el número de compañeros. La calculadora no inserta ni elimina la nota consultada.
¿Es lo mismo que un percentil k o un rango percentil de rango medio?
No. Un percentil k halla un umbral en una lista ordenada. El rango medio da medio crédito a los empates. Esta herramienta informa la fracción exclusiva del aula que obtuvo un resultado estrictamente inferior.
¿Qué diferencia hay entre el rango percentil y el porcentaje igual o inferior?
El rango percentil cuenta solo las notas estrictamente menores, mientras que la segunda cifra suma también los empates. En el ejemplo, 5 de 10 sacaron menos, lo que da 50, y con las 2 notas empatadas pasa a 70.
¿Necesito la media y la desviación estándar del grupo?
No. El rango sale directamente de la lista de notas que usted pega, sin suponer una media, una dispersión ni una campana de Gauss. Por eso responde sobre el grupo real y no estima a partir de una puntuación z.
Herramientas relacionadas
Para desarrolladores — acceso por API
Todo lo de esta página está disponible por programación. Esta sección es para equipos que quieren integrarlo en sus sistemas; el resto puede usar la herramienta de arriba sin más.
Endpoint de API
¿Prefiere automatizarlo? Un POST autenticado crea la tarea; el resultado llega por webhook o enlace firmado. La misma capacidad también se ejecuta aquí en la web, por email y desde Telegram — y pronto también desde nuestra app.
Llámela desde su 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)Ejemplo de solicitud
{
"score": 85,
"scores": [
62,
71,
74,
78,
81,
85,
85,
88,
92,
97
]
}Ejemplo de respuesta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "edu.percentile_rank_class",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}La API es asíncrona: la llamada devuelve un task_id al instante y el resultado llega por webhook. El polling está limitado a 1 req/s por tarea.
Precio
Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.
Límites
max_n | 10000 |
max_abs | 1000000000000000 |
Errores
| HTTP | Código | Significado |
|---|---|---|
401 | unauthorized | API key ausente o inválida. |
402 | insufficient_balance | El saldo no cubre el precio de la tarea. |
404 | unknown_type | El tipo de tarea no existe. |
429 | rate_limited | Demasiadas peticiones. Use el webhook en vez de sondear. |
Notas técnicas
El mismo módulo analítico determinista alimenta la herramienta gratuita del navegador y la ruta API, de modo que un complemento del diario y una comprobación en tutoría no discrepan.
Cómo se define el rango percentil de clase a partir de la lista
La respuesta también informa percent_at_or_below, que es B más E entre N por cien, porque los boletines a veces necesitan ese compañero inclusivo. Esto no es el convenio de rango medio que da medio crédito a los empates, ni un z-score ni una letra en curva de campana; esas herramientas parten de una media y una desviación típica en lugar de una lista concreta.
Contrato de entrada, campos de respuesta y validación
Ejemplo: score setenta y cinco frente a cincuenta, sesenta, setenta, ochenta, noventa —una consulta que no está en la lista— produce below tres, equal cero, above dos y un rango de sesenta. Envíe por POST un cuerpo JSON con dos campos obligatorios: score, un número finito en la misma escala que la lista, y scores, una lista no vacía de marcas de clase finitas. score acepta los alias value, mark, raw y x. scores acepta class_scores, roster, data y values, y también se admite una cadena de números separados por comas o espacios cuando un formulario envía texto plano en lugar de una matriz JSON. Cada elemento se interpreta como decimal finito; se permiten signos iniciales opcionales y notación científica, mientras que tokens vacíos, booleanos, objetos, Infinity y NaN fallan con invalid_input para que una celda mala nunca se convierta en un cero silencioso. El motor impone un máximo duro de diez mil marcas en la lista y un techo de magnitud por valor, de modo que la memoria y la latencia queden dentro de un presupuesto previsible en la ruta gratuita del navegador y en el Worker. Si falta score, falta scores, la lista está vacía o supera la longitud publicada, la tarea falla con invalid_input y no se factura. En caso de éxito el cuerpo repite score, devuelve n como longitud de la lista, below, equal y above como el reparto en tres de esa lista, percentile_rank como cien veces below entre n, percent_at_or_below como cien veces below más equal entre n, class_min y class_max como los extremos observados, method como exclusive_below, una cadena formula breve, el techo publicado max_n y un message de una línea para la interfaz. Ejemplo: score 85 frente a la lista de diez marcas sesenta y dos, setenta y uno, setenta y cuatro, setenta y ocho, ochenta y uno, ochenta y cinco, ochenta y cinco, ochenta y ocho, noventa y dos, noventa y siete produce below cinco, equal dos, above tres, percentile_rank cincuenta y percent_at_or_below setenta. Los campos opcionales se omiten en lugar de null, y todos los nombres son snake_case seguro para el DOM en widgets y SDK.
Dónde un rango percentil de clase aporta valor
Los centros de tutoría y las oficinas de éxito académico explican a las familias por qué un ochenta y dos queda cerca del centro en un examen difícil y cerca del fondo en uno fácil; una API determinista permite que esas conversaciones partan de los mismos recuentos. Como la implementación es parse de nivel A, cada llamada correcta cuesta el precio base publicado $0.002 sin tokens de modelo y sin red de salida. Mantenga las cargas pequeñas, fije percentile_rank junto con below y n en las pruebas, y obtendrá rangos de aula reproducibles para complementos del diario, scripts de secretaría e informes a las familias sin levantar una pila psicométrica completa por su cuenta.
Casos de integración
Automatización LMS y de secretaría
Adjunte un percentile_rank estable para máquina a las listas guardadas, con la misma fórmula exclusiva que la herramienta gratuita del navegador.
Preguntas técnicas
¿Cómo se calcula el rango percentil de clase?
Envíe score y la lista scores de la clase. La API cuenta las marcas estrictamente inferiores a la nota, divide entre n y multiplica por 100. Esa fracción exclusiva es percentile_rank.
¿Cuánto cuesta la calculadora de rango percentil de clase?
La herramienta del navegador es gratuita. Las solicitudes API usan saldo KIT prepago a $0.002 por llamada correcta; la entrada inválida no se factura.