Exports¶

Cette page vous indique comment obtenir des données et des rapports hors de LUC Analytics (LUCA), et quand chaque export n'est pas disponible.

Dans cette page, une commande ou une étiquette de l'application est en gras. Un message de l'application est entre "guillemets droits".

Résumé des exports¶

Export	Emplacement de la commande	Format	Nom du fichier
Résultats de la liste, post-2020	Le menu ⋯ de la liste sur la page des listes, élément Exporter	CSV	`<list name> - post2020.csv`
Résultats de la liste, post-2020	L'onglet ÉVALUATION DU RISQUE POST-2020 d'une liste, bouton ⬇ Télécharger le CSV	CSV	`<list name> - post2020.csv`
Résultats de la liste, alertes	L'onglet ALERTES DE PERTURBATION RÉCENTES d'une liste, bouton ⬇ Télécharger le CSV	CSV	`<list name> - alerts.csv`
Un emplacement	Le panneau Détails de l'emplacement, bouton ⬇ Télécharger le CSV	CSV	`<list name> - location <id> detail.csv`
Rapport d'un emplacement	Le panneau Détails de l'emplacement, bouton Télécharger le PDF	PDF	`location-<id>-report.pdf`
Données utilisées	Avec chaque export CSV, comme deuxième fichier	CSV	`<CSV name>.data-used.csv`
Modèle de légende de carte	La légende de la carte, Modèles de carte enregistrés, bouton Enregistrer	`.mpky` (JSON)	`mapkey_0001.mpky` ou le nom que vous saisissez

Si le nom de la liste ne donne pas de nom de fichier utilisable, l'application utilise l'ID de la liste, par exemple list-<list id>-post2020.csv ou location-<id>-detail.csv. L'application remplace les caractères que Windows, macOS ou Linux n'acceptent pas dans un nom de fichier.

Quand un export est disponible¶

Le navigateur et le serveur font chacun un contrôle avant un export. Les deux contrôles utilisent la même règle :

Un export d'une liste complète est disponible uniquement quand l'analyse de la liste est complète.
Un export d'un emplacement est disponible uniquement quand l'analyse de cet emplacement est terminée.

Export	Condition nécessaire
CSV de la liste et son fichier des données utilisées (Exporter et les deux boutons ⬇ Télécharger le CSV)	Le statut de la liste est complet. Avant cela, l'info-bulle affiche "L'export CSV sera disponible une fois l'analyse de cette liste terminée."
CSV de l'emplacement et son fichier des données utilisées	Chaque analyse de la liste est terminée pour cet emplacement.
PDF de l'emplacement	L'analyse post-2020 de cet emplacement est terminée. La carte doit aussi être prête pour la capture.

Voici les résultats des contrôles :

Vous ne pouvez pas exporter le CSV d'une liste qui n'est pas complète. Une liste avec l'étiquette Incomplète (par exemple, après Arrêter et valider) reste dans cette condition. Pour une telle liste, exportez chaque emplacement terminé.
Vous pouvez télécharger le CSV ou le PDF d'un emplacement terminé. Les autres emplacements de la liste n'ont pas besoin d'être terminés.
Le PDF d'un emplacement d'une liste qui n'est pas complète a une remarque, par exemple "Rapport généré à partir d'une liste partiellement analysée — 40/50 emplacements analysés (80%)". Si l'application ne peut pas compter les emplacements, la remarque est "Rapport généré à partir d'une liste partiellement analysée — nombre d'emplacements analysés non confirmé".
L'application n'écrit pas de zéro à la place d'une valeur qu'elle n'a pas calculée. Il n'y a pas de dérogation pour ces contrôles.

Si le serveur refuse un export, l'application affiche un de ces messages :

"Export indisponible — aucun emplacement de cette liste n'a encore été analysé, il n'y a donc rien à exporter."
"L'export CSV sera disponible une fois l'analyse de cette liste terminée."
"Export indisponible — l’analyse de cet emplacement n’est pas terminée. L’export sera disponible une fois que toutes ses analyses seront terminées."
"Export PDF indisponible — aucun emplacement n'a encore été analysé pour cette liste."

Pour plus d'informations sur les états d'analyse, consultez 03-analysis-and-results.md.

Exporter les résultats d'une liste en CSV¶

Vous pouvez démarrer l'export post-2020 depuis la page des listes ou depuis la liste. Les deux commandes donnent le même fichier.

Depuis la page des listes :

Allez sur la page des listes (Listes).
Sur la ligne de la liste, appuyez sur ⋯.
Sélectionnez Exporter.

Depuis la liste :

Ouvrez la liste.
Sélectionnez l'onglet ÉVALUATION DU RISQUE POST-2020 ou l'onglet ALERTES DE PERTURBATION RÉCENTES.
Si vous utilisez l'onglet des alertes, réglez les dates des alertes sur la puce de date Alertes. Le CSV utilise les mêmes dates.
Appuyez sur ⬇ Télécharger le CSV.

Le navigateur télécharge deux fichiers : le CSV et son fichier des données utilisées. Pour le fichier des données utilisées, consultez "Le fichier des données utilisées" plus bas.

Contenu du CSV post-2020¶

Le CSV a une ligne pour chaque emplacement. Les colonnes sont :

L'identité de l'emplacement : location_id, location_name, load_order, status, centroid_lat, centroid_lon.
La date d'analyse et la version du jeu de données : post2020_analysis_date, post2020_dataset_version.
Les superficies en hectares : total_area_ha, sbtn_area_ha, jrc_area_ha, et les indicateurs sbtn_flag et jrc_flag.
La perte après 2020 pour chaque carte de forêt de référence : sbtn_loss_ha_post2020, jrc_loss_ha_post2020. Il y a aussi une colonne pour chaque année de perte, par exemple sbtn_loss_ha_2021.
Les facteurs de perte du couvert arboré : une colonne driver_<name>_ha pour chaque facteur. Ensuite dominant_driver, dominant_share, dominant_is_mixed et dominant_is_none.
Les erreurs : error_code et explanation.
L'état : finished_state, list_status, list_locations_computed, list_locations_total.

Contenu du CSV des alertes¶

Le CSV des alertes a une ligne pour chaque emplacement. Il a les mêmes colonnes d'identité, de superficie, d'erreur et d'état que le CSV post-2020. Il a aussi ces colonnes : alerts_analysis_date, alerts_dataset_version, alert_area_ha, alert_sbtn_area_ha, alert_jrc_area_ha, window_start et window_end. Les deux colonnes de fenêtre affichent les dates des alertes que le fichier compte.

Exporter un emplacement en CSV¶

Ouvrez la liste.
Sur la ligne de l'emplacement, appuyez sur DÉTAILS. Le panneau Détails de l'emplacement s'ouvre.
Appuyez sur ⬇ Télécharger le CSV.

Le CSV a une ligne. Il contient les colonnes d'identité, de superficie, de perte et de facteurs du CSV post-2020, et les colonnes d'alertes du CSV des alertes. Il contient aussi la colonne annotation, qui est votre remarque sur l'emplacement. Le navigateur télécharge aussi le fichier des données utilisées pour cet emplacement.

Télécharger un rapport PDF d'un emplacement¶

Ouvrez la liste.
Sur la ligne de l'emplacement, appuyez sur DÉTAILS.
Attendez que la carte du panneau Détails de l'emplacement soit entièrement dessinée.
Appuyez sur Télécharger le PDF.

Avant de faire le PDF, l'application attend les tuiles du fond de carte et les couches d'analyse. Si elles ne sont pas prêtes, l'application ne fait pas le fichier. Elle affiche un message qui vous indique la cause. Par exemple : "Export PDF indisponible — en attente de : le chargement des tuiles du fond de carte (6 sur 9 chargées). Veuillez patienter et réessayer."

Le PDF est au format paysage. Il contient ces éléments :

Un titre : le nom et l'ID de l'emplacement.
Une remarque, uniquement si la liste n'est pas complète. La remarque donne le nombre d'emplacements terminés. Consultez "Quand un export est disponible" plus haut.
Deux images de carte : "Limite sur fond de carte" et "Limite + couches d’analyse actives sur fond de carte".
"Paramètres des couches utilisés pour ces images". Cette partie donne la couleur et l'opacité de chaque couche, les années de perte, les dates des alertes et la résolution de la carte.
Les détails de l'emplacement : le nom, la superficie et vos remarques.
Le tableau de la perte de forêt pour chaque année, pour la carte de forêt SBTN et la carte de forêt JRC.
Les alertes, si la liste a l'analyse des alertes.
Les facteurs de perte du couvert arboré, sous forme de graphique circulaire avec une légende. S'il n'y a pas de données de facteurs, le PDF l'indique.
"Données utilisées" : les jeux de données et leurs versions.
"Comment citer les données" : le texte d'attribution.

REMARQUE : Les images de carte peuvent être plus grandes qu'à l'écran. Le PDF vous indique alors l'échelle, par exemple "Panneaux cartographiques mis à l'échelle ×2.00 par rapport à la résolution à l'écran pour ce rapport."

Pour les commandes de la carte qui modifient les images, consultez 04-maps.md.

Le fichier des données utilisées¶

Chaque export CSV a un deuxième fichier. Son nom est le nom du CSV avec .data-used.csv à la place de .csv. Il contient une ligne pour chaque jeu de données source, avec ces colonnes : dataset, version_id, date, date_kind, local_or_s3, profile, currency_at_run, hash, location.

Si l'analyse a eu lieu avant que l'application n'enregistre les dates des jeux de données, le fichier a une ligne avec le texte millésime non enregistré.

Le CSV peut se télécharger alors que le fichier des données utilisées ne se télécharge pas. L'application affiche alors "Le CSV a été téléchargé, mais son fichier annexe « Données utilisées » (les dates des jeux de données sources) n’a pas pu être téléchargé." Appuyez à nouveau sur le bouton pour obtenir les deux fichiers.

Format des fichiers CSV¶

Le texte est en UTF-8 avec une marque d'ordre des octets (BOM). Les lignes se terminent par CR LF.
Les premières lignes sont le texte d'attribution. Chacune de ces lignes commence par #. La ligne d'en-tête du tableau vient après elles.
Les nombres n'ont pas de séparateur des milliers. Les superficies ont au maximum 4 décimales.
Une cellule est vide quand l'application n'a pas de valeur pour elle, par exemple pour un emplacement avec une erreur. L'application n'écrit pas de zéro à la place d'une valeur qu'elle n'a pas calculée.

REMARQUE : Si une cellule de texte commence par =, +, -, @ ou une tabulation, l'application met ' avant le texte. Ainsi, un tableur ne lit pas le texte comme une formule.

Pour lire le tableau dans un programme, indiquez au programme d'ignorer les lignes qui commencent par #. Par exemple, dans pandas, utilisez read_csv(..., comment="#").

Attribution et licences¶

Les "Conditions d'utilisation spéciales du WRI pour GNW Self-Hosted Monitoring" s'appliquent aux données. Vous devez attribuer les données quand vous partagez un résultat. Vous ne devez pas suggérer que le WRI vous soutient, vous parraine, vous certifie ou vous approuve, ou soutient, parraine, certifie ou approuve votre utilisation des données.

L'application ajoute le texte d'attribution à chaque export CSV et à chaque rapport PDF. Ce texte est dans la langue de l'application. Il a ces parties :

La citation GNW, avec la date d'accès : "Global Nature Watch. [année]. World Resources Institute. Consulté le [date]." La date d'accès est la date à laquelle la dernière exécution de la liste s'est terminée.
La citation de chaque jeu de données que l'export utilise, avec sa licence.
"Calculé avec LUC Analytics, un projet indépendant, selon des méthodes adaptées des scripts publiés par le WRI (post2020.py, GNW Self-Hosted Monitoring). Le WRI ne cautionne ni ce projet ni ses résultats."
"L'utilisation de ces données est soumise aux Conditions d'utilisation spéciales du WRI pour GNW Self-Hosted Monitoring : https://www.wri.org/about/legal/gnw-shm-tos"

Les jeux de données de chaque export sont :

Export	Jeux de données
CSV post-2020	Perte de couvert arboré, Forêts naturelles SBTN, Couvert forestier mondial JRC 2020, Causes dominantes de la perte forestière
CSV des alertes	Alertes de perturbation intégrées mondiales, Forêts naturelles SBTN, Couvert forestier mondial JRC 2020
CSV de l'emplacement et PDF de l'emplacement	Les cinq jeux de données ci-dessus

Les licences sont :

Licence	Jeux de données
CC BY 4.0	Perte de couvert arboré, Forêts naturelles SBTN, Causes dominantes de la perte forestière, Alertes de perturbation intégrées mondiales
Gratuit, sans restriction d'utilisation (règlement Copernicus de la Commission européenne)	Couvert forestier mondial JRC 2020

Pour une liste avec des données de démonstration synthétiques, le texte d'attribution est différent. Il indique "Données de démonstration synthétiques générées par LUC Analytics. Aucun jeu de données du WRI n'a été lu pour ces chiffres."

Pour lire le texte d'attribution dans l'application, appuyez sur Sources de données et licences en bas de la page. Le texte complet est dans le fichier DATA-ATTRIBUTION.md du dépôt du projet.

ATTENTION : Gardez les lignes d'attribution quand vous copiez des données d'un CSV dans un autre fichier. Si vous les supprimez, le nouveau fichier n'indique pas aux lecteurs la source et la licence des données.

Enregistrer un modèle de légende de carte¶

Un modèle de légende de carte garde les paramètres des couches de la carte dans un fichier, pour que vous puissiez les utiliser à nouveau. Ce n'est pas un export de résultats.

Dans la légende de la carte, trouvez Modèles de carte enregistrés.
Saisissez un nom dans Nom du fichier, ou gardez le nom par défaut.
Appuyez sur Enregistrer.

Le fichier est un document JSON avec l'extension .mpky. Pour utiliser le fichier à nouveau, appuyez sur Charger…. Pour plus d'informations, consultez 04-maps.md.

Export en ligne de commande¶

Le programme a aussi la commande luc-analytics export pour les administrateurs. Elle écrit le CSV d'une liste (--analysis post2020 ou --analysis alerts) ou d'un emplacement (--analysis detail --location-id <id>). Les arguments --start et --end règlent les dates des alertes. L'argument --output règle le fichier. Sans --output, la commande écrit sur la sortie standard.

La commande utilise les mêmes contrôles que l'application. Pour une liste entière, la liste doit être complète. Pour un seul emplacement, cet emplacement doit être terminé. Si le contrôle échoue, la commande n'écrit pas de fichier. Elle affiche un message qui commence par export_refused: et s'arrête avec le code de sortie 1. La commande n'écrit pas le fichier des données utilisées.