La commande permet d'exécuter des scripts Python directement dans Autodesk Revit. Cela offre la possibilité d'automatiser des tâches, d'effectuer des calculs complexes et de manipuler les éléments du modèle à l'aide de code Python.
Paramètres de configuration
Après avoir lancé la commande, l'utilisateur peut saisir son propre script Python. Le script sera exécuté dans le contexte du document Revit actif. Les sections ci-dessous expliquent comment configurer et exécuter un script avec accès aux objets de l'API Revit.
Execution Engine :
Execution Engine :
Choisissez entre IronPython et Dynamo_CPython3. IronPython donne accès aux variables globales de Revit telles que
__doc__et__uidoc__. Dynamo_CPython3 ne fournit pas ces variables et exécute le code de manière similaire à un nœud Python dans Dynamo.Choisissez entre IronPython et Dynamo_CPython3. IronPython donne accès aux variables globales de Revit telles que
__doc__et__uidoc__. Dynamo_CPython3 ne fournit pas ces variables et exécute le code de manière similaire à un nœud Python dans Dynamo.Script file :
Script file :
Chemin facultatif vers un fichier Python. Si le champ Script est vide, le contenu de ce fichier sera exécuté.
Chemin facultatif vers un fichier Python. Si le champ Script est vide, le contenu de ce fichier sera exécuté.
Script :
Script :
Entrez le script Python à exécuter. Les deux moteurs prennent en charge l'utilisation de
INpour les entrées etOUTpour le résultat. Le code est exécuté à partir de ce champ ou à partir du fichier spécifié si ce champ est vide.Entrez le script Python à exécuter. Les deux moteurs prennent en charge l'utilisation de
INpour les entrées etOUTpour le résultat. Le code est exécuté à partir de ce champ ou à partir du fichier spécifié si ce champ est vide.IN :
IN :
Une liste de chaînes de caractères saisies par l'utilisateur. Ces valeurs peuvent être utilisées dans le script via la variable
IN.Une liste de chaînes de caractères saisies par l'utilisateur. Ces valeurs peuvent être utilisées dans le script via la variable
IN.
Variables disponibles
Les variables suivantes sont disponibles selon le moteur d'exécution sélectionné :
IN :
IN :
Une liste de chaînes d'entrée définies dans la configuration. Disponible à la fois dans IronPython et Dynamo_CPython3.
Une liste de chaînes d'entrée définies dans la configuration. Disponible à la fois dans IronPython et Dynamo_CPython3.
OUT :
OUT :
La variable à laquelle le script doit affecter le résultat final. Ce résultat sera affiché après l'exécution.
La variable à laquelle le script doit affecter le résultat final. Ce résultat sera affiché après l'exécution.
__doc__ :
__doc__ :
Disponible uniquement avec IronPython. Fait référence à l'objet actif Document.
Disponible uniquement avec IronPython. Fait référence à l'objet actif Document.
__uidoc__ :
__uidoc__ :
Disponible uniquement avec IronPython. Représente l'objet UIDocument pour interagir avec l'interface utilisateur.
Disponible uniquement avec IronPython. Représente l'objet UIDocument pour interagir avec l'interface utilisateur.
__revit__, __uiapp__ :
__revit__, __uiapp__ :
Également disponibles uniquement avec IronPython. Fournissent un accès au contexte général de l'application Revit via UIApplication.
Également disponibles uniquement avec IronPython. Fournissent un accès au contexte général de l'application Revit via UIApplication.
Exécution du script
Après avoir défini le script et les entrées souhaitées, cliquez sur le bouton "OK" pour l'exécuter. Le résultat s'affichera dans une boîte de dialogue.
Résultat :
Résultat :
Pour retourner une valeur ou un message, affectez-le à la variable
OUT. Par exemple :OUT = "Nombre d'éléments traités : {0}".format(element_count)Ce message apparaîtra dans la boîte de dialogue des résultats.Pour retourner une valeur ou un message, affectez-le à la variable
OUT. Par exemple :OUT = "Nombre d'éléments traités : {0}".format(element_count)Ce message apparaîtra dans la boîte de dialogue des résultats.
Après l'exécution
Si le script s'exécute correctement, la valeur affectée à OUT sera affichée. En cas d'erreur, un message détaillé s'affichera avec la trace pour faciliter le débogage.
Envie d’essayer ?
Nous vous contacterons et vous aiderons à démarrer