Calcolatore di efficacia vaccinale
Con 20 infezioni su 1000 vaccinati e 80 su 1000 con placebo, l'efficacia vaccinale è del 75%. Inserisca i quattro numeri della tabella dei risultati di uno studio per ricalcolare lei stesso la percentuale pubblicata. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Infezioni nei vaccinati
- 20
- Vaccinati (n)
- 1000
- Infezioni con placebo
- 80
- Placebo (n)
- 1000
- Tasso di attacco nei vaccinati
- 0,02 percent
- Tasso di attacco con placebo
- 0,08
- Rischio relativo
- 0,25
- Efficacia (%)
- 75
L'efficacia vaccinale è la riduzione percentuale del rischio di infezione tra le persone vaccinate rispetto a un gruppo placebo o non vaccinato osservato nella stessa finestra di studio. Studenti, analisti di sperimentazioni, giornalisti e team di prodotto calcolano quella percentuale da quattro numeri: infezioni nel braccio vaccinato, dimensione del braccio vaccinato, infezioni nel braccio placebo e dimensione del braccio placebo. Questo calcolatore di efficacia vaccinale applica l'identità classica di uno meno il rischio relativo: divida il tasso di attacco vaccinato per il tasso di attacco del placebo, sottragga quel rischio relativo da uno e moltiplichi per cento.
Che cosa significa l'efficacia vaccinale e come i quattro conteggi diventano una percentuale
Lo stimatore classico usato nei manuali, nei documenti delle agenzie e nei corsi introduttivi di epidemiologia è uno meno il rischio relativo, espresso come percentuale. Il rischio relativo è il tasso di attacco vaccinato diviso per il tasso di attacco del placebo. Quando i due tassi di attacco coincidono, l'efficacia è zero perché il vaccino non ha cambiato il rischio in questa tabella grezza.
Quando il braccio vaccinato non ha infezioni e il placebo ne ha, l'efficacia è cento per cento. Quando il braccio vaccinato ha un tasso di attacco maggiore del placebo, la percentuale è negativa, e questo calcolatore la riporta con onestà invece di tagliarla a zero o nascondere il segno. Lo usi quando ha già conteggi di coorte chiusa e le serve un VE percentuale riproducibile, non quando le servono ancora persona-tempo, follow-up sovrapposti o l'analisi primaria prevista dal protocollo.
Contratto di ingresso, forma della risposta e comportamento in errore
Qualsiasi conteggio negativo fallisce perché una sperimentazione non può registrare meno tre infezioni né un elenco negativo. Una dimensione di gruppo pari a zero fallisce perché il tasso di attacco è infezioni divise per n, e la divisione per zero è indefinita. I conteggi di infezione che superano la dimensione del proprio gruppo falliscono perché un tasso di attacco maggiore di uno non è una proporzione valida di coorte chiusa.
Se il braccio placebo ha registrato zero infezioni, il tasso di attacco del placebo è zero e il rischio relativo è indefinito, quindi l'attività fallisce invece di restituire Infinity. La convalida fallita non viene addebitata.
Casi d'uso
Giornalismo scientifico e spiegazioni di sperimentazioni
Ricalcoli l'efficacia vaccinale da titolo di una sperimentazione pubblicata dai quattro conteggi della tabella dei risultati e citi una percentuale deterministica accanto ai numeri di origine.
Domande frequenti
Come si calcola l'efficacia vaccinale dai conteggi di infezione?
La percentuale di efficacia è (1 − (ARV/ARU)) × 100, dove ARV è infezioni vaccinate su n vaccinato e ARU infezioni placebo su n placebo.
Che cosa succede se la dimensione di un gruppo è zero o un conteggio è negativo?
I conteggi negativi non sono dati validi di sperimentazione, e una dimensione di gruppo nulla rende indefinito il tasso di attacco. Quei fallimenti non vengono addebitati.
L'efficacia vaccinale può essere negativa o superare il cento per cento?
L'efficacia negativa viene restituita quando il tasso di attacco vaccinato supera quello del placebo. Valori sopra il cento per cento non si verificano con conteggi validi di coorte chiusa (le infezioni non possono essere negative, quindi ARV non può scendere sotto zero).
Qual è la differenza tra efficacia vaccinale ed effettività vaccinale?
Questo calcolatore riporta un'efficacia vaccinale da sperimentazione, di un braccio vaccinato contro un comparatore placebo o non vaccinato, usando quattro conteggi. L'effettività vaccinale osservazionale da persona-tempo nel mondo reale o disegni test-negativo è un'altra analisi e un altro intento di ricerca.
Il calcolatore fornisce un intervallo di confidenza?
No. Applica solo l'identità dei quattro numeri, uno meno il rischio relativo. Non adatta curve di Kaplan-Meier, modelli di Poisson né intervalli di confidenza, e non lavora con le persone-tempo.
Strumenti correlati
Per sviluppatori — accesso via API
Tutto quello che vedi in questa pagina è disponibile anche via API. Questa sezione è per i team che vogliono integrarlo nei propri sistemi; chi non ne ha bisogno può semplicemente usare lo strumento qui sopra.
Endpoint
Autenticazione con Bearer token: un POST mette in coda l'attività e il risultato arriva via webhook o link firmato.
Chiamala dal tuo stack
curl -X POST https://api.kit.forhosting.com/health/vaccine-efficacy \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}'const res = await fetch("https://api.kit.forhosting.com/health/vaccine-efficacy", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/health/vaccine-efficacy",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/vaccine-efficacy", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"vaccinated_infections":20,"vaccinated_n":1000,"placebo_infections":80,"placebo_n":1000}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/vaccine-efficacy", body)
req.Header.Set("Authorization", "Bearer "+os.Getenv("KIT_KEY"))
req.Header.Set("Content-Type", "application/json")
res, _ := http.DefaultClient.Do(req)Esempio di richiesta
{
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.vaccine_efficacy",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L'API è asincrona: ricevi subito un task_id e puoi fare polling fino a 1 richiesta al secondo.
Prezzi
Prezzo pubblicato, senza token né crediti. Se l'attività fallisce, non paghi.
Errori
| HTTP | Codice | Significato |
|---|---|---|
401 | unauthorized | Chiave API mancante o non valida: controlla l'header Authorization. |
402 | insufficient_balance | Credito esaurito: ricarica per continuare a eseguire attività. |
404 | unknown_type | Tipo di attività sconosciuto: controlla il campo type della richiesta. |
429 | rate_limited | Troppe richieste in poco tempo: rallenta e riprova tra qualche secondo. |
Note tecniche
Il risultato è un efficacy_percent stabile che Lei può fissare in test, fogli di calcolo e cruscotti. I conteggi negativi e le dimensioni di gruppo nulle falliscono con invalid_input e non vengono mai addebitati.
Che cosa significa l'efficacia vaccinale e come i quattro conteggi diventano una percentuale
L'efficacia vaccinale, spesso abbreviata VE, è la riduzione percentuale del rischio di un endpoint definito tra chi ha ricevuto il vaccino rispetto a chi ha ricevuto placebo o è rimasto non vaccinato. Il tasso di attacco in ciascun braccio è semplicemente le infezioni divise per la dimensione di quel braccio: vaccinated_infections su vaccinated_n, e placebo_infections su placebo_n. Moltiplicare il complemento di quel rapporto per cento produce efficacy_percent. Questo endpoint non adatta curve di Kaplan–Meier, modelli di Poisson né intervalli di confidenza; è l'identità a quattro conteggi che giornalisti e studenti digitano davvero in un foglio. Ingressi identici producono sempre lo stesso JSON perché il percorso è aritmetica pura, senza rete, senza modello, senza seme casuale e senza orologio a muro.
Contratto di ingresso, forma della risposta e comportamento in errore
Invii un corpo JSON con quattro numeri finiti obbligatori. vaccinated_infections è il numero di eventi di endpoint nel gruppo vaccinato. vaccinated_n è il numero di persone, o unità di elenco comparabili, in quel gruppo e deve essere maggiore di zero. placebo_infections è il numero di eventi di endpoint nel comparatore placebo o non vaccinato. placebo_n è la dimensione del gruppo comparatore e deve essere maggiore di zero. Ciascun campo può arrivare come numero JSON o come stringa numerica; alias documentati come vaccinated_cases, n_vaccinated, placebo_cases e unvaccinated_n sono accettati quando il nome canonico è omesso. Campi mancanti, stringhe vuote e valori non finiti falliscono con invalid_input indicando il campo. In caso di successo il corpo riecheggia i quattro ingressi, riporta vaccinated_attack_rate e placebo_attack_rate come proporzioni, riporta relative_risk come loro rapporto e riporta efficacy_percent come cento volte uno meno quel rapporto. unit è sempre percent. formula riformula l'identità così un'interfaccia può mostrare la riga didattica accanto al numero. method è sempre one_minus_relative_risk così il codice a valle ramifica senza annusare le forme.
Dove un'API di efficacia vaccinale merita il suo posto, prezzo e limiti
Aule e piattaforme di tutoraggio usano un calcolatore di efficacia vaccinale perché chi impara possa controllare i compiti contro un oracolo deterministico invece di un refuso silenzioso di foglio sul passo del rischio relativo. La convalida fallita non consuma saldo. Chi prende decisioni di salute personale deve seguire il consiglio medico professionale e l'analisi statistica pubblicata della sperimentazione, non una sola percentuale automatizzata. Tenga le richieste piccole, fissi i campi arrotondati nei test e ottiene efficacia vaccinale riproducibile per compiti, grafici di redazione e worker di bordo senza alzare una propria pila di biostatistica. Le redazioni di divulgazione scientifica ricalcolano il VE da titolo di una sperimentazione pubblicata dai quattro conteggi della tabella dei risultati e citano efficacy_percent senza riderivare l'identità sotto scadenza. I team di prodotto che già memorizzano dimensioni dei bracci e conteggi di eventi in un magazzino dati possono inviare quei quattro campi e persistere efficacy_percent accanto ai conteggi grezzi per cruscotti e colonne di esportazione. Poiché l'implementazione è parse pura di livello A, ogni chiamata riuscita costa il prezzo base pubblicato $0.002, senza token di modello e senza rete in uscita. Questo è uno strumento di calcolo e insegnamento, non un dispositivo medico diagnostico né un sostituto di un'analisi prevista dal protocollo con persona-tempo, intervalli di confidenza sovrapposti o endpoint regolatori.
Casi di integrazione
Compiti di epidemiologia e correzione d'esame
Consenta agli studenti di inviare i conteggi di infezione vaccinati e placebo con le dimensioni di gruppo e di verificare efficacy_percent rispetto all'identità classica di uno meno il rischio relativo.
App di educazione sanitaria e backend SaaS
Chiami lo stesso contratto a quattro conteggi da un widget del browser gratuito e dalla valutazione API prepagata così le demo in aula e le pipeline di produzione non discordano mai.
Domande tecniche
Quanto costa il calcolatore di efficacia vaccinale?
Lo strumento del browser è gratuito. Le richieste API usano il saldo KIT prepagato a $0.002 per chiamata riuscita; l'ingresso non valido non viene addebitato.