Calcolatore di rischio relativo

Quando il totale di un gruppo è zero, il rischio stesso è indefinito e l’attività fallisce con invalid_input invece di inventare un rapporto.

Cosa significa il rischio relativo e come si combinano i due rischi

Quando il rischio non esposto è esattamente zero —nessun evento tra i non esposti— il rapporto non ha valore finito, e l’endpoint segnala invalid_input invece di Infinity o NaN che romperebbero i client JSON a valle.

Contratto di ingresso, forma della risposta e comportamento di errore

I conteggi di eventi e i totali devono essere maggiori o uguali a zero. I conteggi di eventi non devono superare i totali corrispondenti, perché non si possono osservare più esiti che persone in un gruppo. La validazione fallita non consuma il saldo prepagato. Invii con POST un corpo JSON con quattro numeri finiti obbligatori: exposed_events e exposed_total per la coorte esposta, unexposed_events e unexposed_total per la coorte di confronto. Ogni campo può arrivare come numero JSON o come stringa numerica; valori non finiti, campi assenti e stringhe vuote falliscono con invalid_input indicando il campo. Entrambi i totali devono essere strettamente maggiori di zero: un totale di gruppo zero rende il rischio indefinito, e il messaggio di errore lo dichiara esplicitamente così correttori e client API distinguono coorti vuote da altro input non valido. In caso di successo il corpo ripete i quattro conteggi, restituisce risk_exposed e risk_unexposed come decimali puliti, restituisce relative_risk come rapporto di quei due rischi, e include una breve stringa di formula che riafferma RR uguale a risk_exposed su risk_unexposed in forma di conteggi. Esempio: quaranta eventi tra duecento esposti e venti eventi tra quattrocento non esposti producono risk_exposed uguale a zero virgola due, risk_unexposed uguale a zero virgola zero cinque e relative_risk uguale a quattro —quattro volte il rischio tra gli esposti—. Abbini questo endpoint al Suo software per intervalli di confidenza o stratificazione di Mantel-Haenszel se serve inferenza oltre la stima puntuale; questa capacità è intenzionalmente un RR analitico puro da quattro conteggi.

Dove un’API di rischio relativo dimostra il proprio valore

Le dashboard di sanità pubblica e i notebook di studi di coorte necessitano di un calcolatore di rischio relativo deterministico che non restituisca mai Infinity in silenzio quando un braccio di confronto ha zero eventi. Gli assistenti di ricerca clinica usano l’RR per riassumere associazioni grezze da tabelle due per due prima di passare a un pacchetto completo di biostatistica per modelli aggiustati. Poiché l’implementazione è parse puro di livello A, ogni chiamata riuscita è economica, rapida e riproducibile su edge worker e browser. Piattaforme didattiche e generatori di esami necessitano di un oracolo che segni totali zero e rischio non esposto zero come errori anziché payload di successo vuoti che un correttore difettoso potrebbe trattare come corretti. I siti di contenuti che competono per calcolatore di rischio relativo ottengono uno strumento live con titolo e parole chiave SEO chiari, mentre gli script di automazione chiamano lo stesso type tramite l’API KIT al prezzo base pubblicato $0.002 senza token di modello e senza rete in uscita.