ForHosting KIT · Utilidades de desarrollo

Calcular el promedio ponderado de valores y pesos

Esta calculadora combina una lista de valores con otra lista de pesos correspondientes y devuelve el promedio ponderado, la suma ponderada, el peso total y la cantidad de elementos.

● BetaGratis · en su navegador
Úselo desde WebAPIEmailTelegramApp pronto

Resulta útil cuando unas observaciones deben influir más que otras, por ejemplo en notas, valoraciones, precios, mediciones e índices compuestos. El cálculo es determinista: multiplica cada valor por el peso de la misma posición, suma los productos y divide el resultado entre la suma de los pesos. Si el peso total es cero, la solicitud se rechaza porque la división no está definida.

Empareje cada valor con el peso correcto

Introduzca los valores y los pesos en dos listas con la misma cantidad de elementos. La posición define la relación: el primer peso corresponde al primer valor, el segundo al segundo y así sucesivamente. Por ejemplo, los valores 82, 91 y 76 con pesos 0.25, 0.5 y 0.25 hacen que el valor central tenga el doble de influencia. No es necesario que los pesos sumen uno ni cien, porque la fórmula divide automáticamente entre el total. Use únicamente números JSON finitos. Se rechazan campos vacíos, texto, infinito, listas ausentes o vacías y longitudes distintas. Esta validación evita que un peso omitido desplace las asociaciones siguientes y produzca un resultado convincente pero incorrecto. Antes de calcular, confirme que ambas listas siguen el mismo orden y que cada peso refleja la influencia deseada.

Comprenda el cálculo y los totales devueltos

La calculadora multiplica cada valor por su peso y suma todos los productos para obtener la suma ponderada. También suma los pesos y divide el primer total entre el segundo. La respuesta muestra weighted_average como resultado final, weighted_sum como numerador, weight_sum como denominador y count como cantidad de pares. Así puede auditar el cálculo en una hoja de cálculo, un informe o una prueba automatizada. Multiplicar todos los pesos por un mismo factor distinto de cero no modifica el promedio. Un peso individual de cero elimina la influencia de su valor. Los pesos negativos se admiten matemáticamente, aunque pueden situar el resultado fuera del intervalo de los valores y solo deberían emplearse cuando el método lo exija. La implementación realiza una sola pasada determinista y no consulta servicios externos.

Evite totales nulos e interprete el resultado

La suma de los pesos debe ser distinta de cero. Si todos son cero, o si los positivos y negativos se cancelan exactamente, la división queda indefinida y se devuelve un error de entrada. Cuando los pesos representan porcentajes, compruebe que incluyen todos los componentes previstos. Pueden sumar 100, 1 u otra cantidad no nula, pero una parte ausente puede hacer que la respuesta sea conceptualmente incompleta. En las notas, decida cómo tratar una actividad aún no evaluada: excluirla no equivale a incluirla con nota cero, mientras que asignarle peso cero anula su efecto. En datos de frecuencia, normalmente se usan pesos no negativos. Compare weight_sum con el total esperado y count con el número de filas de origen; estas comprobaciones detectan muchos errores antes de guardar o publicar el promedio.

Combinar componentes académicos

Calcule una nota final cuando exámenes, proyectos, pruebas y participación aportan proporciones diferentes.

Agregar valoraciones por volumen

Combine valoraciones de grupos y conceda a los grupos con más observaciones la influencia adecuada.

Crear un índice compuesto

Integre indicadores normalizados con pesos de importancia explícitos y conserve los totales para auditarlos.

¿Cuánto cuesta el cálculo?

Cada solicitud de API cuesta $0.002; la calculadora del navegador ejecuta localmente el mismo cálculo determinista.

¿Los pesos deben sumar 100 o 1?

No. Cualquier total distinto de cero sirve, pues la suma ponderada se divide entre la suma real de los pesos.

¿Qué ocurre si los pesos suman cero?

La solicitud devuelve un error de entrada porque la división entre un total nulo no está definida.

¿Pueden tener longitudes distintas las listas?

No. Cada valor debe contar con un único peso correspondiente en la misma posición.

¿Se admiten pesos individuales nulos o negativos?

Sí, siempre que el total no sea cero. Un peso nulo elimina la influencia de un valor; los negativos requieren una interpretación cuidadosa.

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.

POSThttps://api.kit.forhosting.com/calc3/weighted-average-grade

¿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.

curl -X POST https://api.kit.forhosting.com/calc3/weighted-average-grade \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"values":[82,91,76],"weights":[0.25,0.5,0.25]}'
{
  "values": [
    82,
    91,
    76
  ],
  "weights": [
    0.25,
    0.5,
    0.25
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "calc3.weighted_average_grade",
  "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.

Por solicitud$0.002

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

HTTPCódigoSignificado
401unauthorizedAPI key ausente o inválida.
402insufficient_balanceEl saldo no cubre el precio de la tarea.
404unknown_typeEl tipo de tarea no existe.
429rate_limitedDemasiadas peticiones. Use el webhook en vez de sondear.

Ver la documentación completa del KIT →