Calculadora de ganho dB

Níveis nulos e negativos são rejeitados com invalid_input porque o logaritmo real não está definido para um argumento não positivo.

Contrato de entrada, rejeição de zero e negativos, e o payload exato que esta calculadora devolve

Campos ausentes, strings vazias, NaN, Infinity e texto não numérico falham imediatamente nomeando o campo, e a validação malsucedida não é cobrada. Zero é rejeitado porque dividir por uma entrada nula é indefinido e porque log10 de uma razão não positiva não é um número real. Não há conversão de unidades dentro do solver: se você misturar milivolts com volts, ou miliwatts com watts, a razão está fisicamente errada e a cifra dB sai errada em 60 dB ou 30 dB respectivamente. Converta os dois portos para uma unidade primeiro e depois chame a calculadora. Envie um corpo JSON com três campos obrigatórios. mode deve ser o conjunto fechado voltage ou power; qualquer outra string, inclusive vazia, é invalid_input. input_level é a amplitude de entrada no mode voltage ou a potência de entrada no mode power. output_level é a saída correspondente. Ambos os níveis devem ser finitos e estritamente maiores que zero; podem chegar como números JSON ou como strings numéricas, para que formulários e pipelines no estilo CSV pulem um cast extra. Níveis negativos são rejeitados pela mesma razão logarítmica: uma tensão com sinal pode aparecer em um circuito, mas este endpoint trata um nível como magnitude positiva, que é o contrato usual de laboratório para uma calculadora combinada de ganho dB de tensão e de potência. O payload de sucesso reitera mode, input_level e output_level, e acrescenta ratio, gain_db, multiplier e uma cadeia formula que você pode exibir ao lado do resultado. Exemplo: mode voltage, input_level 1, output_level 10 devolve gain_db de 20 e ratio 10. Exemplo: mode power, input_level 1, output_level 2 devolve cerca de 3.0103 dB.

Onde uma calculadora combinada de ganho dB se paga, e quanto custa uma chamada

Engenheiros de áudio costumam querer ganho de tensão porque as especificações de mixers e microfones são cotadas em volts; orçamentos de rádio e de enlace óptico costumam querer ganho de potência porque a grandeza que se soma ao longo de uma cascata é a potência em dBm. De qualquer modo, esta capacidade é um contrato só em vez de duas ferramentas separadas, que é a intenção de busca por trás de uma calculadora genérica de ganho dB em vez de uma página só de tensão ou só de potência. Mantenha os dois níveis em uma só unidade física, escolha voltage ou power de forma explícita e você obtém uma cifra em decibéis reproduzível para publicar ao lado de um esquemático ou de um relatório de ensaio. Use a API quando uma bancada de testes, um script de calibração ou um gerador de folhas de dados precisar gravar o mesmo número em JSON para milhares de pares de entrada e saída. Combine o resultado com a sua própria aritmética de figura de ruído ou de ponto de interceptação se estiver fechando uma cascata: este endpoint só converte dois níveis positivos em um ganho dB e não modela resposta em frequência, descasamento de impedância nem constantes do transdutor. Cada solicitação bem-sucedida é um item faturável a US$ 0,002; a validação malsucedida não consome saldo. Os resultados são totalmente determinísticos: o mesmo mode e os mesmos dois níveis positivos sempre produzem o mesmo gain_db, o mesmo ratio, o mesmo multiplier e a mesma cadeia formula, o que torna a capacidade segura para fixar em checagens de integração contínua e em cadernos de laboratório reproduzíveis.