Computree Documentation

Export d'attributs dans une boucle

Plugin : Base
Nom de classe : PB_StepExportAttributesInLoop

Description

Cette étape permet d'exporter des données au sein d'une boucle, en prenant en compte les tours surccessifs. Tout attribut de n'importe quel item peut être exporté.
Cette étape propose 3 types d'exports différents, pouvant être réalisés en parallèle ou non :
  • Un export sous forme de fichier texte, avec une ligne par item et tour de boucle, et une colonne par attribut. Un seul fichier est produit, regroupant les données de tous les tours de boucle.
  • Un export sous forme de raster, produisant un fichier raster par attribut et par tour de boucle. Pour que cet export puisse être utilisé, il faut que les données soient organisées sous forme de grille spatiale.
  • Un export sous forme de vecteur (points en 2D avec attributs), produisant un fichier vecteur par tour de boucle, avec une ligne par item, et une colonne par attribut. Cela nécessite que parmi les attributs figurent des coordonnées (x;y), auquelles assosicer les autres attributs.
Il est possible d'utiliser cette étape en dehors d'une boucle, même si ce n'est pas son usage prévu, en sélectionnant l'option correspondante.

Paramètres

Paramètres de pré-configuration (non modifiables une fois l'étape ajoutée) :

  • Activer export ASCII tabulaire (1 fichier en tout): Activé.

  • Activer export raster (1 fichier / tour / métrique): Désactivé.


L'export raster nécessite une grille de placettes (désactiver si pas de résultat valide)
  • Activer export vectoriel (1 fichier / tour): Désactivé.

  • Export dans une boucle (cas normal): Désactivé.

Paramètres de l'étape :


Export ASCII tabulaire (1 fichier en tout)
  • Choix du fichier: extension : Fichier texte (*.txt).
    S'il existe déjà, le fichier sera écrasé. Le fichier contiendra les données pour tous les tours de boucle.


Export raster (1 fichier / tour / métrique)
  • Prefixe pour les fichiers exportés: (vide).
    Un prefixe optionnel peut être ajouté à tous les noms de fichier, pour par exemple identifier différents lancements du script, exportant dans un même répertoire.

  • Choix du format d'export: PB_Grid2DExporter.
    Format raster à utiliser pour les exports.

  • Répertoire d'export (vide de préférence):
    Le contenu du dossier sélectionné ne sera pas effacé. Cependant pour plus de clarté il est préférable de choisir un dossier vide.

  • Créer un sous-dossier par métrique: Activé.
    Si cette case est cochée, un dossier séparé sera créé pour achaque attribut à exporter, contenant chacun un raster par tour de boucle.


Export vectoriel (1 fichier / tour)
  • Prefixe pour les fichiers exportés: (vide).
    Un prefixe optionnel peut être ajouté à tous les noms de fichier, pour par exemple identifier différents lancements du script, exportant dans un même répertoire.

  • Choix du format d'export: GDAL ESRI Shapefile.
    Format vecteur à utiliser pour les exports.

  • Répertoire d'export (vide de préférence):
    Le contenu du dossier sélectionné ne sera pas effacé. Cependant pour plus de clarté il est préférable de choisir un dossier vide.

Données d'entrée

Structure des données d'entrée recherchées :

Result : Résultat
    ...
        Group (Group)
            Group (Group)
                Item avec des attributs (Item) - Optionnel
                    Attribut à exporter (ANY) - Optionnel


Le type de données d'entrée nécessaire dépend des exports activés.
Dans tous les cas il faut sélectionner les attributs à exporter.
Pour les exports raster, il faut sélectionner un objet "Grille de placettes", par exemple généré par l'étape "Créer une grille de placettes sur l'emprise".
Pour les exports vecteurs (et aussi raster), il faut également séléctionner des attributs pour les coordonnées (x;y) auxquelles les attributs seront associés spatialement.

Comme il s'agit d'un export au sein d'une boucle, il faut également sélectionner le compteur de boucle (sauf si l'option d'export hors boucle a été choisi).

Données de sortie

Cette étape ne génère pas de nouvelles données.

Détails

A noter que les trois types d'exports sont indépendants, même s'ils exportent les mêmes attributs.