Calculateur d'efficacité vaccinale
Avec 20 infections sur 1000 vaccinés et 80 sur 1000 sous placebo, l'efficacité vaccinale est de 75 %. Saisissez les quatre chiffres du tableau de résultats d'un essai pour recalculer vous-même le pourcentage annoncé. Gratuit dans votre navigateur.
- Gratuit
- Fonctionne dans votre navigateur
- Sans inscription
- Vos données restent sur votre appareil
Lancer gratuitement
Exemple résolu
- Infections chez les vaccinés
- 20
- Vaccinés (n)
- 1 000
- Infections sous placebo
- 80
- Placebo (n)
- 1 000
- Taux d'attaque chez les vaccinés
- 0,02 percent
- Taux d'attaque sous placebo
- 0,08
- Risque relatif
- 0,25
- Efficacité (%)
- 75
L'efficacité vaccinale est la réduction en pourcentage du risque d'infection chez les personnes vaccinées par rapport à un groupe placebo ou non vacciné observé dans la même fenêtre d'étude. Étudiants, analystes d'essais, journalistes et équipes produit calculent ce pourcentage à partir de quatre nombres : infections dans le bras vacciné, taille du bras vacciné, infections dans le bras placebo et taille du bras placebo. Ce calculateur d'efficacité vaccinale applique l'identité classique d'un moins le risque relatif : divisez le taux d'attaque vacciné par le taux d'attaque du placebo, soustrayez ce risque relatif de un, puis multipliez par cent.
Ce que signifie l'efficacité vaccinale et comment les quatre effectifs deviennent un pourcentage
L'efficacité vaccinale, souvent abrégée VE, est la réduction en pourcentage du risque d'un critère défini chez les personnes qui ont reçu le vaccin par rapport à celles qui ont reçu un placebo ou sont restées non vaccinées. L'estimateur classique des manuels, des dossiers d'agences et des cours d'épidémiologie introductifs est un moins le risque relatif, exprimé en pourcentage. Le risque relatif est le taux d'attaque vacciné divisé par le taux d'attaque du placebo.
Lorsque les deux taux d'attaque sont égaux, l'efficacité est nulle car le vaccin n'a pas modifié le risque dans ce tableau brut. Lorsque le bras vacciné n'a aucune infection et que le bras placebo en a, l'efficacité est de cent pour cent. Lorsque le bras vacciné a un taux d'attaque plus élevé que le placebo, le pourcentage est négatif, et ce calculateur le signale honnêtement au lieu de le ramener à zéro ou de cacher le signe.
Ce point de terminaison n'ajuste pas de courbes de Kaplan–Meier, de modèles de Poisson ni d'intervalles de confiance ; c'est l'identité à quatre effectifs que journalistes et étudiants tapent réellement dans un tableur. Utilisez-le lorsque vous avez déjà des effectifs de cohorte fermée et besoin d'un VE en pourcentage reproductible, non lorsque vous avez encore besoin de personnes-temps, d'un suivi qui se chevauche ou de l'analyse primaire prévue au protocole.
Contrat d'entrée, forme de la réponse et comportement d'erreur
Tout effectif négatif échoue car un essai ne peut pas enregistrer moins trois infections ni une liste négative. Une taille de groupe égale à zéro échoue car le taux d'attaque est infections divisées par n, et la division par zéro est indéfinie. Les effectifs d'infection qui dépassent la taille de leur groupe échouent car un taux d'attaque supérieur à un n'est pas une proportion valable de cohorte fermée.
Si le bras placebo a enregistré zéro infection, le taux d'attaque du placebo est nul et le risque relatif est indéfini, donc la tâche échoue au lieu de renvoyer Infinity. Une validation échouée n'est pas facturée.
Où il est utile et quelles sont ses limites
Les salles de classe et les plateformes de tutorat utilisent un calculateur d'efficacité vaccinale pour que les apprenants vérifient un devoir contre un oracle déterministe plutôt qu'une coquille silencieuse de tableur à l'étape du risque relatif. Une validation échouée ne consomme pas de solde. Il s'agit d'un outil de calcul et d'enseignement, non d'un dispositif médical de diagnostic ni d'un substitut à une analyse prévue au protocole avec personnes-temps, intervalles de confiance qui se chevauchent ou critères réglementaires.
Les personnes qui prennent des décisions de santé personnelle doivent suivre l'avis médical professionnel et l'analyse statistique publiée de l'essai, non un unique pourcentage automatisé. Gardez les requêtes petites, figez les champs arrondis dans les tests, et vous obtenez une efficacité vaccinale reproductible pour devoirs, graphiques de rédaction et workers de bord sans dresser votre propre pile de biostatistique.
Cas d’usage
Journalisme scientifique et explicatifs d'essais
Recalculez l'efficacité vaccinale titrée d'un essai publié à partir des quatre effectifs du tableau de résultats et citez un pourcentage déterministe à côté des chiffres sources.
Questions fréquentes
Comment calcule-t-on l'efficacité vaccinale à partir des effectifs d'infection ?
Le pourcentage d'efficacité est (1 − (ARV/ARU)) × 100, où ARV est infections vaccinées sur n vacciné et ARU infections placebo sur n placebo.
Que se passe-t-il si une taille de groupe est nulle ou un effectif négatif ?
Les effectifs négatifs ne sont pas des données d'essai valides, et une taille de groupe nulle rend le taux d'attaque indéfini. Ces échecs ne sont pas facturés.
L'efficacité vaccinale peut-elle être négative ou dépasser cent pour cent ?
Une efficacité négative est renvoyée lorsque le taux d'attaque vacciné dépasse celui du placebo. Des valeurs au-dessus de cent pour cent n'apparaissent pas pour des effectifs valides de cohorte fermée (les infections ne peuvent pas être négatives, donc ARV ne peut pas descendre sous zéro).
Quelle est la différence entre efficacité vaccinale et effectivité vaccinale ?
Ce calculateur rapporte une efficacité vaccinale de type essai, d'un bras vacciné contre un comparateur placebo ou non vacciné, à partir de quatre effectifs. L'effectivité vaccinale observationnelle issue de personnes-temps réelles ou de schémas test-négatif est une autre analyse et une autre intention de recherche.
Le calculateur donne-t-il un intervalle de confiance ?
Non. Il applique seulement l'identité à quatre chiffres, un moins le risque relatif. Il n'ajuste ni courbes de Kaplan-Meier, ni modèles de Poisson, ni intervalles de confiance, et ne travaille pas en personnes-temps.
Outils associés
Pour les développeurs — accès API
Tout sur cette page est disponible par programmation. Cette section s'adresse aux équipes qui veulent l'intégrer à leurs systèmes ; les autres peuvent simplement utiliser l'outil ci-dessus.
Endpoint
Authentification par jeton Bearer : un seul POST met la tâche en file d’attente, et le résultat vous parvient par webhook ou lien signé.
Appeler depuis votre 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)Exemple de requête
{
"vaccinated_infections": 20,
"vaccinated_n": 1000,
"placebo_infections": 80,
"placebo_n": 1000
}Exemple de réponse
{
"task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
"type": "health.vaccine_efficacy",
"status": "queued",
"_links": {
"result": "/tasks/tsk_…/result"
}
}L’API est asynchrone : chaque appel renvoie un task_id immédiatement, puis vous interrogez l’état à raison d’une requête par seconde.
Tarifs
Le prix est publié, sans tokens ni crédits. Une tâche qui échoue n’est pas facturée.
Erreurs
| HTTP | Code | Signification |
|---|---|---|
401 | unauthorized | Clé API absente ou invalide : vérifiez l’en-tête Authorization. |
402 | insufficient_balance | Solde insuffisant : rechargez votre compte pour lancer cette tâche. |
404 | unknown_type | Type de tâche inconnu : vérifiez le champ type de votre requête. |
429 | rate_limited | Trop de requêtes : ralentissez la cadence, puis réessayez. |
Notes techniques
Le résultat est un efficacy_percent stable que vous pouvez figer dans des tests, des tableurs et des tableaux de bord. Les effectifs négatifs et les tailles de groupe nulles échouent avec invalid_input et ne sont jamais facturés.
Ce que signifie l'efficacité vaccinale et comment les quatre effectifs deviennent un pourcentage
Le taux d'attaque de chaque bras est simplement les infections divisées par la taille de ce bras : vaccinated_infections sur vaccinated_n, et placebo_infections sur placebo_n. Multiplier le complément de ce rapport par cent produit efficacy_percent. Des entrées identiques produisent toujours le même JSON car le chemin est une arithmétique pure, sans réseau, sans modèle, sans graine aléatoire et sans horloge murale.
Contrat d'entrée, forme de la réponse et comportement d'erreur
Envoyez un corps JSON avec quatre nombres finis obligatoires. vaccinated_infections est le nombre d'événements de critère dans le groupe vacciné. vaccinated_n est le nombre de personnes, ou d'unités de liste comparables, de ce groupe et doit être supérieur à zéro. placebo_infections est le nombre d'événements de critère dans le comparateur placebo ou non vacciné. placebo_n est la taille du groupe comparateur et doit être supérieure à zéro. Chaque champ peut arriver comme nombre JSON ou comme chaîne numérique ; des alias documentés tels que vaccinated_cases, n_vaccinated, placebo_cases et unvaccinated_n sont acceptés lorsque le nom canonique est omis. Les champs manquants, les chaînes vides et les valeurs non finies échouent avec invalid_input en nommant le champ. En cas de succès, le corps répète les quatre entrées, rapporte vaccinated_attack_rate et placebo_attack_rate comme proportions, rapporte relative_risk comme leur rapport, et rapporte efficacy_percent comme cent fois un moins ce rapport. unit est toujours percent. formula reformule l'identité pour qu'une interface affiche la ligne pédagogique à côté du nombre. method est toujours one_minus_relative_risk afin que le code en aval branche sans flairer les formes.
Où une API d'efficacité vaccinale gagne sa place, tarif et limites
Les rédactions de vulgarisation scientifique recalculent le VE titré d'un essai publié à partir des quatre effectifs du tableau de résultats et citent efficacy_percent sans redériver l'identité sous délai. Les équipes produit qui stockent déjà tailles de bras et effectifs d'événements dans un entrepôt peuvent poster ces quatre champs et persister efficacy_percent à côté des effectifs bruts pour tableaux de bord et colonnes d'export. Parce que l'implémentation est parse pure de palier A, chaque appel réussi coûte le tarif de base publié $0.002, sans jetons de modèle et sans réseau sortant.
Cas d'intégration
Devoirs d'épidémiologie et notation d'examens
Laissez les étudiants envoyer les effectifs d'infection vaccinés et placebo avec les tailles de groupe et vérifier efficacy_percent contre l'identité classique d'un moins le risque relatif.
Applications d'éducation santé et backends SaaS
Appelez le même contrat à quatre effectifs depuis un widget de navigateur gratuit et depuis la notation API prépayée afin que démos de classe et pipelines de production ne divergent jamais.
Questions techniques
Combien coûte le calculateur d'efficacité vaccinale ?
L'outil du navigateur est gratuit. Les requêtes API utilisent le solde KIT prépayé à $0.002 par appel réussi ; une entrée invalide n'est pas facturée.