Outdated version of the documentation. Find the latest one here.

17.9. Le journal de progression

Note

Cette leçon décrit le journal de progression

Toutes les analyses effectuées avec le module de traitements sont enregistrées dans son propre système de suivi du journal. Cela vous permet d’en savoir plus à propos de ce qui a été fait avec les outils de traitement, pour résoudre des problèmes quand ils surviennent, et aussi de re-exécuter les opérations précédentes, puisque le système de suivi du journal met également en oeuvre une certaine interactivité.

Pour ouvrir le journal, sélectionnez l’entrée correspondante dans le menu de traitement. Vous verrez la boîte de dialogue suivante.

../../../_images/log.png

Elle contient quatre blocs d’information : Info, Erreur, Avertissements et Algorithmes. Voici une description de chacun d’entre eux.

  • Info. Certains algorithmes peuvent laisser ici des informations sur leur exécution. Par exemple, ces algorithmes qui appellent une application externe enregistrent habituellement la sortie de la console de l’application dans cette entrée. Si vous jetez un oeil à celle-ci, vous verrez que la sortie de l’algorithme SAGA que nous venons de faire tourner (et qui n’est pas parvenu à s’exécuter car les données d’entrée n’étaient pas correct) est stockée ici.

../../../_images/log-saga.png

Ceci est utile pour comprendre ce qui se passe. Les utilisateurs avancés seront capables d’analyser cette sortie pour trouver pourquoi l’algorithme n’a pas pu s’exécuter. Si vous n’êtes pas un utilisateur avancé, ceci permettra aux autres personnes de vous aider à diagnostiquer le problème, qui peut être un problème dans l’installation du logiciel externe ou un problème avec les données que vous avez fournies.

  • Avertissements Même si l’algorithme pourrait être exécuté, des algorithmes peuvent laisser des messages d’avertissements dans le cas où le résultat pourrait ne pas être correct. Par exemple, lors de l’exécution d’un algorithme d’interpolation avec un très petit amas de points. L’algorithme peut tourner et produira un résultat, mais il est probable qu’il ne sera pas correct, étant donné que plusieurs points doivent être utilisés. C’est une bonne idée de vérifier régulièrement ce type d’avertissements si vous n’êtes pas sûr de certains aspets pour

  • Erreurs. Les erreurs qui apparaissent et ne sont pas directement liées à des applications externes sont enregistrées dans cette section.

  • Algorithmes. Tous les algorithmes qui sont exécutés, même s’ils sont lancés depuis le GUI et non depuis la console (dont on parlera plus tard dans ce manuel), sont stockés dans cette parties du journal comme un appel de console. Cela signifie que chaque fois que vous lancez un algorithme, une commande de console est ajoutée au journal, et vous avez l’historique entier de votre session de travail. Voici à quoi ressemble cet historique de travail.

../../../_images/history1.png

Il peut être très utile lorsque l’on commence à travailler avec la console, d’apprendre la syntaxe des algorithmes. Nous l’utiliserons lorsque nous discuterons de comment lancer des commandes d’analyses depuis la console.

L’historique est aussi interactif, et vous pouvez re-exécuter chaque algorithme précédent simplement en double–cliquant sur son entrée. C’est une façon simple de répéter le travailler que nous avons déjà fait avant.

Par exemple, essayez ce qui suit. Ouvrez les données correspondantes au premier chapitre de ce manuel et exécuter l’algorithme expliqué ici. Rendez-vous maintenant à la boîte de dialogue du journal et localisez le dernier algorithme dans la liste, qui correspond à l’algorithme que nous venons d’exécuter. Double–cliquez dessus et un nouveau résultat devrait être produit, simplement comme lorsque vous l’avez lancé en utilisant la boîte de dialogue normale et en l’appelant depuis la boîte à outils.

17.9.1. hard Avancé

Vous pouvez également modifier l’algorithme. Simplement copiez-le, ouvrez Extensions ‣ Console Python, cliquez sur Importer une classe ‣ Importer une classe de traitement, puis collez-le pour re-lancer l’analyse ; modifiez le texte à volonté. Pour afficher le fichier obtenu, tapez iface.addVectorLayer('/chemin/nomdufichier.shp', 'Nom de la couche dans la légende', 'ogr').