À terme, il est probable que vous ayez besoin d’aller au-delà des notions de base et de vous plonger au cœur de Dynamo. Les pages de cette section vous donneront un plan pour débloquer des fonctionnalités avancées dans Dynamo for Civil 3D afin que vous puissiez faire passer vos graphiques au niveau supérieur.

Dynamo for Civil 3D contient un mécanisme très puissant qui « se souvient » des objets créés par chaque nœud. Ce mécanisme est appelé Liaison d’objet et permet à un graphique Dynamo de produire des résultats cohérents chaque fois qu’il est exécuté dans le même document. Bien que cela soit souhaitable dans de nombreuses situations, il est possible que vous vouliez avoir plus de contrôle sur le comportement de Dynamo dans d’autres cas. Cette section vous aidera à comprendre le fonctionnement de la liaison d’objet et comment en tirer parti.

Exemple

Prenons l’exemple de ce graphique qui crée un cercle dans l’espace objet sur le calque courant.

Remarquez ce qui se passe lorsque le rayon est modifié.

Voilà une démonstration de la liaison d’objet. Par défaut, Dynamo modifie le rayon du cercle, plutôt que de créer un nouveau cercle à chaque fois que la valeur du rayon change. Ceci est dû au fait que le nœud Object.ByGeometry « se souvient » qu’il a créé ce cercle spécifique à chaque exécution du graphique. De plus, Dynamo stocke cette information de sorte que lors de la prochaine ouverture du document Civil 3D et de l’exécution du graphique, celui-ci aura exactement le même comportement.

Autre exemple

Voyons un exemple dans lequel vous voudriez changer le comportement par défaut des liaisons d’objet dans Dynamo. Supposons que vous souhaitiez créer un graphique qui place un texte au milieu d’un cercle. Vous souhaitez également que ce graphique puisse être exécuté à plusieurs reprises et qu’il place un nouveau texte à chaque fois, quel que soit le cercle sélectionné. Voici à quoi ce graphique pourrait ressembler.

Cependant, ceci se produit lorsque vous sélectionnez un autre cercle.

Il semble que le texte soit supprimé et recréé à chaque exécution du graphique. En réalité, la position du texte est modifiée en fonction du cercle sélectionné. Il s’agit donc du même texte, mais à un autre endroit ! Afin de créer un nouveau texte à chaque fois, vous devez modifier les paramètres de liaison d’objet de Dynamo pour qu’aucune donnée de liaison ne soit conservée (consultez la partie #binding-settings ci-dessous).

Après avoir effectué ce changement, vous obtenez le comportement que vous recherchez.

Paramètres de liaison

Dynamo for Civil 3D permet de modifier le comportement par défaut des liaison d’objet via les paramètres Stockage des données de liaison du menu de Dynamo.

Toutes les options sont activées par défaut. Voici un résumé des effets de chaque option.

Option 1 : aucune donnée de liaison conservée

Lorsque cette option est activée, Dynamo « oublie » les objets qu’il a créés lors de la dernière exécution du graphique. Le graphique peut être exécuté dans n’importe quel dessin, dans n’importe quelle situation, et il créera des objets à chaque fois.

Option 2 : stocker dans un graphique pour Dynamo

Cette option signifie que les métadonnées de liaison d’objet seront sérialisées dans le graphique (fichier .dyn) lors de son enregistrement. Si vous fermez/rouvrez le graphique et l’exécutez dans le même dessin, tout devrait fonctionner comme vous l’avez laissé. Si vous exécutez le graphique dans un autre dessin, les données de liaison seront supprimées du graphique et de nouveaux objets seront créés. Cela signifie que si vous ouvrez le dessin d’origine et exécutez à nouveau le graphique, de nouveaux objets seront créés en plus des anciens.

Option 3 : stocker dans un dessin pour Dynamo

Cette option est similaire à l’option 2, sauf que les données de liaison d’objet sont sérialisées dans le dessin au lieu du graphique (fichier .dyn). Si vous fermez/rouvrez le graphique et l’exécutez dans le même dessin, tout devrait fonctionner comme vous l’avez laissé. Si vous exécutez le graphique dans un autre dessin, les données de liaison sont conservées dans le dessin d’origine, car elles sont enregistrées dans le dessin et non dans le graphique.

Option 4 : stocker dans un dessin pour le Lecteur Dynamo

La première chose à noter avec cette option est qu’elle n’a aucun effet sur la façon dont le graphique interagit avec le dessin lorsqu’il est exécuté via l’interface principale de Dynamo. Cette option s’applique uniquement lorsque le graphique est exécuté à l’aide du Lecteur Dynamo.

Si vous exécutez le graphique en utilisant l’interface principale de Dynamo, puis fermez et exécutez le même graphique en utilisant le Lecteur Dynamo, il créera de nouveaux objets en plus de ceux qu’il a créés auparavant. Cependant, une fois que le Lecteur Dynamo a exécuté le graphique une fois, il sérialisera les données de liaison d’objet dans le dessin. Ainsi, si vous exécutez le graphique plusieurs fois via le Lecteur Dynamo, il mettra à jour les objets au lieu d’en créer de nouveaux. Si vous exécutez le graphique via le Lecteur Dynamo sur un autre dessin, les données de liaison sont toujours conservées dans le dessin d’origine, car elles sont enregistrées dans le dessin et non dans le graphique.

Bien que Dynamo soit un outil de programmation visuelle extrêmement puissant, il est également possible d’aller au-delà des nœuds et des fils et d’écrire du code sous forme de texte. Vous pouvez procéder de deux manières :

1. écrire en DesignScript à l’aide d’un bloc de code ;

2. écrire en Python à l’aide d’un nœud Python.

Cette section se concentre sur la manière d’exploiter le langage Python dans l’environnement Civil 3D afin de tirer parti des API .NET d’AutoCAD et de Civil 3D.

Documentation de l’API

AutoCAD et Civil 3D disposent de plusieurs API qui permettent aux développeurs comme vous d’étendre le produit principal avec des fonctionnalités personnalisées. Dans le contexte de Dynamo, ce sont les API .NET gérées qui sont pertinentes. Les liens suivants sont essentiels pour comprendre la structure des API et leur fonctionnement.

Guide du développeur de l’API .NET d’AutoCAD

Guide de référence de l’API .NET d’AutoCAD

Guide du développeur de l’API .NET de Civil 3D

Guide de référence de l’API .NET de Civil 3D

Modèle de code

Lorsque vous modifiez un nouveau nœud Python pour la première fois, il est prérempli avec un modèle de code pour vous aider à démarrer. Voici une analyse du modèle avec des explications sur chaque bloc.

1. Importe les modules sys et clr, qui sont tous deux nécessaires au bon fonctionnement de l’interpréteur Python. En particulier, le module clr permet de traiter les espaces nom .NET essentiellement comme des packages Python.

2. Charge les assemblages standard (par exemple, les DLL) pour utiliser les API .NET gérées pour AutoCAD et Civil 3D.

3. Ajoute des références aux espaces nom AutoCAD et Civil 3D standard. Celles-ci sont équivalentes aux directives using ou Imports en C# ou VB.NET (respectivement).

4. Les ports d’entrée du nœud sont accessibles à l’aide d’une liste prédéfinie appelée IN. Vous pouvez accéder aux données d’un port spécifique à l’aide de son numéro d’index, par exemple dataInFirstPort = IN[0].

5. Extrait le document et l’éditeur actifs.

6. Verrouille le document et lance une transaction de base de données.

7. Vous devez insérer l’essentiel de la logique de votre script ici.

8. Supprimez le commentaire de cette ligne pour valider la transaction une fois votre travail principal terminé.

9. Si vous souhaitez générer des données à partir du nœud, affectez-les à la variable OUT à la fin de votre script.

Exemple

Examinons un exemple pour démontrer certains des concepts essentiels de l’écriture de scripts Python dans Dynamo for Civil 3D.

Objectif

Ensemble de données

Voici des exemples de fichiers qui peuvent vous servir de référence pour cet exercice.

Présentation de la solution

Voici une présentation de la logique de ce graphique.

1. Consulter la documentation relative à l’API Civil 3D

2. Sélectionner tous les bassins versants du document par nom de calque

3. « Déballer » les objets Dynamo pour accéder aux membres internes de l’API Civil 3D

4. Créer des points Dynamo à partir de points AutoCAD

5. Créer des polycourbes à partir des points

Allons-y !

Consulter la documentation relative à l’API

Avant de commencer à créer le graphique et à écrire le code, il est conseillé de consulter la documentation relative à l’API Civil 3D et de se familiariser avec ses fonctionnalités. Dans ce cas, il existe une propriété dans la classe Bassin versant qui renvoie les points de limite du contour du bassin versant. Notez que cette propriété renvoie un objet Point3dCollection, que Dynamo ne saura pas traiter En d’autres termes, vous ne pourrez pas créer de polycourbe à partir d’un Point3dCollection. Par conséquent, vous devrez éventuellement tout convertir en points Dynamo. Nous y reviendrons plus tard.

Obtenir tous les bassins versants

Vous pouvez maintenant commencer à construire la logique graphique. La première chose à faire est d’obtenir une liste de tous les bassins versants du document. Des nœuds sont disponibles pour cela, il n’est donc pas nécessaire de l’inclure dans le script en Python. L’utilisation de nœuds permet une meilleure visibilité pour quiconque lirait le graphique (au lieu d’ajouter beaucoup de code dans un script Python), et cela permet également au script Python de se concentrer sur une seule chose : renvoyer les points de limite des bassins versants.

Notez ici que la sortie du nœud Tous les objets du calque est une liste de CivilObjects. En effet, Dynamo for Civil 3D ne dispose pas actuellement de nœuds pour travailler avec des bassins versants, ce qui explique pourquoi nous devons accéder à l’API en Python.

Déballer des objets

Avant d’aller plus loin, il convient d’aborder brièvement un concept important. Dans la section node-library.md, nous avons vu comment les objets CivilObjects sont liés. Pour apporter un peu plus de détails, un objet Dynamo est un wrapper autour d’une entité AutoCAD. De même, un CivilObject Dynamo est un wrapper autour d’une entité Civil 3D. Vous pouvez « déballer » un objet en accédant à ses propriétés InternalDBObject ou InternalObjectId.

Script Python

Voici le script Python complet qui permet d’accéder aux objets internes du bassin versant et d’obtenir leurs point de limite. Les lignes en surbrillance représentent celles qui sont modifiées/ajoutées par rapport au modèle de code par défaut.

Créer des polycourbes

À ce stade, le script Python doit produire une liste de points Dynamo que vous pouvez voir dans l’aperçu en arrière-plan. La dernière étape consiste simplement à créer des polycourbes à partir des points. Notez que cette opération pourrait également être réalisée directement dans le script Python, mais vous l’avez intentionnellement placée en dehors du script dans un nœud afin qu’elle soit plus visible. Voici à quoi ressemble le graphique final.

Résultat

Et voici la géométrie Dynamo finale.

Comparaison entre IronPython et CPython

Une petite remarque avant de conclure. Selon la version de Civil 3D que vous utilisez, le nœud Python peut être configuré différemment. Dans Civil 3D 2020 et 2021, Dynamo utilisait un outil appelé IronPython pour déplacer des données entre des objets .NET et des scripts Python. Cependant, dans Civil 3D 2022, Dynamo est passé à l’utilisation de l’interpréteur Python natif standard (également appelé CPython) qui utilisent Python 3. Les avantages de cette transition comprennent l’accès aux bibliothèques modernes les plus populaires et aux nouvelles fonctionnalités de la plateforme, la maintenance essentielle et les correctifs de sécurité.

1. Cette ligne récupère la classe spécifique dont nous avons besoin à partir de la bibliothèque de géométries Dynamo. Notez que nous spécifions import Point as DynPoint ici au lieu de import *, car cette instruction introduit des conflits d’attribution de noms.

2. Ici, nous spécifions exactement quel port d’entrée contient les données que nous voulons au lieu du IN par défaut, qui fait référence à la liste complète de toutes les entrées.