Temps de doublement du PSA

La valeur ultérieure doit être strictement supérieure à la précédente ; une paire en baisse ou plate est rejetée comme invalid_input plutôt qu'un résultat négatif ou infini.

Ce que signifie le temps de doublement du PSA et comment fonctionne la formule à deux points

Le temps de doublement de l'antigène prostatique spécifique à deux points traite la trajectoire récente du PSA comme une exponentielle simple : la concentration croît d'un facteur multiplicatif constant par unité de temps. Comme la conversation clinique rapporte le PSADT en mois, cette capacité divise le résultat en jours par 365.25 divisé par 12, la durée moyenne du mois grégorien qui inclut la moyenne du jour bissextile. Présentez toujours le chiffre en mois comme une estimation pédagogique à deux points, non comme un ajustement multi-valeurs de Memorial Sloan Kettering et non comme un diagnostic. Prendre le logarithme naturel des deux côtés transforme cette hypothèse en une droite en log-PSA versus le calendrier, et la pente de la droite à deux points est le ln de psa2 sur psa1 divisé par les jours écoulés. Le temps de doublement est alors le ln de deux divisé par cette pente, ce qui se réarrange en days fois ln de deux sur ln de psa2 sur psa1. La constante de conversion est renvoyée comme days_per_month afin que chaque client audite le changement d'unité au lieu de deviner si l'outil a utilisé 30, 30.44 ou 365.25/12. Lorsque psa2 égale psa1, le logarithme au dénominateur est zéro et le temps de doublement serait infini ; lorsque psa2 est plus petit, le logarithme est négatif et la grandeur décrirait une demi-vie, non un doublement. Les deux cas échouent avec invalid_input en nommant psa2 versus psa1, conformément à la règle produit selon laquelle le second PSA doit être strictement supérieur au premier. L'implémentation est une arithmétique en virgule flottante sous forme fermée : pas de régression sur des points extra, pas de réseau, pas d'horodatage d'horloge murale et pas de graines aléatoires, de sorte que des triplets identiques produisent toujours le même JSON après un arrondi stable à douze décimales.

Contrat d'entrée, forme de la réponse et comportement d'erreur

Envoyez par POST un corps JSON avec trois nombres finis obligatoires. Le champ psa1 est l'antigène prostatique spécifique antérieur en nanogrammes par millilitre ; les alias first_psa, psa_first, initial_psa et psa_initial sont acceptés. Le champ psa2 est le PSA ultérieur dans la même unité ; les alias second_psa, psa_second, final_psa et psa_final sont acceptés. Le champ days est l'intervalle écoulé positif en jours entre les deux prélèvements ; les alias interval_days, elapsed_days, days_between et t sont acceptés. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique. Champs manquants, chaînes vides, valeurs non finies, PSA non positif et days non positifs échouent avec invalid_input en nommant le champ et ne sont pas facturés. Si psa2 n'est pas strictement supérieur à psa1, le gestionnaire échoue aussi avec invalid_input plutôt que de renvoyer un décompte de mois négatif ou infini. En cas de succès, le corps répète les psa1, psa2 et days nettoyés ; ratio comme psa2 divisé par psa1 ; doublings comme log2 de ce rapport ; doubling_time_days d'après la formule à deux points ; doubling_time_months comme days fois ln de deux sur ln du rapport fois 365.25/12 ; days_per_month égal à 365.25/12 ; unit_doubling_time fixé à months ; et une chaîne formula qui reformule l'identité. Un contrôle classique est psa1 égal à deux, psa2 égal à quatre, days égal à quatre-vingt-dix : le rapport est exactement deux, il y a un doublement, doubling_time_days vaut quatre-vingt-dix et doubling_time_months est quatre-vingt-dix divisé par 30.4375. Associez le JSON à votre propre graphique si vous avez besoin d'un croquis log-PSA ; ce point de terminaison calcule uniquement le chiffre à deux points en mois. Les appels API réussis utilisent le tarif de base publié $0.002 par élément.

Où un calculateur de temps de doublement du PSA justifie sa place

Les générateurs d'examens et les greffons de gestion de l'apprentissage ont besoin d'un oracle déterministe qui rejette un second PSA en baisse comme invalid_input au lieu d'émettre en silence un décompte négatif de mois qu'un correcteur défectueux pourrait traiter comme un succès. Comme l'implémentation est un parse de niveau A pur, chaque appel réussi coûte le tarif de base publié $0.002 sans jetons de modèle ni réseau sortant, et une validation échouée ne consomme pas le solde prépayé.