Escala de cores por faixas

Informe o valor, mínimo e máximo inclusivos, número de faixas e cores inicial e final. Ela valida todos os dados, trata explicitamente o limite superior e sempre produz o mesmo resultado. Use-a em painéis, mapas, faixas de pontuação, legendas, relatórios e fluxos que precisam de classificação reproduzível em vez de um gradiente contínuo.

Transforme um intervalo contínuo em categorias confiáveis

Um gradiente contínuo pode sugerir mais precisão do que a medição realmente oferece. As faixas tornam a decisão visível: todo valor dentro da mesma divisão recebe exatamente a mesma cor. Informe o valor numérico, os limites inferior e superior inclusivos e a quantidade de faixas. A ferramenta divide o intervalo em partes de mesma largura, numera-as a partir de um e retorna tanto o índice iniciado em zero quanto seus limites numéricos. Cada faixa inclui o limite inferior e exclui o superior, exceto a última, que inclui o máximo declarado. Essa regra explícita impede divergências entre sistemas para valores exatamente na fronteira. O indicador retornado também informa se o limite superior é inclusivo. Isso ajuda quando um gráfico, uma exportação, um serviço e uma tela web devem classificar valores da mesma forma. A ferramenta não examina um conjunto de dados nem calcula quantis estatísticos; o mínimo e o máximo informados definem a escala, portanto o resultado não depende de observações ocultas ou da ordem delas.

Monte a escala com interpolação RGB determinística

A primeira faixa usa a cor inicial e a última usa a cor final. As cores intermediárias são calculadas pela interpolação independente dos canais vermelho, verde e azul, com arredondamento de cada canal para o inteiro mais próximo. A posição depende do índice da faixa, e não do valor bruto, garantindo que dois valores na mesma divisão recebam a mesma cor hexadecimal. Os extremos aceitam seis dígitos hexadecimais com ou sem cerquilha, e a saída é normalizada em letras minúsculas com cerquilha. A interpolação RGB é simples por escolha e reproduzível na API e no navegador. Ela não é um modelo perceptual; em paletas com requisitos de acessibilidade, escolha extremos cujas cores intermediárias continuem distinguíveis e tenham contraste adequado. O resultado inclui cor, índice, número legível, total de faixas e limites numéricos. Assim, você pode colorir uma marca e gerar dica, legenda, validação ou registro de auditoria correspondente sem recriar o cálculo em outro lugar.

Valide intervalos antes da visualização

O ajuste silencioso parece conveniente até que um defeito anterior pinte um valor impossível como válido. Por isso, a ferramenta rejeita números não finitos, intervalos invertidos ou sem largura, valores fora dos limites inclusivos, cores malformadas e quantidades que não sejam inteiros entre 2 e 256. Isso torna as falhas acionáveis e impede que o painel esconda medições ruins. Defina os limites no sistema responsável pela métrica e reutilize-os em todos os valores. Se a distribuição for muito assimétrica e você realmente precisar de quantis com populações iguais, calcule primeiro os pontos de corte; esta capacidade cria faixas de mesma largura entre extremos explícitos. Para uma legenda estável, use as mesmas regras ao gerar rótulos e colorir observações. O máximo recebe tratamento especial para que a divisão de ponto flutuante não o coloque além do último índice. As demais fronteiras exatas entram naturalmente na faixa seguinte, conforme a convenção documentada. O navegador e a API paga compartilham o mesmo algoritmo puro, permitindo testar o resultado antes de automatizá-lo por US$ 0,002 por solicitação.