Tempo de duplicação do PSA

O valor posterior deve ser estritamente maior que o anterior; um par que cai ou permanece estável é rejeitado como invalid_input em vez de um resultado negativo ou infinito.

O que significa o tempo de duplicação do PSA e como funciona a fórmula de dois pontos

O tempo de duplicação do antígeno prostático específico com dois pontos trata a trajetória recente do PSA como uma exponencial simples: a concentração cresce por um fator multiplicativo constante por unidade de tempo. Como a conversa clínica informa o PSADT em meses, esta capacidade divide o resultado em dias por 365.25 dividido por 12, a duração média do mês gregoriano que inclui a média do dia bissexto. Enquadre sempre a cifra em meses como uma estimativa educativa de dois pontos, não como um ajuste multivalor de Memorial Sloan Kettering e não como um diagnóstico. Tomar o logaritmo natural dos dois lados transforma essa hipótese em uma reta em log-PSA versus o calendário, e a inclinação da reta de dois pontos é o ln de psa2 sobre psa1 dividido pelos dias decorridos. O tempo de duplicação é então o ln de dois dividido por essa inclinação, o que se reorganiza como days vezes ln de dois sobre ln de psa2 sobre psa1. A constante de conversão é devolvida como days_per_month para que cada cliente audite a mudança de unidade em vez de adivinhar se a ferramenta usou 30, 30.44 ou 365.25/12. Quando psa2 iguala psa1 o logaritmo no denominador é zero e o tempo de duplicação seria infinito; quando psa2 é menor o logaritmo é negativo e a grandeza descreveria uma meia-vida, não uma duplicação. Ambos os casos falham com invalid_input nomeando psa2 versus psa1, de acordo com a regra de produto de que o segundo PSA deve ser estritamente maior que o primeiro. A implementação é aritmética de ponto flutuante em forma fechada: sem regressão sobre pontos extras, sem rede, sem carimbos de relógio de parede e sem sementes aleatórias, de modo que triplas idênticas sempre produzem o mesmo JSON após arredondamento estável a doze casas decimais.

Contrato de entrada, forma da resposta e comportamento de erro

Envie por POST um corpo JSON com três números finitos obrigatórios. O campo psa1 é o antígeno prostático específico anterior em nanogramas por mililitro; os aliases first_psa, psa_first, initial_psa e psa_initial são aceitos. O campo psa2 é o PSA posterior na mesma unidade; os aliases second_psa, psa_second, final_psa e psa_final são aceitos. O campo days é o intervalo decorrido positivo em dias entre as duas coletas; os aliases interval_days, elapsed_days, days_between e t são aceitos. Cada campo pode chegar como número JSON ou como string numérica. Campos ausentes, strings vazias, valores não finitos, PSA não positivo e days não positivos falham com invalid_input nomeando o campo e não são cobrados. Se psa2 não for estritamente maior que psa1 o tratador também falha com invalid_input em vez de devolver uma contagem de meses negativa ou infinita. Em caso de sucesso o corpo ecoa os psa1, psa2 e days limpos; ratio como psa2 dividido por psa1; doublings como log2 dessa razão; doubling_time_days a partir da fórmula de dois pontos; doubling_time_months como days vezes ln de dois sobre ln da razão vezes 365.25/12; days_per_month igual a 365.25/12; unit_doubling_time definido como months; e uma string formula que reenuncia a identidade. Uma verificação clássica é psa1 igual a dois, psa2 igual a quatro, days igual a noventa: a razão é exatamente dois, há uma duplicação, doubling_time_days é noventa e doubling_time_months é noventa dividido por 30.4375. Combine o JSON com o seu próprio gráfico se precisar de um esboço de log-PSA; este endpoint calcula apenas a cifra de dois pontos em meses. Chamadas API bem-sucedidas usam o preço-base publicado US$ 0,002 por item.

Onde uma calculadora de tempo de duplicação do PSA se justifica

Geradores de prova e plugins de gestão de aprendizagem precisam de um oráculo determinístico que rejeite um segundo PSA em queda como invalid_input em vez de emitir em silêncio uma contagem negativa de meses que um corretor defeituoso poderia tratar como acerto. 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 nem rede de saída, e a validação falha não consome saldo pré-pago.