Calculadora de curva linear de notas

Esta calculadora de curva linear de notas aceita um array de pontuações brutas e um bônus de pontos não negativo, calcula curved_i igual ao mínimo entre cem e raw_i mais points para cada estudante, e devolve a lista curvada completa, a contagem de pontuações que bateram no teto e as médias da turma antes e depois do ajuste. A mesma aritmética pura alimenta a ferramenta gratuita do navegador e o caminho da API, de modo que scripts de correção e demonstrações de tarefas permanecem estáveis byte a byte. Pontuações ausentes, arrays vazios, points negativos e valores não finitos falham com invalid_input em vez de inventar uma curva.

O que significa uma curva linear de pontos e como funciona o teto de 100%

Este endpoint codifica essa convenção de sala de aula diretamente: curved é igual a min(100, raw mais points) para cada entrada do array scores, na mesma ordem em que voce as enviou. Bônus negativos são rejeitados porque esta página de produto e o contrato da API descrevem uma curva linear de soma de pontos, não uma dedução geral. Zero pontos é permitido e atua como uma passagem de validação pura que ainda reporta médias e um capped_count de zero, salvo se uma pontuação bruta já excedesse cem e for limitada pela mesma regra de máximo.

Contrato de entrada, formato da resposta e comportamento de erro

Envie por POST um corpo JSON com dois campos obrigatórios: scores, um array não vazio de números finitos (de uma a quinhentas entradas), e points, um número finito não negativo de pontos de bônus a somar a cada pontuação bruta. Cada elemento de pontuação e o campo points podem chegar como número JSON ou como string numérica; os aliases raw_scores, grades e values mapeiam para scores, enquanto points_to_add, bonus, curve_points e add mapeiam para points. Scores ausentes, um valor scores que não seja array, uma lista vazia, mais de quinhentas entradas, points ausentes, points negativos, NaN, Infinity e elementos não numéricos falham com invalid_input e mensagens que nomeiam o campo ou o índice. Essas falhas de validação não são cobradas. Em caso de sucesso o corpo ecoa o array scores limpo e o valor de points, devolve curved_scores na mesma ordem, define max_score como cem, informa count como o tamanho da turma, capped_count como quantos estudantes ficaram exatamente no teto porque raw mais points ultrapassou cem, e inclui mean_raw e mean_curved como médias aritméticas para comparação rápida antes e depois. A string formula reafirma que curved é igual a min(100, raw mais points) e method é linear_grade_curve. Exemplo: pontuações setenta e dois, oitenta e cinco, noventa e um, sessenta e oito com cinco pontos geram setenta e sete, noventa, noventa e seis, setenta e três, sem teto se nenhuma cruzou cem; um bruto de noventa e oito com cinco pontos vira cem e incrementa capped_count. Combine as listas com suas próprias faixas de letra se precisar de rótulos A–F; este endpoint aplica apenas a curva linear numérica e não emite conceitos literais, pesos nem médias por categoria.

Onde uma API de curva linear de notas realmente vale a pena

Como a implementação é parse de nível A puro, cada chamada bem-sucedida custa o preço base publicado US$ 0,002 sem tokens de modelo e sem rede de saída. Mantenha as solicitações dentro do limite de quinhentas pontuações, fixe curved_scores e as médias nos testes, e voce obtém curvas lineares reproduzíveis para plugins LMS, demos de plantão e workers na borda sem montar infraestrutura própria de correção.