Retour à la leçon·Leçon 3 sur 8·Ce qui voyage avec le nombre
Arrêté à quand, depuis quoi, et à quelle fréquence
Le même diaporama que les téléchargements, rendu sous forme de page. Lancez le diaporama pour le présenter en plein écran — les flèches ou un clic avancent d'une diapositive, Échap quitte.
Ce que couvre cette leçon
- Les trois questions
- À quoi ressemblent les réponses
- L'actualisation, énoncée comme une cadence et un responsable
- La complétude va à côté du nombre
- Ce qu'énoncent les tableaux de bord de la plateforme
- Là où la provenance est mince, dites-le
- Rapportez-le en entier
- La suite
Notes du présentateur
Les trois questions posées à chaque nombre d'un tableau de bord, chaque mois, par quelqu'un qui n'était pas dans l'analyse. Y répondre sur la page coûte une ligne chacune et convertit une dispute récurrente en un coup d'œil récurrent.Les trois questions
- « Arrêté à quand ? » — Un chiffre de couverture sans date est un chiffre qui sera cité en mars prochain
- « Depuis quoi ? » — Quel export, quelle version, quelle extraction de la base — et si c'est le même que celui du…
- « À quelle fréquence change-t-il ? » — Si le nombre devant eux date de ce matin ou du trimestre dernier, et si revenir…
- Répondez aux trois sur la page — Chacune fait une ligne, et l'alternative est d'y répondre onze fois par courriel
Notes du présentateur
Elles arrivent dans cet ordre, de quelqu'un qui vous fait confiance et doit défendre le nombre devant quelqu'un qui ne vous la fait pas. « Arrêté à quand ? » Un chiffre de couverture sans date est un chiffre qui sera cité en mars prochain. « Depuis quoi ? » Quel export, quelle version, quelle extraction de la base — et si c'est le même que celui du rapport précédent. « À quelle fréquence change-t-il ? » Si le nombre devant eux date de ce matin ou du trimestre dernier, et si revenir voir la semaine prochaine vaut la peine. Répondez aux trois sur la page. Chacune fait une ligne, et l'alternative est d'y répondre onze fois par courriel.À quoi ressemblent les réponses — Exemple
Source: wash-household-survey-2024.v1.csv Data as of: 2024-11-30 (survey round 1) Refreshed: when a new survey round is published; this is a single roundÀ quoi ressemblent les réponses
- Nommez le fichier, non le système — « Depuis DHIS2 » dit d'où cela vient ; le nom et la version de l'export sont ce que…
- Versionnez par le nom de fichier —
.v1.csvest ce qui rend « le même fichier que le rapport de mars » vérifiable - Distinguez la date des données de la date de compilation — Elles diffèrent et une seule intéresse le lecteur
Notes du présentateur
Nommez le fichier, non le système. « Depuis DHIS2 » dit d'où cela vient ; le nom et la version de l'export sont ce que quelqu'un peut aller chercher. Versionnez par le nom de fichier..v1.csvest ce qui rend « le même fichier que le rapport de mars » vérifiable. Une correction est livrée en.v2et n'écrase jamais, règle que suivent les jeux de données de cette plateforme et raison pour laquelle un carnet accroché à la v1 continue de reproduire. Distinguez la date des données de la date de compilation. Elles diffèrent et une seule intéresse le lecteur.À quoi ressemblent les réponses
Signifie Sur la page ? Données arrêtées au La dernière observation du fichier Oui, bien en vue Date d'extraction Quand l'export a été tiré Si elles diffèrent sensiblement Date de compilation Quand le HTML a été écrit Non À quoi ressemblent les réponses
- La date de compilation est celle que tout le monde met et dont personne n'a besoin — Elle change à chaque…
- Aucun des sept tableaux de bord d'ici ne porte de date de production — et c'est pourquoi les reconstruire produit des…
Notes du présentateur
La date de compilation est celle que tout le monde met et dont personne n'a besoin. Elle change à chaque reconstruction, n'apprend rien sur les données, et — comme l'a établi le cours sur les chaînes reproductibles — rend la sortie non déterministe, si bien qu'un diff cesse de signifier quoi que ce soit. Aucun des sept tableaux de bord d'ici ne porte de date de production, et c'est pourquoi les reconstruire produit des fichiers identiques à l'octet près.L'actualisation, énoncée comme une cadence et un responsable — Exemple
Refreshed monthly, on the 5th, from the screening database export. Owner: the M&E officer. If the export has not arrived by the 10th, the page still shows the previous month and says so.L'actualisation, énoncée comme une cadence et un responsable
- Une cadence sans responsable est un vœu — La ligne utile nomme qui le fait et ce qui se passe quand cela n'est pas fait
- Dites à quoi ressemble une page périmée — Le mode d'échec est un tableau de bord montrant silencieusement le mois…
Notes du présentateur
Une cadence sans responsable est un vœu. La ligne utile nomme qui le fait et ce qui se passe quand cela n'est pas fait. Dites à quoi ressemble une page périmée. Le mode d'échec est un tableau de bord montrant silencieusement le mois dernier pendant que tout le monde le croit à jour. Une page qui énonce sa date de données rend la péremption visible sans aucune machinerie.La complétude va à côté du nombre — En Python
submitted = reports[reports["report_submitted"]].shape[0] print(f"reporting completeness: {submitted / len(reports):.1%}")Notes du présentateur
C'est la question de provenance que ce secteur a et que d'autres n'ont pas.La complétude va à côté du nombre
- Un chiffre de couverture calculé depuis 76 % des formations sanitaires est un autre nombre que celui calculé depuis 99…
- La complétude va donc sur la page — à côté de tout indicateur dont le dénominateur dépend de qui a rapporté
- Et un mois sans rapports est tracé comme un trou, jamais comme un zéro — Zéro est une affirmation que rien ne s'est…
Notes du présentateur
Un chiffre de couverture calculé depuis 76 % des formations sanitaires est un autre nombre que celui calculé depuis 99 %, et le cours d'épidémiologie a consacré une leçon à un mois où la complétude est tombée à 28,9 % et le nombre de cas avec elle. La complétude va donc sur la page, à côté de tout indicateur dont le dénominateur dépend de qui a rapporté. Le tableau de bord vaccination d'ici la porte comme une tuile pour exactement cette raison. Et un mois sans rapports est tracé comme un trou, jamais comme un zéro. Zéro est une affirmation que rien ne s'est passé.Ce qu'énoncent les tableaux de bord de la plateforme — Exemple
Source: protection-referrals-2024.v1.csv How these numbers are produced: computed from the committed dataset file named above by scripts/export/build-project-dashboards.mjs. Nothing is typed by hand and the page contains no script, no external request and no generation date, so rebuilding it on unchanged data produces an identical file.Ce qu'énoncent les tableaux de bord de la plateforme
- La dernière proposition est la plus forte affirmation de provenance disponible — et elle est vérifiable par quiconque a…
- « Rien n'est saisi à la main » est la partie qui compte pour un relecteur — Un nombre saisi dans une légende peut…
Notes du présentateur
La dernière proposition est la plus forte affirmation de provenance disponible, et elle est vérifiable par quiconque a le dépôt : reconstruisez, etgit statusest vide. « Rien n'est saisi à la main » est la partie qui compte pour un relecteur. Un nombre saisi dans une légende peut dériver du graphique au-dessus, et rien ne le détecte — c'est l'échec que la dernière leçon du cours de visualisation existe pour prévenir.Là où la provenance est mince, dites-le
- Un nombre venant d'une autre agence — « 4W du cluster, soumission de février » est une provenance ; « données du…
- Un dénominateur issu d'une projection — Les chiffres de population sont généralement projetés depuis un recensement, et…
- Un nombre que quelqu'un a ajusté — Si l'entrée manifestement fausse d'une formation sanitaire a été corrigée avant…
Notes du présentateur
Trois cas, et les nommer vaut mieux que l'alternative. Un nombre venant d'une autre agence. « 4W du cluster, soumission de février » est une provenance ; « données du cluster » non. Si vous ne pouvez pas le versionner, dites quand vous l'avez reçu et de qui. Un dénominateur issu d'une projection. Les chiffres de population sont généralement projetés depuis un recensement, et l'année de base de la projection est la provenance dont un lecteur a besoin. Le taux brut de scolarisation de 109,2 % du cours d'éducation est une histoire de dénominateur, non d'inscription. Un nombre que quelqu'un a ajusté. Si l'entrée manifestement fausse d'une formation sanitaire a été corrigée avant analyse, c'est une décision et elle a sa place dans la documentation technique, la page pointant vers elle.Rapportez-le en entier — Exemple
Provenance panel Source wash-household-survey-2024.v1.csv 2,403 households, 18 communities, 3 districts Data as of 2024-11-30, survey round 1 Refresh single round; no monthly cadence. A second round is planned for 2025 and will make a trend meaningful. Completeness water quality tested on 33.4% of households; every quality figure states that denominator separately Produced by scripts/export/build-project-dashboards.mjs, from the committed file. No hand-entered numbers, no generation date, byte-identical on rebuild. Definitions docs/indicator-definitions.mdRapportez-le en entier
- La dernière ligne est le passage de relais vers la leçon suivante — Un panneau de provenance dit d'où vient le nombre ;…
Notes du présentateur
La dernière ligne est le passage de relais vers la leçon suivante. Un panneau de provenance dit d'où vient le nombre ; un panneau de définitions dit ce qu'il est, et les deux ensemble sont ce qui empêche la même dispute de revenir chaque mois.La suite
- Deux artefacts de cette plateforme ont calculé la couverture en eau améliorée depuis le même fichier et obtenu des réponses différentes.
Notes du présentateur
Deux artefacts de cette plateforme ont calculé la couverture en eau améliorée depuis le même fichier et obtenu des réponses différentes. La leçon suivante porte sur le panneau qui l'aurait attrapé — et sur le fait qu'il l'a attrapé.