Calculadora de decis
Nove pontos de corte dividem seus dados em dez partes iguais: D1 marca os 10 % mais baixos, D5 coincide com a mediana e D9 com os 90 %. Veja onde um salário ou uma nota cai na distribuição sem calcular nove percentis separados. Grátis no seu navegador.
- Grátis
- Funciona no seu navegador
- Sem cadastro
- Seus dados não saem do seu aparelho
Executar grátis
Esta calculadora de decis transforma uma matriz de números nos nove limites que dividem a distribuição ordenada em dez partes iguais. Ela valida cada valor, ordena uma cópia dos dados e calcula D1 a D9 por interpolação linear inclusiva. Assim, você compara observações com os décimos inferiores, centrais e superiores da amostra sem solicitar nove percentis separadamente. A ordem original não é alterada, e uma matriz vazia é rejeitada com clareza.
O que os nove decis representam
Decis são marcadores de posição em um conjunto de dados ordenado. D1 indica o ponto associado aos primeiros dez por cento da distribuição, D2 aos vinte por cento, e a sequência segue até D9, em noventa por cento. Juntos, esses nove valores criam dez faixas com parcelas aproximadamente iguais das observações.
Eles são úteis quando uma única média esconde o formato dos dados, principalmente em resultados assimétricos ou com cauda longa. Um analista de salários, por exemplo, pode observar como a remuneração muda entre os funcionários sem resumir todos a uma só média. A calculadora devolve cada limite em ordem crescente: o primeiro item é D1 e o nono é D9.
Também informa os valores ordenados e a quantidade, facilitando a conferência. Os decis descrevem posições relativas na amostra enviada; não afirmam que a distância entre limites vizinhos seja igual. Intervalos largos ou estreitos são características relevantes da distribuição observada.
Como a interpolação linear é aplicada
Primeiro, o cálculo verifica se a entrada é uma matriz não vazia formada apenas por números finitos do JavaScript. Depois, ordena uma cópia do menor para o maior valor. Para cada decil k, de um a nove, localiza o índice fracionário de base zero: (k dividido por dez) multiplicado por (n menos um), em que n é o número de observações.
Quando o índice é inteiro, o valor dessa posição é retornado diretamente. Quando fica entre duas posições, o resultado é interpolado proporcionalmente entre os valores inferior e superior. Nessa convenção linear inclusiva, D1 equivale ao décimo percentil, D5 à mediana e D9 ao nonagésimo percentil.
Valores repetidos são preservados porque cada observação participa da posição. Números negativos e decimais funcionam normalmente. NaN, Infinity, strings, valores nulos e outras entradas não numéricas são rejeitados, em vez de convertidos silenciosamente, para que um resultado aparentemente correto não esconda dados de origem malformados.
Como interpretar e usar o resultado
Leia os decis retornados como limites, e não como dez médias diferentes. Um valor abaixo de D1 está na parte inferior da distribuição enviada, enquanto um valor acima de D9 está na parte superior. Valores entre D4 e D5 ocupam a faixa delimitada por esses marcadores.
Em amostras pequenas, a interpolação pode posicionar um limite entre valores observados; isso é esperado e não significa que o número calculado existia na matriz original. Como ferramentas e pacotes estatísticos adotam diversas convenções de quantis, registre o método ao comparar resultados entre sistemas. Esta capacidade identifica o método como linear e inclui a amostra ordenada para auditoria.
Use uma amostra representativa antes de tomar decisões: os decis resumem fielmente os números enviados, mas não corrigem viés de seleção, registros ausentes ou unidades incompatíveis. Normalize as unidades e determine se repetições são legítimas.
Casos de uso
Segmentar resultados de desempenho
Crie dez faixas para notas, campanhas ou métricas operacionais sem calcular cada percentil separadamente.
Analisar a distribuição de renda
Compare os décimos inferiores, centrais e superiores de uma amostra salarial ou de receita preservando o formato da distribuição.
Definir limites de monitoramento
Use limites históricos de decis como referências transparentes para observações excepcionalmente baixas ou altas.
Perguntas frequentes
O que a calculadora retorna?
Ela retorna uma matriz ordenada com D1 a D9, além do método, da quantidade de observações e dos dados ordenados usados.
Qual método de decis é usado?
É usada interpolação linear inclusiva nas posições (k/10) × (n−1), com k de 1 a 9.
D5 é a mediana?
Sim. Nessa convenção de interpolação linear, D5 é o quinquagésimo percentil e, portanto, a mediana.
Valores repetidos e negativos são aceitos?
Sim. Valores repetidos, negativos, zero e decimais são aceitos, desde que todos sejam números finitos.
Como sei em qual décima parte um valor está?
Leia os decis como fronteiras, não como médias. Um valor abaixo de D1 está na décima parte mais baixa da sua amostra, um entre D4 e D5 na quinta, e um acima de D9 na mais alta.
Ferramentas relacionadas
Para desenvolvedores — acesso via API
Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.
Endpoint
Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.
Chame do seu código
curl -X POST https://api.kit.forhosting.com/stat/deciles \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"values":[12,7,3,18,10,5,14,1,16,9]}'const res = await fetch("https://api.kit.forhosting.com/stat/deciles", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"values": [
12,
7,
3,
18,
10,
5,
14,
1,
16,
9
]
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/stat/deciles",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"values": [
12,
7,
3,
18,
10,
5,
14,
1,
16,
9
]
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/stat/deciles", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"values":[12,7,3,18,10,5,14,1,16,9]}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"values":[12,7,3,18,10,5,14,1,16,9]}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/stat/deciles", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Exemplo de requisição
{
"values": [
12,
7,
3,
18,
10,
5,
14,
1,
16,
9
]
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "stat.deciles",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.
Preço
Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.
Erros
| HTTP | Código | O que significa |
|---|---|---|
401 | unauthorized | Token ausente ou inválido. Confira o header Authorization. |
402 | insufficient_balance | Saldo insuficiente para esta tarefa. Faça uma recarga e tente de novo. |
404 | unknown_type | Esse tipo de tarefa não existe. Confira o campo type no catálogo. |
429 | rate_limited | Muitas requisições em pouco tempo. Espere um instante e tente de novo. |
Notas técnicas
Como interpretar e usar o resultado
A solicitação automatizada custa US$ 0,002, e a implementação determinística devolve a mesma saída para a mesma matriz, independentemente da ordem inicial.
Perguntas técnicas
O que acontece com uma matriz vazia?
A solicitação falha com um erro invalid_input porque nenhum limite de decil pode ser calculado sem observações.
Quanto custa um cálculo pela API?
Cada solicitação automatizada custa US$ 0,002.