Avant ce chapitre, le guide a présenté les étapes à suivre pour mettre en œuvre les puissantes fonctionnalités de script visuel de Dynamo. Une bonne compréhension de ces fonctionnalités est une base solide et la première étape dans la construction de programmes visuels fiables. Lorsque vous utilisez vos programmes visuels sur le terrain, partagez-les avec vos collègues, corrigez les erreurs ou testez les limites avec lesquelles vous rencontrez d'autres problèmes. Si une autre personne va utiliser votre programme ou si vous souhaitez l'ouvrir dans six mois, il doit être clair d'un point de vue graphique et logique dès l'ouverture. Dynamo dispose de nombreux outils pour gérer la complexité de votre programme. Ce chapitre vous expliquera les conditions d’utilisation de ces derniers.
Lorsque vous développez votre graphique Dynamo et testez vos idées, la taille et la complexité de ce dernier peuvent rapidement augmenter. Bien qu’il soit important de créer un programme fonctionnel, il est tout aussi crucial de le faire le plus simplement possible. Non seulement votre graphique s'exécutera plus rapidement et de manière plus prévisible, mais vous comprendrez sa logique ultérieurement. Les méthodes suivantes vous aideront à clarifier la logique de votre graphique.
Les groupes vous permettent de créer des pièces fonctionnellement distinctes lorsque vous construisez un programme
Les groupes vous permettent de déplacer de grandes parties du programme tout en maintenant la modularité et l’alignement
Vous pouvez modifier la couleur du groupe pour différencier ce que font les groupes (entrées et fonctions)
Vous pouvez utiliser des groupes pour commencer à organiser votre graphique afin de simplifier la création de nœuds personnalisés
Les couleurs de ce programme identifient l’objectif de chaque groupe. Cette stratégie sert à créer une hiérarchie dans les normes graphiques ou les gabarits que vous développez.
Groupe de fonctions (bleu)
Groupe d'entrées (orange)
Groupe de scripts (vert)
Pour savoir comment utiliser les groupes, reportez-vous à la rubrique Gestion de votre programme.
Vous pouvez parfois utiliser un bloc de code pour saisir un nombre ou une méthode de nœud plus rapidement qu’en effectuant une recherche (Point.ByCoordinates, Number, String, Formula)
Les blocs de code sont utiles lorsque vous souhaitez définir des fonctions personnalisées dans DesignScript afin de réduire le nombre de nœuds dans un graphique
Les deux encadrés exécutent la même fonction. Il était beaucoup plus rapide d'écrire quelques lignes de code que de rechercher et d'ajouter chaque nœud individuellement. Le bloc de code est également beaucoup plus concis.
Script de conception écrit en bloc de code
Programme équivalent en nœuds
Pour savoir comment utiliser le bloc de code, reportez-vous à la rubrique Définition d’un bloc de code.
Vous pouvez réduire la complexité d’un graphique en utilisant la fonctionnalité Nœud vers code : elle permet de sélectionner un ensemble de nœuds simples et d’en écrire le DesignScript correspondant dans un bloc de code unique
La fonctionnalité Nœud vers code permet de** condenser du code sans nuire à la clarté du programme**
Voici les avantages de l’utilisation de Nœud vers code :
Condense facilement du code en un composant qui reste modifiable
Peut simplifier une partie significative du graphique
Utile si le mini-programme ne sera pas souvent modifié
Utile pour intégrer d’autres fonctionnalités de bloc de code, telles que des fonctions
Voici les inconvénients de l’utilisation de Nœud vers code :
L’attribution de noms génériques réduit la lisibilité
Plus difficile à comprendre pour les autres utilisateurs
Aucun moyen simple de revenir à la version de programmation visuelle
Programme existant
Bloc de code créé à partir de Nœud vers code
Pour savoir comment utiliser la fonctionnalité Nœud vers code, reportez-vous à la rubrique Syntaxe du script de conception.
L’utilisation de List@Level vous permet de réduire la complexité de votre graphique en remplaçant les nœuds List.Map et List.Combine qui peuvent occuper une grande partie de la zone de dessin
List@Level fournit une méthode plus** rapide que List.Map/List.Combine pour établir la logique de nœud** en vous permettant d’accéder aux données à n’importe quel niveau d’une liste, directement à partir du port d’entrée d’un nœud
Vous pouvez vérifier le nombre de valeurs True renvoyées par BoundingBox.Contains et dans quelles listes ces valeurs sont renvoyées en activant List@Level pour l’entrée « list » de CountTrue. La fonction List@Level permet à l'utilisateur de déterminer à quel niveau l'entrée va extraire des données. La fonction List@Level est flexible, efficace et vivement recommandée par rapport à d'autres méthodes impliquant List.Map et List.Combine.
Comptage des valeurs True au niveau de la liste 2
Comptage des valeurs True au niveau de la liste 3
Pour savoir comment utiliser List@Level, reportez-vous à la rubrique Listes de listes.
En plus de rendre le graphique aussi simple et efficace que possible, essayez d'améliorer la clarté graphique. Malgré vos efforts pour rendre votre graphique intuitif grâce à des regroupements logiques, les relations risquent de ne pas être évidentes. L'insertion d'une note simple dans un groupe ou l'attribution de nouveaux noms aux curseurs permet aux utilisateurs d'éviter tout malentendu ou mouvement panoramique inutile sur le graphique. Les méthodes suivantes vous aideront à appliquer la cohérence graphique dans vos graphiques.
Pour réduire votre charge de travail après avoir créé votre graphique, assurez-vous que la disposition des nœuds est lisible en alignant les nœuds régulièrement et au fur et à mesure de votre travail
Si d’autres utilisateurs vont travailler avec votre graphique, assurez-vous que la disposition des liaisons de nœud s’enchaîne facilement avant la livraison
Pour vous aider avec la tâche d’alignement, utilisez la fonction « Arranger l’affichage des nœuds » pour aligner automatiquement votre graphique, même si elle est moins précise que vous-même
Graphique non organisé
Graphique aligné
Pour utiliser l’alignement de nœud, reportez-vous à la rubrique Gestion de votre programme.
L’attribution de nouveaux noms aux entrées permet aux autres utilisateurs de comprendre facilement votre graphique, notamment si ce qu’ils connectent n’est pas affiché à l’écran
Veillez à renommer les nœuds en plus des entrées. Une autre solution consiste à créer un nœud personnalisé à partir d’un cluster de nœuds et à le renommer. Il sera alors évident qu’il contient autre chose
Entrées pour la manipulation de surfaces
Entrées pour les paramètres architecturaux
Entrées du script de simulation de drainage
Pour renommer un nœud, cliquez avec le bouton droit de la souris sur son nom et sélectionnez « Renommer le nœud… ».
Vous devez ajouter une note si quelque chose dans le graphique requiert une explication en langage simple que les nœuds ne peuvent pas exprimer
Vous devez ajouter une note si un ensemble de nœuds ou de groupes est trop volumineux ou trop complexe et ne peut pas être facilement compris immédiatement
Note décrivant la partie du programme qui renvoie les distances de conversion brutes
Note décrivant le code qui mappe ces valeurs avec une onde sinusoïdale
Pour savoir comment ajouter une note, reportez-vous à la rubrique Gestion de votre programme.
Lors de la création de votre script visuel, il est important de vérifier que le résultat renvoyé est celui attendu. Les erreurs ou les problèmes ne provoqueront pas tous l’échec immédiat du programme, notamment les valeurs nulles qui peuvent avoir une incidence sur un élément en aval. Cette stratégie est également abordée dans le contexte de la création de scripts de texte dans Stratégies de script. La pratique suivante permet de vous assurer que vous obtenez le résultat attendu.
Utilisez les bulles Watch et d’aperçu lorsque vous créez le programme pour** vérifier que les sorties clés renvoient le résultat attendu**
Les nœuds Watch sont utilisés pour comparer :
Distances de conversion brutes
Valeurs transmises par l’équation sinusoïdale
Pour savoir comment utiliser Watch, reportez-vous à la rubrique Bibliothèque.
Il est fort probable qu'une autre personne ouvre votre programme à un moment donné, même si vous travaillez indépendamment. Cette personne doit pouvoir comprendre rapidement ce dont le programme a besoin et ce qu'il produit à partir de ses entrées et sorties. Cela est particulièrement important lorsque vous développez un nœud personnalisé à partager avec la communauté Dynamo et à utiliser dans le programme d'un autre utilisateur. Ces pratiques permettent de construire des programmes et des nœuds robustes et réutilisables.
Pour garantir la lisibilité et l’évolutivité, essayez de réduire les entrées et les sorties autant que possible
Essayez de déterminer la méthode de création de la logique en créant d’abord une ébauche de la manière dont la logique peut fonctionner avant d’ajouter un nœud à la zone de dessin. Lorsque vous développez la première ébauche, effectuez un suivi des entrées et des sorties qui seront converties en scripts
Si vous souhaitez intégrer des options ou conditions particulières au graphique, utilisez les valeurs prédéfinies pour y accéder rapidement
Vous pouvez également utiliser les valeurs prédéfinies pour réduire la complexité en mettant en cache des valeurs de curseur spécifiques dans un graphique avec des temps d’exécution longs
Pour savoir comment utiliser les valeurs prédéfinies, reportez-vous à la rubrique Gestion des données grâce aux valeurs prédéfinies.
Vous devez utiliser un nœud personnalisé si votre programme peut être regroupé dans un seul conteneur
Vous devez utiliser un nœud personnalisé lorsqu’une partie du graphique sera réutilisée souvent dans d’autres programmes
Vous devez utiliser un nœud personnalisé pour partager une fonctionnalité avec la communauté Dynamo
La collecte du programme de conversion de points dans un nœud personnalisé permet de simplifier et de rendre transférable un programme robuste et unique. Les ports d'entrée bien nommés aideront d'autres utilisateurs à comprendre comment utiliser le nœud. N'oubliez pas d'ajouter des descriptions et des types de données requis pour chaque entrée.
Programme d'attraction existant
Nœud personnalisé qui collecte ce programme, PointGrid
Pour savoir comment utiliser les nœuds personnalisés, reportez-vous à la rubrique Introduction aux nœuds personnalisés.
Vous pouvez créer des gabarits pour établir des normes graphiques dans vos graphiques visuels afin de vous assurer que les collaborateurs comprennent le graphique de manière standardisée
Lors de la création d’un gabarit, vous pouvez normaliser les tailles de police et les couleurs de groupe afin de classer les types de workflow ou d’actions de données.
Lors de la création d’un gabarit, vous pouvez même normaliser la façon dont vous souhaitez étiqueter, colorer ou styliser la différence entre les workflows front-end et back-end dans votre graphique.
L’interface utilisateur, ou la partie frontale, du programme inclut un nom de projet, des curseurs d’entrée et une géométrie d’importation.
La partie back-end du programme.
Regroupez les catégories de couleurs (conception générale, entrées, scripts Python, géométrie importée).
Téléchargez le fichier d’exemple en cliquant sur le lien ci-dessous.
Vous trouverez la liste complète des fichiers d'exemple dans l'annexe.
Maintenant que vous avez établi plusieurs meilleures pratiques, appliquez-les à un programme qui a été mis en place rapidement. Bien que le programme réussisse à générer le toit, l'état du graphique reflète le cheminement de pensée de l'auteur, à la manière d'une carte mentale. Il n'y a aucune organisation ou description de son utilisation. Vous allez parcourir les meilleures pratiques pour organiser, décrire et analyser le programme afin que d’autres utilisateurs puissent comprendre comment l’utiliser.
Le programme fonctionne, mais le graphique est désorganisé.
Commençons par déterminer les données et la géométrie renvoyées par le programme.
Comprendre quand des modifications importantes des données se produisent est crucial pour établir des divisions logiques, ou des modularités. Inspectez le reste du programme avec les nœuds Watch pour voir si vous pouvez déterminer les groupes avant de passer à l’étape suivante.
Ce nœud Code Block avec une équation mathématique semble être un élément crucial du programme. Un nœud Watch indique qu’il renvoie des listes de distances de conversion.
L’objectif de cette zone n’est pas évident. La disposition des valeurs True au niveau de la liste L2 de BoundingBox.Contains et la présence de List.FilterByBoolMask suggèrent que vous échantillonnez une partie de la grille de points.
Une fois que vous avez identifié les composantes essentielles du programme, placez-les dans des groupes.
Les groupes permettent à l’utilisateur de différencier visuellement les parties du programme.
Importer un modèle de site 3D
Convertir la grille de points en fonction de l'équation sinusoïdale
Exemple de portion de grille de points
Créer une surface de toit architecturale
Créer un mur-rideau en verre
Lorsque les groupes sont établis, alignez les nœuds pour créer une continuité visuelle sur le graphique.
La continuité visuelle aide l’utilisateur à voir le flux du programme et les relations implicites entre les nœuds.
Rendez le programme plus accessible en ajoutant un autre calque d'améliorations graphiques. Ajoutez des notes pour décrire le fonctionnement d’une zone spécifique du programme, donnez des noms personnalisés aux entrées et affectez des couleurs à différents types de groupes.
Ces améliorations graphiques permettent à l’utilisateur de mieux connaître les activités du programme. Les différentes couleurs de groupe permettent de distinguer les entrées des fonctions.
Notes
Entrées avec des noms descriptifs
Avant de commencer à condenser le programme, identifions un emplacement stratégique pour présenter le simulateur de drainage du script Python. Branchez la sortie de la première surface de toit mise à l’échelle dans l’entrée de script correspondante.
Vous avez choisi d’intégrer les scripts à ce stade du programme afin que la simulation de drainage puisse être exécutée sur la surface de toit unique d’origine. Cette surface spécifique n'est pas affichée en aperçu, mais elle vous évite d'avoir à choisir la surface supérieure de la polysurface chanfreinée.
Géométrie source pour l'entrée du script
Nœud Python
Curseurs d'entrée
"Commutateur" activé/désactivé
Maintenant que tout est en place, simplifions le graphique.
La condensation du programme grâce à Nœud vers code et à Nœud personnalisé a permis de réduire considérablement la taille du graphique. Les groupes qui créent la surface du toit et les murs ont été convertis en code, car ils sont très spécifiques de ce programme. Le groupe de conversion de points est contenu dans un nœud personnalisé, car il peut être utilisé dans un autre programme. Dans le fichier d'exemple, créez votre propre nœud personnalisé à partir du groupe Convertir les points.
Nœud personnalisé contenant le groupe "Convertir la grille de points"
Nœud vers code permettant de condenser les groupes "Créer une surface de toit architecturale et un mur-rideau"
Pour finir, créez des valeurs prédéfinies pour des formes de toit représentatives.
Ces entrées sont les principaux pilotes de la forme du toit et permettent aux utilisateurs de découvrir le potentiel du programme.
Votre programme avec des vues de deux valeurs prédéfinies.
Les motifs de drainage du toit permettent à l’utilisateur d’obtenir une vue analytique des valeurs prédéfinies respectives.
