Project

General

Profile

...english version of this page

Premiers pas avec CompuTree

 

Organisation générale de l’interface graphique

ComputreeGUI est l’interface graphique standard pour Computree. Elle permet la gestion des étapes et de leurs résultats, ainsi que leur affichage paramétrable dans des vues 2D, 3D ou tabulaire.

Éléments de l’interface CompuTree:

{1} Barre de menu

{2} Barre d’outils

{3} Gestionnaire d’étapes

{4} Gestionnaire de modèle

{5} Configurateur d’items

{6} Fenêtre d’étapes

{7} Fenêtre d’affichage (vue 2D ou 3D)

{8} Vue tabulaire

{9} Gestionnaire d’actions

{10} Gestionnaire de synchronisation des vues

{11} Fenêtre de log (historique)

 

La barre d’outils {2} reprend sous forme d’icône la plupart des fonctionnalités présentes dans la Barre de menus {1}:

Icone Fonction Raccourcis clavier
Ouvrir un fichier CTRL + O
Afficher la fenêtre d’Étapes F2
Lancer les traitements F3
Arrêter les traitements
Enregistrer l’arbre des étapes CTRL + S
Valider en mode manuel F4
Lancer les traitements en mode debug F5
Lancer les traitements en mode debug et avancer de N pas F6
Lancer les traitements en mode debug, avancer de N pas incluant un temps d’arrêt
Ajouter un document 3D F7
Ajouter un document 2D F8
Ajouter un document de type tableur F9
Configurations générales
Nettoyer toutes les vues F10
Aide F1

Le gestionnaire d’étape {3} est l’élément central, car il permet de créer et d’exécuter l’arbre des étapes. Ce composant permet de créer une hiérarchie d’étapes compatibles entre elles. Une fois les traitements exécutés, chaque étape porte les résultats qu’elle a créés.

La première colonne contient le nom des étapes. De petites flèches permettent de déplier et replier la hiérarchie affiliée à chaque étape. La seconde colonne permet d’activer le mode débug . La troisième colonne stocke le temps d’exécution des étapes.

 

Personnalisation de l’interface

Plusieurs fonctionnalités permettent de personnaliser l’interface graphique. Il est en effet possible de modifier la langue du logiciel ainsi que l’organisation des composants graphiques.

Modification de la langue du logiciel

Pour modifier la langue, cliquer sur le menu Langue dans la barre de menu. Choisissez ensuite entre la version française ou anglaise du logiciel.

Pour appliquer le changement, il faut fermer et ouvrir à nouveau l’interface ComputreeGui!

Personnalisation de la composition de l’interface

La majorité des composants de type “fenêtre” peuvent être déplacés dans l’interface. Ceux-ci peuvent être superposés et accessibles à l’aide d’onglets ou alors disposés en colonnes. Ces arrangements peuvent être faits de façon manuelle ou encore en utilisant les arrangements par défaut dans le menu Fenêtre de la barre de menu.

  • Composants en colonne : tous les composants sont séparés, et occupent la gauche et la droite de l’écran. Cette configuration est chargée au premier lancement de ComputreeGUI.
  • Composants en colonne (Log en bas) : présente une alternative avec la fenêtre de log en bas.
  • Composants en onglets : superpose en onglets les composants 4, 8 et 10 d’une part, et les composants 5 et 9 d’autre part. Cette configuration donne une plus grande place aux vues, mais nécessite de naviguer entre les composants par les onglets.

Vous pensez que votre configuration est parfaite? Soumettez-la à notre équipe, elle pourrait se retrouver dans la prochaine version de CompuTree!

L’agencement des composants est sauvegardé dans le fichier config.ini à la fermeture, et est donc rechargé à la session suivante de Computree.
Si un composant a été fermé, il peut être réaffiché à l’aide du menu Fenêtre.

 

Chargement de données

Ouvrir un fichier

Le bouton permet d’ouvrir un fichier d’arbre d’étapes (script).
Ce bouton peut également être utilisé pour ouvrir rapidement un fichier de données.

Il est néanmoins conseillé d’utiliser les étapes de chargement de la fenêtre Étapes pour avoir accès à plus de fonctionnalités.

Ajouter une étape de chargement

Toutes les étapes de chargement se trouvent dans l’onglet Charger de la fenêtre Étape.

Les différentes étapes de chargement sont classifiées selon le type de données:

Les sous-onglets Raster et Vecteur contiennent entre autres une série d’étapes utilisant la librairie GDAL. Ces étapes sont utilisées afin de lire et charger en données CompuTree des données SIG (shapefile, raster, etc.)

Création d’un DataSource

Étape Créer DataSource (Étape/Charger/Créer DataSource)

Un DataSource est une liste de fichiers qui permet de traiter plusieurs sources de données en parallèle.

Paramétrage:
  1. Choisir le Type de fichier
    Plusieurs formats de données disponibles (xyb, ascii, las, raster, GDAL, etc)
  2. Choisir les fichiers
    Plusieurs fichiers peuvent être chargés, dépendamment de la mémoire vive de votre ordinateur.
  3. Si la case Charger tous les fichiers est décochée, seuls les entêtes des fichiers seront chargés. Si la case est cochée, les données seront également chargées.

Exemple de chargement: Importer un fichier ASCII (en mode paramétrable)

Les fichiers ASCII peuvent être construits de différentes manières. Pour assurer une bonne lecture du fichier, il est impératif de spécifier:
  1. Si le fichier possède une Entête et, si besoin, le *Nombre de lignes à ignorer avant la ligne d’entête
  2. Si le Séparateur décimal est un point ou bien une virgule
  3. le Séparateur de champs (tabulation, virgule, point-virgule, espace)
  4. Ainsi que les Correspondances des champs (X, Y, Z et, s’il y a lieu, Intensité, Rouge, Vert, Bleu, Normales en X, Y et Z)

 

Ajout d’étapes

Toutes les étapes de traitement sont situées dans la fenêtre Étapes.

Organisation de la fenêtre

Les étapes sont d'abord classifiées selon le type de données produites (onglets):
  • Charger
    Étapes de chargement de données (DataSources, Readers, GDAL).
  • Exporter
    Étapes d’exportation de données (attributs, points, grilles, etc.).
  • Points
    Regroupe des étapes (classification, extraction, colorisation, etc.) qui produisent en sortie des données ponctuelles.
  • Items
    De manière générale, on y retrouve des étapes permettant d’extraire des informations ou de détecter des objets (tels les diamètres à 1m30 ou encore la projection au sol des houppiers).
  • Voxels
    Ces fonctions produisent des grilles 3D.
  • Rasters
    Ces fonctions produisent des grilles 2D.
  • Maillages
    Étapes impliquant des maillages (mesh). Un maillage est un objet tridimensionnel constitué de polygones.
  • Flux
    Relatif à la gestion de chaines de traitement.
  • Autres
    Étapes non classifiées.
  • Travaux en cours (Beta)
    Étapes en cours de développement. Ces étapes peuvent être modifiées entre les parutions des versions stables de Computree.

Les sous onglets (de couleur bleue) permettent de classifier les étapes selon l’action ou le traitement à effectuer.

Les étapes possèdent ensuite un code couleur selon la disponibilité immédiate de l'outil:
  • outil disponible
  • outil non disponible
La disponibilité de l’outil est définie selon le résultat d’entrée!

Enfin, la mise en forme du texte de l’étape permet de différentier les étapes interractives (mise en forme italique) des étapes statiques (mise en forme normal).

Gestionnaire d’étape

Pour ajouter une étape dans le gestionnaire d’étape, il suffit de double cliquer sur l’étape désirée.
L’icône indique que l’étape doit être lancée. Pour lancer l’étape, il suffit de cliquer sur le bouton . On peut également interrompre l’exécution à l’aide du bouton .
Pendant l’exécution, l’icône apparaît. L’icône indique que le traitement est terminé.
Lorsque l’étape est sélectionnée, celle-ci est surlignée. Pour ajouter une étape utilisant en entrée les résultats de l’étape précédente, il faut que l’étape mère soit sélectionnée.

Configuration des résultats d’entrée

Certaines étapes nécessitent l’identification des résultats de l’étape précédente qui seront utilisés comme entrées dans le traitement.

Par exemple, dans la fenêtre suivante, l’étape nécessite la partie végétation d’un nuage de point classifié .

La partie gauche liste les résultats candidats, classés par élément recherché.
En double-cliquant sur l’élément désiré, cela le transfert en tant que correspondance validée dans la partie droite (on peut aussi le glisser de la partie gauche vers la partie droite).

Dans la partie droite, il est possible de sélectionner, si nécessaire, au sein d’un résultat donné, les niveaux de groupes et d’items à utiliser.
Une fois tous les choix effectués, il suffit de cliquer sur OK, pour valider la configuration des résultats d’entrée.

Il est possible d’accéder à nouveau à la fenêtre de configuration des résultats d’entrée par un clic droit sur l’étape, puis en sélectionnant .

Configuration des paramètres

S’il y a lieu, la fenêtre de paramétrage de l’étape s’ouvre. Elle contient tous les paramètres réglables de l’algorithme à exécuter.
Une fois les paramètres choisis et validés, l’étape peut être lancée dans l’ arbre des étapes.

Exemple de fenêtre de paramétrage:

Il est possible d’accéder à nouveau à la fenêtre de configuration des résultats d’entrée par un clic droit sur l’étape, puis en sélectionnant .

Aide sur les étapes

Pour afficher la documentation sur une étape donnée, il faut faire un clic droit sur celle-ci, puis sélectionner .

Exemple d’une fenêtre de documentation:

Il est également possible d’afficher la fenêtre d’ Aide en cliquant sur .
Cette fenêtre propose entre autres un lien vers la Wiki de CompuTree.

 

Affichage d’items et navigation dans les vues

Une fois la structure de résultat disponible dans le gestionnaire de modèles (une fois l’étape de chargement terminée), il est possible d’afficher les résultats en mode 2D, 3D et tabulaire. L’affichage de ces items peut enfin être personnalisé entre autres par leur colorisation. Une fois le résultat affiché, il est possible de naviguer dans la vue 3D.

Outils d’affichage

{1} Enregistrer une capture d’écran

{2} Point de vue

{3} Exporter les éléments sélectionnés

{4} Configurer l’affichage

{5} Configurer les couleurs des éléments

{6} Changer la taille des pixels

{7} Déplacer la caméra

{8} Ajuster la caméra aux éléments visibles

{9} Centrer la vue sur le barycentre de l’élément sélectionné

{10} Centrer la vue sur le barycentre des éléments présents dans la vue

{11} Centrer la vue sur l’origine

{12} Synchroniser ce document

{13} Vue personnalisée

Affichage d’items

Il suffit de cocher sur la case d’un résultat pour afficher un élément dans la vue correspondante. Dans la figure ci-haut, comme il n’y a que le document 1 d’ouvert, il n’y a qu’une colonne “1” dans le gestionnaire de modèle. En cochant Scène, les points de la scène sont affichés dans la Vue 3D du document 1. Si un autre document est ouvert, une colonne “2” apparaîtra dans le gestionnaire de modèle. Il suffit alors de cocher l’élément désiré de la colonne “2” pour l’afficher dans le document 2.

Les boutons permettent d’ajouter un nouveau document 3D, 2D ou tabulaire.
Il est possible que, lors de l’affichage, les items ne soient pas visibles dans le document parce qu’ils ne sont pas centrés dans la vue. Il suffit d’utiliser le bouton pour ramener l’item au centre du document.

Pour retirer un item, il suffit de décocher l’élément dans le gestionnaire de modèle ou dans le gestionnaire d’étape.
Le bouton permet de nettoyer la vue de l’ensemble des éléments affichés.

Navigation dans les vues

Dans la vue 3D, il est possible de modifier le point de vue en maintenant appuyé le bouton gauche (rotation), le bouton droit (translation) ou avec la molette (zoom).
Il est également possible d’utiliser les points de vue préprogrammés à l’aide de l’outil .

Les outils sont très utiles à la navigation, car ils permettent de centrer la “caméra” sur un item, sur un ensemble d’items ou bien sur l’origine.

Colorisation

Si le nuage de points possède un attribut comme l’ Intensité, il est possible de coloriser le scan selon cet attribut. Le bouton permet d’ouvrir la fenêtre suivante:

Le bouton permet de choisir les couleurs du gradient utilisé. Il est également possible d’ajouter et de retirer des couleurs au gradient. Une fois le gradient établi, il suffit de cliquer sur le bouton pour appliquer le gradient sur le nuage de point.
Le bouton permet la configuration des valeurs MIN et MAX retenues pour l’attribut.

Exemple avec le gradient:

Pour appliquer une couleur à des items affichés dans une vue, il suffit de faire un clic droit sur l’item à coloriser. Il existe trois modes de colorisation d’un item:

  • Unie
    Cette méthode permet de choisir la couleur d’un item.

Une fenêtre permettant de sélectionner la couleur désirée apparaît par la suite.

  • Automatique

Cette méthode permet de coloriser des items avec des couleurs aléatoires.

Pour coloriser tous les items d’un même groupe, il suffit de faire le clic droit sur le groupe au lieu de l’item.

Exemple de couronnes et leurs projections au sol:

  • selon un attribut

Enfin, il est possible d’appliquer une couleur sur un attribut de l’item sélectionné.

Personnalisation des vues

Le bouton permet de configurer l’apparence des documents (fenêtres de visualisation des données).

  • Couleurs et tailles
    Ce bloc permet de modifier les couleurs d’arrière-plan et de sélection des items.
    La taille des points est également modifiable.
  • Dessin
    Il est possible d’afficher ou nom les axes XYZ à l’aide de la case à cocher.
  • Informations
    La section Caméra permet d’afficher des informations relatives au positionnement de la vue courante. Ces informations peuvent être affichées aux quatre coins de la fenêtre.

    La section Affichage permet d’afficher à l’écran le FPS (frame per second). Il s’agit du nombre d’images affichées par seconde.
  • Vue
    Il existe deux modes de vue: en perspective (la vue par défaut) et la vue orthographique.
    Vue orthographique (la taille des objets est la même, peu importe leur position) VS Vue en perspective (la taille des objets est relative à la position de l’observateur)

Synchronisation des vues

La synchronisation des vues permet d’afficher et déplacer simultanément des items dans deux documents.

Pour activer, la synchronisation des vues, il faut:
  • Ajouter un document 3D (bouton )
  • Afficher les items dans les deux documents
  • Activer la synchronisation dans les deux documents à l’aide des boutons

Sélection d’éléments

Pour activer le mode sélection, celui-ci doit en premier lieu être activé dans la fenêtre Action:

Pour afficher les informations d’un item lors de la sélection, il suffit d’activer plutôt
Les informations de l’item sélectionné seront alors affichées dans la fenêtre de vue:

Options de sélection

Les options de sélection se retrouvent dans les outils de la fenêtre de vue:

Voici les différents modes de sélection:

  • Sélection d’un élément par simple clic
  • Sélection de multiples éléments par polygone
  • Remplacer la sélection
  • Ajout à la sélection existante
  • Supprimer de la sélection existante

Exportation d’éléments

Tous les modes d’exportation se retrouvent dans la fenêtre Étapes au menu Exporter:

Les étapes d’exportation sont classées selon le type de données à exporter.

  • Autres: autres formats (OPF, PCIDSK)
  • Items: attributs d’items (profils, formes, etc.)
  • Maillages: format OBJ (Meshs)
  • Points: points ASCII, XYB, LAS
  • Raster: données matricielles (librairie GDAL)
  • Vecteur: données vectorielles (librairie GDAL)
  • Voxels: grilles 3D
  • Export avec nom de fichier adaptatif: à utiliser en mode batch. Cette étape nécessite un attribut CT_Header pour spécifier le nom des fichiers.

Exportation d’un nuage de point au format xyb

Exportation d’attributs d’items

Création d’un script et gestion des favoris

Création d’un script

Un script, ou arbre d’étape, permet de sauvegarder une séquence d’étapes ainsi que le paramétrage de chaque étape pour une utilisation ultérieur.
Une fois l’arbre d’étape terminé, il suffit de cliquer sur le bouton et d’enregistrer le fichier .xsct2 dans le répertoire désiré.

Pour ouvrir un script existant, il faut simplement cliquer sur le bouton .

Gestion des favoris

Il est maintenant possible de sauvegarder une liste ordonnée des outils les plus utilisés.

Dans la fenêtre Étapes se trouve un onglet Favoris:

Pour ajouter une étape dans les favoris, il suffit de faire un clic droit sur l’étape désirée et cliquer sur

Il est possible d’ajouter des niveaux et sous-niveaux afin de classifier les favoris

Also available in: PDF HTML TXT