|{width:4000px;text-align:left;border-color:transparent}. !/attachments/download/18/en_US.png! [[En_FirstSteps_v4|...english version of this page]] | p<{font-size:175%}. *Premiers pas avec CompuTree*   h1. 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. !GUI_overview_FR.jpg! Éléments de l'interface CompuTree: %*{color:darkred}{1}*% *Barre de menu* %*{color:darkred}{2}*% *Barre d'outils* %*{color:darkred}{3}*% *Gestionnaire d'étapes* %*{color:darkred}{4}*% *Gestionnaire de modèle* %*{color:darkred}{5}*% *Configurateur d'items* %*{color:darkred}{6}*% *Fenêtre d'étapes* %*{color:darkred}{7}*% *Fenêtre d'affichage (vue 2D ou 3D)* %*{color:darkred}{8}*% *Vue tabulaire* %*{color:darkred}{9}*% *Gestionnaire d'actions* %*{color:darkred}{10}*% *Gestionnaire de synchronisation des vues* %*{color:darkred}{11}*% *Fenêtre de log (historique)*   La *barre d'outils* %*{color:darkred}{2}*% reprend sous forme d'icône la plupart des fonctionnalités présentes dans la *Barre de menus* %*{color:darkred}{1}*%: |_.Icone |_.Fonction |_.Raccourcis clavier | |=.!ouvrir.jpg! |Ouvrir un fichier |=.CTRL + O | |=.!add.jpg! |Afficher la fenêtre d'Étapes |=.F2 | |=.!play.jpg! |Lancer les traitements |=.F3 | |=.!stop.jpg! |Arrêter les traitements | | |=.!save.jpg! |Enregistrer l'arbre des étapes |=.CTRL + S | |=.!pouce.jpg! |Valider en mode manuel |=.F4 | |=.!play_debug.jpg! |Lancer les traitements en mode debug |=.F5 | |=.!play_debug_fast.jpg! |Lancer les traitements en mode debug et avancer de N pas |=.F6 | |=.!play_movie.jpg! |Lancer les traitements en mode debug, avancer de N pas incluant un temps d'arrêt | | |=.!new-document.jpg! |Ajouter un document 3D |=.F7 | |=.!new-document-2d.jpg! |Ajouter un document 2D |=.F8 | |=.!tableur.jpg! |Ajouter un document de type tableur |=.F9 | |=.!preferences-system.jpg! |Configurations générales | | |=.!broom.jpg! |Nettoyer toutes les vues |=.F10 | |=.!help.jpg! |Aide |=.F1 | p<>. Le *gestionnaire d'étape* %*{color:darkred}{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. !gestionnaire_etape_FR.jpg! p<>. 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.   h1. Personnalisation de l'interface p<>. 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. h3. Modification de la langue du logiciel p<>. 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. tip. Pour appliquer le changement, il faut fermer et ouvrir à nouveau l'interface *ComputreeGui*! h3. Personnalisation de la composition de l'interface p<>. 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. bq. Vous pensez que votre configuration est parfaite? ;) Soumettez-la à notre équipe, elle pourrait se retrouver dans la prochaine version de *CompuTree*! notice. L'agencement des composants est sauvegardé dans le fichier config.ini à la fermeture, et est donc rechargé à la session suivante de Computree. tip. Si un composant a été fermé, il peut être réaffiché à l'aide du menu *Fenêtre*.   h1. Chargement de données h3. Ouvrir un fichier Le bouton !ouvrir.jpg! permet d'ouvrir un fichier d'arbre d'étapes (script). Ce bouton peut également être utilisé pour ouvrir rapidement un fichier de données. tip. Il est néanmoins conseillé d'utiliser les étapes de chargement de la fenêtre *Étapes* pour avoir accès à plus de fonctionnalités. h3. Ajouter une étape de chargement notice. 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: !charger.jpg! tip. 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.) h3. 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. !creation_datasource_FR.jpg! Paramétrage: # Choisir le *Type de fichier* Plusieurs formats de données disponibles (xyb, ascii, las, raster, GDAL, etc) # *Choisir les fichiers* Plusieurs fichiers peuvent être chargés, dépendamment de la mémoire vive de votre ordinateur. # 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. h3. 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: # Si le fichier possède une *Entête* et, si besoin, le *Nombre de lignes à ignorer avant la ligne d'entête # Si le *Séparateur décimal* est un point ou bien une virgule # le *Séparateur de champs* (tabulation, virgule, point-virgule, espace) # 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) !import_ascii_FR.jpg!   h1. Ajout d'étapes Toutes les étapes de traitement sont situées dans la fenêtre *Étapes*. h3. Organisation de la fenêtre !Etapes_FR.jpg! Les étapes sont d'abord classifiées selon le type de données produites (%{color:white;background:black}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 %{color:white;background:royalblue}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: * %{color:white;background:grey}outil disponible% * %{color:white;background:red}outil non disponible% notice. 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). h3. 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 !recycle.jpg! indique que l'étape doit être lancée. Pour lancer l'étape, il suffit de cliquer sur le bouton !play.jpg!. On peut également interrompre l’exécution à l'aide du bouton !{width:24px}stop.jpg!. Pendant l’exécution, l'icône !in_progress.jpg! apparaît. L'icône !valid.jpg! indique que le traitement est terminé. Lorsque l'étape est sélectionnée, celle-ci est %{color:white;background:goldenrod}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. !add_step_FR.jpg! h3. Configuration des résultats d'entrée p<>. 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. p<>. Par exemple, dans la fenêtre suivante, l'étape nécessite la partie végétation d'un nuage de point classifié . !resultat_entree_FR.jpg! p<>. 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). p<>. 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. tip. 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 !config_inputs_FR.jpg!. h3. Configuration des paramètres p<>. 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: !exemple_parametrage_FR.jpg! tip. 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 !config_params_FR.jpg!. h3. Aide sur les étapes p<>. Pour afficher la documentation sur une étape donnée, il faut faire un clic droit sur celle-ci, puis sélectionner !step_doc_FR.jpg!. Exemple d'une fenêtre de documentation: !step_doc_window_FR.jpg! p<>. Il est également possible d'afficher la fenêtre d' *Aide* en cliquant sur !help.jpg!. Cette fenêtre propose entre autres un lien vers la Wiki de CompuTree. !help_FR.jpg!   h1. Affichage d'items et navigation dans les vues p<>. 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. h3. Outils d'affichage !affichage2.jpg! %*{color:darkred}{1}*% *Enregistrer une capture d'écran* %*{color:darkred}{2}*% *Point de vue* %*{color:darkred}{3}*% *Exporter les éléments sélectionnés* %*{color:darkred}{4}*% *Configurer l'affichage* %*{color:darkred}{5}*% *Configurer les couleurs des éléments* %*{color:darkred}{6}*% *Changer la taille des pixels* %*{color:darkred}{7}*% *Déplacer la caméra* %*{color:darkred}{8}*% *Ajuster la caméra aux éléments visibles* %*{color:darkred}{9}*% *Centrer la vue sur le barycentre de l'élément sélectionné* %*{color:darkred}{10}*% *Centrer la vue sur le barycentre des éléments présents dans la vue* %*{color:darkred}{11}*% *Centrer la vue sur l'origine* %*{color:darkred}{12}*% *Synchroniser ce document* %*{color:darkred}{13}*% *Vue personnalisée* h3. Affichage d'items p<>. 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. notice. Les boutons !open.jpg! permettent d'ajouter un nouveau document 3D, 2D ou tabulaire. notice. 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 !centrer.jpg! 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 !clear.jpg! permet de nettoyer la vue de l'ensemble des éléments affichés. h3. Navigation dans les vues p<>. 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 !deplacer.jpg!. p<>. Les outils !vues.jpg! 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. h3. 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 !color.jpg! permet d'ouvrir la fenêtre suivante: !color_intensity_FR.jpg! Le bouton !choix_couleur2.jpg! 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 !appliquer.jpg! pour appliquer le gradient sur le nuage de point. Le bouton !configurer.jpg! permet la configuration des valeurs MIN et MAX retenues pour l'attribut. Exemple avec le gradient: !intensity.jpg! 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. !color_uni_FR.jpg! Une fenêtre permettant de sélectionner la couleur désirée apparaît par la suite. !choix_color_FR.jpg! * Automatique Cette méthode permet de coloriser des items avec des couleurs aléatoires. !color_automatic_FR.jpg! 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: !color_group.jpg! * selon un attribut Enfin, il est possible d'appliquer une couleur sur un attribut de l'item sélectionné. !color_by_FR.jpg! h3. Personnalisation des vues Le bouton !config.jpg! permet de configurer l'apparence des documents (fenêtres de visualisation des données). !config_vue_FR.jpg! * *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. !axe.jpg! * *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. !camera.jpg! 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) !ortho_perspec.jpg! h3. Synchronisation des vues La synchronisation des vues permet d'afficher et déplacer simultanément des items dans deux documents. !synchro.jpg! Pour activer, la synchronisation des vues, il faut: * Ajouter un document 3D (bouton !new-document.jpg!) * Afficher les items dans les deux documents !synchro_2.jpg! * Activer la synchronisation dans les deux documents à l'aide des boutons !sync.jpg! h1. Sélection d'éléments Pour activer le mode sélection, celui-ci doit en premier lieu être activé dans la fenêtre *Action*: !action_FR.jpg! Pour afficher les informations d'un item lors de la sélection, il suffit d'activer plutôt !info.jpg! Les informations de l'item sélectionné seront alors affichées dans la fenêtre de vue: !info2_FR.jpg! h3. Options de sélection Les options de sélection se retrouvent dans les outils de la fenêtre de vue: !selection.jpg! Voici les différents modes de sélection: * !s1.jpg! Sélection d'un élément par simple clic * !s2.jpg! Sélection de multiples éléments par polygone * !s3.jpg! Remplacer la sélection * !s4.jpg! Ajout à la sélection existante * !s5.jpg! Supprimer de la sélection existante h1. Exportation d'éléments Tous les modes d'exportation se retrouvent dans la fenêtre *Étapes* au menu *Exporter*: !export_FR.jpg! 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. h3. Exportation d'un nuage de point au format xyb !export_xyb_FR.jpg! h4. Exportation d'attributs d'items !export_attr_FR.jpg! h1. Création d'un script et gestion des favoris h3. 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 !save.jpg! et d'enregistrer le fichier .xsct2 dans le répertoire désiré. Pour ouvrir un script existant, il faut simplement cliquer sur le bouton !ouvrir.jpg!. h3. 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*: !favs_FR.jpg! Pour ajouter une étape dans les favoris, il suffit de faire un clic droit sur l'étape désirée et cliquer sur !add_favs_FR.jpg! !favoris_FR.jpg! Il est possible d'ajouter des niveaux et sous-niveaux afin de classifier les favoris !favs2_FR.jpg!