Télécharger et réutiliser les données

Les données agrégées publiées sur le portail peuvent être téléchargées et réutilisées sans compte. Cette page rassemble tous les moyens proposés : fichiers CSV (par indicateur, pour le catalogue et pour les prix des denrées), images PNG des graphiques et des cartes, graphiques et cartes intégrables dans un autre site, et formules de citation. Toutes ces fonctions ne diffusent que des valeurs validées au niveau national ; une valeur calculée sur un petit effectif n'est jamais exportée.

Les fichiers CSV #

Les données d'un indicateur #

Ce fichier contient toutes les valeurs diffusables d'un indicateur : d'abord la série nationale, puis les valeurs de chaque province, avec les désagrégations (sexe, milieu de résidence, âge) quand elles existent.

1. Ouvrez la fiche de l'indicateur.
2. Cliquez sur Télécharger les données dans l'en-tête, ou sur CSV sous un graphique, ou sur Fichier CSV dans la section Télécharger, citer, intégrer.
3. Le fichier est enregistré sous le nom <code>-donnees.csv, par exemple nut-01-donnees.csv.

L'adresse du fichier est stable : https://pnisan.bi/indicateurs/<numéro>/donnees.csv. Vous pouvez l'utiliser pour recharger régulièrement les données dans un tableur ou un outil d'analyse.

Le catalogue des indicateurs #

Le catalogue en CSV donne une ligne par indicateur public, avec sa dernière valeur nationale, son évolution, sa source et l'adresse de sa fiche. Vous l'obtenez :

• par Télécharger le catalogue (CSV) sur la page Indicateurs, en tenant compte des filtres de recherche, de système et de périodicité ;
• par Données ouvertes (méga-menu Indicateurs, bloc Tableau de bord de l'accueil) ou Données ouvertes (CSV) (pied de page), à l'adresse https://pnisan.bi/indicateurs.csv ;
• par Catalogue Nutrition (CSV) (ou le système concerné) sur une fiche indicateur.

Le fichier s'appelle catalogue-indicateurs-AAAA-MM-JJ.csv.

Les prix des denrées #

Sur la page Prix des denrées, le bloc Télécharger les données propose le fichier de la denrée affichée et celui de Toutes les denrées suivies (lien Prix des denrées (CSV) du pied de page). Chaque ligne est un relevé d'un marché pour un mois, avec l'éditeur, le jeu de données, la licence et l'adresse de la source.

Ouvrir un fichier CSV #

Tous les fichiers CSV du portail utilisent le point-virgule comme séparateur et l'encodage UTF-8. Les fichiers d'indicateurs utilisent la virgule comme séparateur décimal. Ils s'ouvrent directement dans un tableur configuré en français.

Les images PNG #

Le tableau de bord permet aussi Valeurs de la carte (CSV), Série complète de l'indicateur (CSV) et Imprimer ou enregistrer en PDF. Ces boutons nécessitent JavaScript.

Intégrer un graphique dans un autre site #

Chaque indicateur possède une version intégrable de son graphique de tendance nationale, à l'adresse https://pnisan.bi/integrer/indicateurs/<numéro>.

1. Sur la fiche de l'indicateur, cliquez sur Intégrer ou descendez à la section Télécharger, citer, intégrer.
2. Dans le bloc Graphique intégrable, cliquez sur Voir l'aperçu pour contrôler le rendu dans un nouvel onglet.
3. Cliquez sur Copier le code. Le message Code copié confirme l'opération.
4. Collez le code dans votre page, en mode HTML, à l'endroit voulu.

Le code insère un cadre <iframe> de 520 pixels de hauteur. Le graphique intégré affiche le titre, l'unité, la zone, le menu Options (Télécharger les données (CSV), Télécharger l'image (PNG)), le lien Voir le tableau des données, la source, la date de mise à jour et le lien Voir la fiche complète sur PNISAN. Il se met à jour automatiquement à chaque nouvelle validation.

Intégrer une carte #

La carte des provinces du tableau de bord peut aussi être intégrée, à l'adresse https://pnisan.bi/integrer/carte.

1. Ouvrez le tableau de bord et réglez l'indicateur, la période, le découpage et les classes voulus.
2. Cliquez sur Intégrer dans la barre d'actions. La fenêtre Intégrer cette carte s'ouvre avec le code et un aperçu.
3. Cliquez sur Copier, puis collez le code dans votre page.

Le code reprend les paramètres de la vue, par exemple /integrer/carte?indicateur=12&decoupage=anciennes&periode=2024-01-01, dans un cadre de 640 pixels de hauteur. La carte intégrée montre la période, le titre, la carte avec la légende, la source et le lien Voir la fiche complète sur PNISAN. Sans paramètre, elle affiche l'indicateur par défaut du tableau de bord.

Citer les données #

Précisez toujours la période de la valeur et sa source d'origine (colonne Source des fichiers). Les valeurs du dernier mois des prix, provisoires, peuvent encore être corrigées par l'éditeur.

Conditions de réutilisation #

• Indicateurs : « Licence ouverte, réutilisation libre avec mention de la source : PNISAN, SEP/PMSAN ». Cette mention figure sur chaque fiche indicateur (bloc Citer cet indicateur), sur la fiche en fenêtre du tableau de bord, et en dernière ligne de chaque fichier CSV, précédée de « Conditions de réutilisation : ».
• Prix des denrées : ils sont publiés par le Programme alimentaire mondial sous « Licence CC BY-IGO : réutilisation libre avec mention de la source. »
• Publications : elles restent la propriété de leurs éditeurs ; reportez-vous à leurs conditions.

Pour aller plus loin #

• La fiche d'un indicateur
• Le catalogue des indicateurs
• Contact et communauté