Calcolatore di immunità vaccinale
Un vaccino con efficacia pubblicata del 95%, in due dosi, conserva circa due terzi di protezione sei mesi dopo, perché il modello la dimezza ogni 12 mesi. Inserisca efficacia, dosi e mesi dall'ultima dose. Gratis nel suo browser.
- Gratis
- Funziona nel suo browser
- Senza registrazione
- I suoi dati restano sul dispositivo
Esegui gratis nel browser
Esempio risolto
- Efficacia
- 95
- Dosi
- 2
- Mesi
- 6
- Percentuale rimanente
- 67,1751442127
- Percentuale massima
- 95
- Fattore di dose
- 1
- Fattore di declino
- 0,7071067812
La protezione indotta dal vaccino non è una costante. L'efficacia pubblicata descrive il picco intorno al completamento del ciclo primario; ogni mese aggiuntivo dopo l'ultima dose lascia che quella protezione cali lungo una curva esponenziale liscia, e un ciclo incompleto non raggiunge mai il picco pubblicato. Questo calcolatore di immunità vaccinale stima la protezione residua come percentuale a partire da tre numeri: efficacia tra zero e cento, il conteggio delle dosi ricevute e i mesi trascorsi dall'ultima dose. Applica un tasso educativo fisso di calo con emivita di dodici mesi e un fattore saturante di ciclo a due dosi, poi restituisce la percentuale residua insieme al picco, al fattore di dose e al fattore di calo affinché ogni passo possa essere verificato. Nessuna consultazione di rete, nessuna casualità e nessuna dipendenza dalla data odierna: solo aritmetica sui numeri che Lei fornisce. Tratti ogni risultato come una stima educativa della protezione vaccinale, mai come un titolo clinico, una raccomandazione di richiamo o un sostituto di un clinico.
Come si stima la protezione vaccinale residua
L'efficacia vaccinale pubblicata è una cifra di picco, non una costante a vita. Dopo un ciclo primario completato la risposta immunitaria è più forte vicino all'ultima dose; l'attività neutralizzante e la protezione clinica calano poi lungo una curva che, per un lavoro educativo, si approssima bene con un calo esponenziale del primo ordine.
Questo calcolatore usa un'emivita fissa di dodici mesi: la protezione residua si dimezza ogni anno dopo l'ultima dose, il che equivale a moltiplicare il picco per l'esponenziale di meno il logaritmo naturale di due volte i mesi divisi per dodici.
Un ciclo incompleto è scalato in modo lineare verso quel picco con un fattore saturante a due dosi: zero dosi non apportano nulla, una dose raggiunge la metà dell'efficacia pubblicata, due o più dosi raggiungono l'efficacia pubblicata piena, e le dosi ulteriori non alzano il picco sopra quella cifra perché, in questo modello, riavviano soltanto l'orologio che chi chiama già fornisce come mesi dall'ultima dose. Quell'unica espressione copre mesi frazionari e interi: sei mesi dopo un ciclo completato resta circa il settantuno per cento del picco, non la metà.
L'efficacia deve stare nell'intervallo chiuso da zero a cento perché una percentuale fuori da quell'intervallo non è un'efficacia vaccinale. L'implementazione non consulta un patogeno, una marca o un sierotipo; valuta soltanto la formula con i numeri che Lei invia affinché cruscotti, chiavi dei compiti e taccuini a lotti condividano una definizione trasparente della protezione vaccinale residua. Tratti ogni risultato come una percentuale educativa secondo questa definizione, mai come un titolo di anticorpi misurato né come una raccomandazione medica.
Casi d'uso
Curve di emivita in epidemiologia d'aula
Fissi l'efficacia e un ciclo completato a due dosi, percorra i mesi e tracci la protezione vaccinale residua affinché gli allievi vedano un'emivita di dodici mesi invece di un'efficacia piatta.
Giornalismo e divulgazione pubblica del calo
Mostri ai lettori come un'efficacia pubblicata del novantacinque per cento scende sei o dodici mesi dopo l'ultima dose con una sola formula esponenziale verificabile.
Domande frequenti
Quale formula usa il calcolatore di immunità vaccinale?
Il picco è l'efficacia pubblicata scalata da un ciclo saturante a due dosi; il calo usa un'emivita fissa di dodici mesi.
Come le dosi extra dopo un ciclo a due dosi influenzano la stima?
Due o più dosi saturano il picco all'efficacia pubblicata.
Quanta protezione dà una sola dose?
In questo modello una dose raggiunge metà dell'efficacia pubblicata al picco, e due o più dosi raggiungono il valore pieno. Senza alcuna dose la stima è zero.
Quanto velocemente cala la protezione?
Si dimezza ogni 12 mesi dopo l'ultima dose, lungo una curva esponenziale regolare. Sei mesi dopo un ciclo completo resta circa il settantuno per cento del picco, non la metà.
Tiene conto di età, marca del vaccino o difese immunitarie ridotte?
No. Non ci sono correzioni per patogeno, marca, sierotipo, età o stato immunitario, né una data di calendario. Nella formula entrano solo efficacia, dosi e mesi.
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-immunity \
-H "Authorization: Bearer $KIT_KEY" \
-H "Content-Type: application/json" \
-d '{"efficacy":95,"doses":2,"months":6}'const res = await fetch("https://api.kit.forhosting.com/health/vaccine-immunity", {
method: "POST",
headers: {
"Authorization": `Bearer ${process.env.KIT_KEY}`,
"Content-Type": "application/json"
},
body: JSON.stringify({
"efficacy": 95,
"doses": 2,
"months": 6
})
});
const { task_id } = await res.json();import os, requests
res = requests.post(
"https://api.kit.forhosting.com/health/vaccine-immunity",
headers={"Authorization": f"Bearer {os.environ['KIT_KEY']}"},
json={
"efficacy": 95,
"doses": 2,
"months": 6
},
)
task_id = res.json()["task_id"]<?php
$res = file_get_contents("https://api.kit.forhosting.com/health/vaccine-immunity", false, stream_context_create([
"http" => [
"method" => "POST",
"header" => "Authorization: Bearer " . getenv("KIT_KEY") . "\r\nContent-Type: application/json",
"content" => '{"efficacy":95,"doses":2,"months":6}',
],
]));
$task = json_decode($res, true);body := bytes.NewBufferString(`{"efficacy":95,"doses":2,"months":6}`)
req, _ := http.NewRequest("POST", "https://api.kit.forhosting.com/health/vaccine-immunity", 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
{
"efficacy": 95,
"doses": 2,
"months": 6
}Esempio di risposta
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.vaccine_immunity",
"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.
Limiti
max_doses | 20 |
max_months | 600 |
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
Lo strumento gratuito del browser e l'API condividono la stessa libreria JavaScript pura, così i controlli interattivi e i compiti automatici coincidono sempre.
Come si stima la protezione vaccinale residua
In algebra remaining_percent è efficacy moltiplicato per il minimo di uno e doses su due, moltiplicato per il fattore esponenziale di calo.
Contratto di ingresso, uscite e comportamento in errore
La convalida fallita non è addebitata. Non c'è tabella di patogeni, né aggiustamento per età, né indicatore di immunocompromissione, né data di calendario in questa capacità: sono intenti di prodotto distinti. Invii un oggetto JSON con tre numeri finiti obbligatori: efficacy, l'efficacia vaccinale pubblicata in percentuale sull'intervallo chiuso da zero a cento; doses, un intero non negativo di dosi ricevute, al massimo venti; e months, il tempo non negativo trascorso in mesi dall'ultima dose, al massimo seicento, con mesi frazionari ammessi. Alias quali vaccine_efficacy, ve, efficacy_pct, n_doses, doses_received, dose_count, shots, months_since_last_dose, months_since, elapsed_months e time_months sono accettati così moduli e script non dipendono da un unico nome di campo. Campi obbligatori assenti, stringhe vuote, valori non finiti, dosi non intere, dosi o mesi negativi, più di venti dosi, più di seicento mesi e un'efficacia fuori da zero a cento falliscono con invalid_input e un messaggio che nomina il problema. In caso di successo la risposta restituisce remaining_percent come stima principale, ripete efficacy, doses e months, e include peak_percent, dose_factor, waning_factor, half_life_months uguale a dodici, waning_rate_per_month uguale al logaritmo naturale di due diviso per dodici, primary_series_doses uguale a due, e una stringa formula che riafferma remaining_percent = efficacy × min(1, doses/2) × exp(−ln(2)×months/12). Abbini remaining_percent al Suo calendario se Le serve confrontare la stima educativa con una politica di richiamo che Lei stessa o Lei stesso ha scelto. Le chiamate API riuscite costano il $0.002 pubblicato per elemento; i fallimenti di convalida non consumano mai il saldo prepagato.
Dove i team lo usano e come funziona il prezzo
I divulgatori di sanità pubblica, i cruscotti di immunizzazione e i taccuini giornalistici usano un calcolatore di immunità vaccinale per mostrare come la protezione residua scende dopo l'ultima dose senza reinventare il codice di calo esponenziale in ogni client. Lo strumento interattivo sopra gira gratis nel browser per controlli esplorativi. Le chiamate programmatiche usano il saldo prepagato KIT per ogni elemento riuscito; un ingresso non valido non consuma mai il saldo. Ingressi e uscite di origine sono conservati solo per la finestra di ritenzione documentata e non sono mai usati per addestrare modelli. Le catene di ricerca che registrano conteggi di dosi autodichiarati e l'età dell'ultima dose possono inviare molte attività indipendenti —una per persona e intervallo— e conservare remaining_percent accanto alla sessione per un'analisi successiva. I moduli di epidemiologia in aula possono fissare efficacy e doses e spazzare months per illustrare un'emivita di dodici mesi senza una cella di foglio che si è spostata quando qualcuno ha modificato il tasso. Poiché l'implementazione è parse di livello A puro, ogni chiamata riuscita costa il prezzo base pubblicato $0.002, senza token di modello e senza rete in uscita. La latenza è dominata dalla stretta di mano del compito piuttosto che dal calcolo, il che rende l'endpoint adatto sia alla convalida di moduli sia al rielaborare a lotti tabelle storiche di immunizzazione. Presenti sempre remaining_percent come una stima educativa secondo la definizione di calo fisso; le decisioni cliniche richiedono professionisti qualificati, calendari locali e un contesto di eleggibilità che questo strumento non raccoglie.
Casi di integrazione
Etichette di protezione residua sui cruscotti di immunizzazione
Converta efficacia registrata, conteggi di dosi e mesi dall'ultima dose in un remaining_percent deterministico per ogni record, senza incorporare la matematica di calo in ogni client.
Domande tecniche
Perché un'efficacia fuori da 0-100 fallisce?
L'efficacia vaccinale è una percentuale. Valori sotto 0 o sopra 100 non sono un'efficacia valida, quindi il compito fallisce con invalid_input e non viene addebitato.
remaining_percent equivale a un titolo di laboratorio o a una raccomandazione di richiamo?
No. Il risultato è una percentuale educativa da una formula di calo fisso. Non è un titolo di anticorpi neutralizzanti, una diagnosi né un consiglio di fare un richiamo.
Il calcolatore di immunità vaccinale è gratuito?
Lo strumento del browser è gratuito. Le chiamate API costano $0.002 per richiesta riuscita sul saldo prepagato KIT; la convalida fallita non è mai addebitata.