ForHosting KIT · Utilidades de desarrollo

Nota sobre la media: puntos porcentuales y desviaciones

Una nota puede parecer excelente o decepcionante hasta que se compara con el rendimiento de la clase.

● BetaGratis · en su navegador

Úselo desde WebAPIEmailTelegramApp pronto

Esta calculadora presenta esa comparación de dos formas complementarias. Resta la media de la clase de la nota para obtener la diferencia con signo en puntos porcentuales y después divide esa diferencia por la desviación estándar. El resultado indica si la nota está por encima, por debajo o justo en la media, y ofrece a estudiantes, docentes, tutores y analistas una interpretación clara sin alterar la escala de calificación original.

Introduzca porcentajes de la misma escala de calificación

Indique la nota individual, la media y la desviación estándar de la clase, todas en una escala de 0 a 100. La nota y la media deben corresponder a la misma evaluación y al mismo grupo. No compare una nota de un examen con la media de otro salvo que ambos se hayan equiparado expresamente, pues mezclaría dificultades distintas. Exprese la desviación estándar en puntos porcentuales, no como porcentaje de la media ni como varianza. Si las notas suelen alejarse ocho puntos de la media, introduzca 8. Se admiten standard_deviation, std o sd, pero solo uno. Todos los valores deben ser finitos y la desviación debe ser mayor que cero. Por ejemplo, nota 86, media 74 y desviación 8 pertenecen a la misma escala 0–100.

Interprete juntos la diferencia y el z-score

La diferencia con signo es la nota menos la media. Un resultado de 12 significa doce puntos porcentuales por encima de la media; −6 significa seis puntos por debajo. Es una diferencia absoluta en la escala, no un aumento porcentual relativo. El z-score divide esa diferencia por la desviación estándar. Si la diferencia es 12 y la desviación es 8, el resultado es 1.5: una desviación y media por encima. Un valor negativo señala una nota inferior y cero una coincidencia exacta. La salida incluye también la distancia absoluta y una dirección explícita. Use los puntos porcentuales para explicar la diferencia bruta y el z-score para comparar posiciones relativas entre pruebas con dispersiones distintas. Ninguno determina por sí solo si se cumple un criterio académico.

Compare sin extraer conclusiones excesivas

Una distancia en desviaciones estándar describe una posición dentro de una distribución, pero no proporciona automáticamente un percentil. Convertir un z-score en percentil exige asumir un modelo, normalmente una distribución normal, y esta calculadora no lo hace. Las notas reales pueden ser asimétricas, agruparse cerca del máximo o proceder de una clase pequeña. Considere el resultado una comparación descriptiva basada en las estadísticas que usted aporta. Permite explicar por qué una ventaja de diez puntos puede ser más inusual en una clase con dispersión de cinco que en otra con dispersión de quince. También distingue «puntos sobre la media» de «porcentaje mejor». Para informes automáticos, el JSON devuelve entradas, diferencia, dirección, z-score, distancia absoluta y resumen. El navegador es gratuito; cada elemento correcto de API cuesta $0.002.

Qué puede hacer con ella

Explicar el resultado de un examen

Muestre al estudiante la diferencia respecto a la media y su relevancia frente a la dispersión de la clase.

Comparar la posición entre clases

Contraste evaluaciones con medias y variabilidad diferentes mediante desviaciones estándar y puntos porcentuales.

Crear informes de notas coherentes

Añada dirección, diferencia con signo, z-score y un resumen claro a informes automáticos de progreso.

Preguntas frecuentes

¿Qué es la diferencia en puntos porcentuales?

Es la nota menos la media. Una nota de 82 y una media de 75 dan 7 puntos porcentuales, no un aumento relativo del 7 por ciento.

¿Cómo se calcula la distancia en desviaciones estándar?

La calculadora divide la diferencia con signo por la desviación estándar indicada: z = (score − mean) / standard deviation.

¿El z-score equivale a un percentil?

No. La conversión a percentil exige supuestos sobre la distribución; aquí solo se informa la distancia observada.

¿Por qué la desviación estándar no puede ser cero?

Cero significa que no existe dispersión. La división sería indefinida, por lo que la entrada se rechaza.

¿Cuánto cuesta una solicitud de API?

Cada elemento correcto de API cuesta $0.002. El mismo cálculo determinista es gratuito en el navegador.

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

POSThttps://api.kit.forhosting.com/edu/percent-above-mean

¿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/percent-above-mean \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"score":86,"mean":74,"standard_deviation":8}'

const res = await fetch("https://api.kit.forhosting.com/edu/percent-above-mean", {
  method: "POST",
  headers: {
    "Authorization": `Bearer ${process.env.KIT_KEY}`,
    "Content-Type": "application/json"
  },
  body: JSON.stringify({
    "score": 86,
    "mean": 74,
    "standard_deviation": 8
  })
});
const { task_id } = await res.json();

import os, requests

res = requests.post(
    "https://api.kit.forhosting.com/edu/percent-above-mean",
    headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
    json={
    "score": 86,
    "mean": 74,
    "standard_deviation": 8
},
)
task_id = res.json()["task_id"]

<?php
$res = file_get_contents("https://api.kit.forhosting.com/edu/percent-above-mean", false, stream_context_create([
  "http" => [
    "method"  => "POST",
    "header"  => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
    "content" => '{"score":86,"mean":74,"standard_deviation":8}',
  ],
]));
$task = json_decode($res, true);

body := bytes.NewBufferString(`{"score":86,"mean":74,"standard_deviation":8}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/edu/percent-above-mean", 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": 86,
  "mean": 74,
  "standard_deviation": 8
}

Ejemplo de respuesta

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

Por solicitud$0.002

Precio publicado — sin tokens ni créditos inventados. Una tarea fallida no se cobra.

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.

Ver la documentación completa del KIT →