Nota ponderada sobre total

Introduzca cada categoría con los puntos obtenidos, los posibles y el peso, y fije out_of (por ejemplo 20 para una nota clásica sobre 20). El motor normaliza cada fila a un cociente, promedia esos cocientes por peso, multiplica por su total y devuelve mark, mark_display y el desglose por categoría.

Qué significa una puntuación ponderada sobre un total

La matemática es la misma en todas partes: cada categoría aporta score dividido entre max_score, ese cociente se multiplica por el peso de la categoría, se suman esos productos, la suma se divide entre el peso total y el resultado se multiplica por out_of. Ejemplo: deberes ochenta y cinco de cien con peso treinta, parcial dieciséis de veinte con peso treinta, final cuarenta y dos de cincuenta con peso cuarenta, out_of veinte. Quien busca nota ponderada sobre un total, calificación sobre 20 o marca por categorías en escala fija quiere esta conversión como resultado principal, con una cadena mark_display clara que puede pegar en un informe o mensaje a padres. Como cada categoría se normaliza con su propio max_score, usted puede mezclar un cuestionario sobre diez con un proyecto sobre cien sin forzar todo a un único pozo de puntos brutos.

Contrato de entrada, redondeo y comportamiento ante errores

El label opcional nombra la categoría en el desglose. Los pesos no tienen que sumar cien: el motor renormaliza automáticamente, así que usted puede introducir treinta, treinta, cuarenta o 0.3, 0.3, 0.4 con los mismos cocientes y la misma marca. Envíe por POST un cuerpo JSON con dos campos obligatorios. categories es un array no vacío de hasta cincuenta objetos; cada objeto debe incluir score (puntos finitos no negativos obtenidos), max_score (puntos posibles estrictamente positivos) y weight (peso relativo estrictamente positivo). Los alias items, rows y components se asignan a categories. out_of es el total objetivo estrictamente positivo de la marca combinada; se aceptan los alias total, scale y max_mark. decimals opcional es un entero de cero a seis inclusive y por defecto vale dos; se acepta el alias precision. En caso de éxito la respuesta incluye mark (redondeado half-up a decimals), out_of, mark_display como 16.62 / 20, weighted_percent, weighted_ratio, total_weight, category_count, decimals, un array categories con ratio, weight_share y contribution_to_mark por fila, más formula y method weighted_category_scale para clientes estables. Si faltan categories u out_of, hay arrays vacíos, no objetos en la lista, scores negativos, max_score o weight no positivos, out_of no positivo o decimals fuera de cero a seis, la llamada falla con invalid_input y mensajes que nombran el campo; los fallos de validación no se facturan.

Dónde una API de marca sobre N ponderada aporta valor real

Los docentes que califican con instrumentos mixtos pero informan en una escala institucional fija necesitan un oráculo en el que confíen estudiantes, padres y hojas de cálculo. Los tutores pueden recorrer con el alumno cada contribución de categoría sin inventar aritmética a medida en cada sesión. La validación fallida no consume saldo. Las oficinas de orientación cerca de los parciales responden decenas de veces cuánto es esto sobre veinte tras los pesos; un endpoint determinista compartido elimina el desfase de bots de Discord y los errores de calculadora a mano. Como la implementación es parse de nivel A puro, cada llamada exitosa cuesta el precio base publicado $0.002 sin tokens de modelo ni red saliente. Mantenga las solicitudes pequeñas, fije mark y mark_display en las pruebas, y obtendrá marcas escaladas reproducibles para demos de aula, trabajadores en el borde y calculadoras de temario sin montar infraestructura de calificación propia.