Calculadora de fração de uso de códons
Esta calculadora mede quanto um códon representa entre todos os códons observados que codificam o mesmo aminoácido em um gene.
Executar grátis
Informe as contagens e escolha o códon-alvo; o resultado apresenta a fração normalizada, a porcentagem, o aminoácido e todo o grupo sinônimo usado no denominador. Notações de DNA e RNA são aceitas, linhas duplicadas são combinadas e códons sinônimos ausentes recebem zero. Assim, você resume o viés de códons de forma reproduzível, sem planilhas ou tabelas do código genético mantidas manualmente.
O significado da fração de uso do códon
Muitos aminoácidos são codificados por mais de um códon. A fração de uso responde a uma pergunta específica: entre os códons observados para um aminoácido neste gene, qual parcela corresponde ao códon selecionado? Se houver 18 ocorrências de TTT e 12 de TTC, ambos para fenilalanina, a fração de TTT será 18 dividido por 30, ou 0.6. O cálculo é local ao aminoácido, e não a todos os códons do gene. Por isso, ele descreve a preferência sinônima sem que a composição de outros aminoácidos altere o denominador. Uma fração próxima de um indica predominância do códon; uma próxima de zero indica uso raro ou ausente. Esse valor resume a composição observada, mas não comprova sozinho seleção, eficiência de expressão ou significância estatística. Essas interpretações exigem referência adequada e contexto biológico. Use contagens obtidas com uma região de leitura e definição de gene consistentes para manter comparações válidas.
Como preparar e interpretar a entrada
Informe cada códon observado com sua contagem inteira não negativa e indique o códon-alvo. A ferramenta aceita letras de DNA, como TTT, e de RNA, como UUU; a saída normaliza U para T. Maiúsculas, minúsculas e espaços externos não fazem diferença. Se o mesmo códon normalizado aparecer várias vezes, as contagens serão somadas, o que ajuda quando os dados vierem de regiões ou lotes separados. Não é necessário listar todos os sinônimos. Um códon sinônimo omitido aparece com contagem zero e permanece no resultado, tornando o denominador transparente. Contagens de códons de outros aminoácidos são válidas, mas não afetam a fração escolhida. A calculadora utiliza o código genético padrão e rejeita um códon de parada como alvo, pois ele não codifica aminoácido. Também rejeita um grupo sinônimo com total zero, porque uma divisão por zero não descreve uso. Confira a lista sinônima retornada antes de comparar genes.
Uso do resultado em estudos de viés
usage_fraction varia de zero a um, e percentage expressa o mesmo valor de zero a cem. A contagem-alvo e o total sinônimo acompanham a fração para que análises posteriores preservem a evidência da razão. Isso é importante porque frações idênticas podem ter sustentação muito diferente: uma ocorrência em duas e quinhentas em mil resultam em 0.5, mas não devem receber automaticamente a mesma confiança. Em estudos exploratórios, calcule a fração de cada códon sinônimo e compare padrões entre genes, condições, organismos ou sequências projetadas. Mantenha constantes o código genético, a versão da anotação e as regras de contagem. Como verificação, as frações de uma família sinônima devem somar um quando usam as mesmas contagens. O preço da API é US$ 0,002 por solicitação, enquanto o navegador executa localmente o mesmo cálculo determinístico. Não há consulta de rede, amostragem aleatória, banco de dados ou frequência de referência variável.
Casos de uso
Resumir um gene
Meça se um códon sinônimo predomina ou é pouco usado dentro de um gene.
Comparar projetos gênicos
Calcule frações equivalentes para sequências codificantes nativas e redesenhadas com as mesmas regras.
Auditar uma tabela de contagens
Exponha o denominador sinônimo e os membros zerados antes de uma análise mais ampla.
Perguntas frequentes
Qual é a fórmula?
A contagem do códon selecionado é dividida pela soma das contagens de todos os códons do mesmo aminoácido no código padrão.
Posso informar códons de RNA?
Sim. U é normalizado para T, portanto UUU e TTT são tratados como o mesmo códon.
O que acontece se faltar um códon sinônimo?
Ele recebe contagem zero. A saída lista toda a família sinônima usada no cálculo.
Linhas duplicadas são permitidas?
Sim. Códons duplicados são normalizados e suas contagens inteiras não negativas são somadas.
O alvo pode ser um códon de parada?
Não. A métrica relaciona um códon ao seu aminoácido; por isso, sinais de parada são rejeitados.
Uma fração alta comprova expressão ideal?
Não. Ela descreve apenas as contagens fornecidas; conclusões sobre expressão e adaptação exigem referências e contexto biológico.
Quanto custa uma solicitação de API?
O preço é US$ 0,002 por solicitação. A página também executa localmente o cálculo determinístico no navegador.
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/bio/codon-usage-fraction \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"codon_counts":[{"codon":"TTT","count":18},{"codon":"TTC","count":12},{"codon":"ATG","count":7}],"target_codon":"TTT"}'const res = await fetch("https://api.kit.forhosting.com/bio/codon-usage-fraction", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"codon_counts": [
{
"codon": "TTT",
"count": 18
},
{
"codon": "TTC",
"count": 12
},
{
"codon": "ATG",
"count": 7
}
],
"target_codon": "TTT"
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/bio/codon-usage-fraction",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"codon_counts": [
{
"codon": "TTT",
"count": 18
},
{
"codon": "TTC",
"count": 12
},
{
"codon": "ATG",
"count": 7
}
],
"target_codon": "TTT"
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/bio/codon-usage-fraction", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"codon_counts":[{"codon":"TTT","count":18},{"codon":"TTC","count":12},{"codon":"ATG","count":7}],"target_codon":"TTT"}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"codon_counts":[{"codon":"TTT","count":18},{"codon":"TTC","count":12},{"codon":"ATG","count":7}],"target_codon":"TTT"}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/bio/codon-usage-fraction", 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
{
"codon_counts": [
{
"codon": "TTT",
"count": 18
},
{
"codon": "TTC",
"count": 12
},
{
"codon": "ATG",
"count": 7
}
],
"target_codon": "TTT"
}Exemplo de resposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "bio.codon_usage_fraction",
"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.
Limites
max_items | 64 |
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. |