Découvrir l’API Revit avec Python : outils de départ et premier workflow

Que découvrirez-vous dans ce guide ?

Pour débuter avec l’API Revit, l’objectif n’est pas de développer immédiatement un module complémentaire complet, mais de comprendre comment trouver les éléments du modèle, accéder à leurs propriétés et gérer les modifications. Le cours d’initiation d’Autodesk présente une approche permettant d’accéder à l’API Revit à l’aide d’outils gratuits. Parmi les thèmes abordés figurent les filtres d’éléments, les transactions (Transactions) et l’interface utilisateur. L’enregistrement et l’utilisation d’outils Python font également partie des objectifs pédagogiques.

Ce guide transforme ces thèmes en un petit parcours de travail autour des données des pièces. Une pièce constitue un exemple facile à comprendre pour examiner des propriétés liées aux données du projet, comme le nom, le numéro, le type d’utilisation et les finitions. L’objectif n’est pas de fournir un appel API précis ni des instructions de code exécutables, mais d’expliquer les outils et l’ordre d’apprentissage étayés par les sources. Aucun numéro de version, chemin d’installation ou exemple de code absent des sources n’est présumé.

Prérequis et outils

Les outils utilisés dans le cours d’Autodesk University sont RevitPythonShell, Revit Lookup et pyRevit. Le cours attend des participants qu’ils possèdent des connaissances de base de Revit et des notions élémentaires de Python. Selon la page développeur de l’API Revit, celle-ci fournit une interface basée sur .NET permettant d’automatiser les tâches répétitives et d’étendre les fonctionnalités essentielles de Revit.

Avant de commencer, vérifiez les points suivants :

• L’installation de Revit et le fichier de projet utilisés.

• Des connaissances de base de Revit et des notions élémentaires de Python.

• Les informations d’installation et de compatibilité de RevitPythonShell, Revit Lookup et pyRevit avec la version de Revit utilisée.

Le cours d’initiation ne précise aucune version particulière de Revit ni les conditions de compatibilité actuelles de chaque outil. Avant l’installation, consultez donc la documentation des outils concernés. Les sources ne précisent pas non plus les conditions relatives aux comptes ; ne présumez donc pas qu’une condition spécifique s’applique.

Parcours de démarrage, étape par étape

1. Commencez par examiner les données de la pièce dans Revit. Sélectionnez une pièce et parcourez les champs de la palette Properties. Le document d’Autodesk sur les propriétés des pièces cite, entre autres, le nom, le numéro, le type d’utilisation, le département et les finitions des murs, du plafond et du sol. Les valeurs de surface et de périmètre sont en lecture seule ; le volume est lui aussi indiqué comme étant en lecture seule uniquement lorsque le calcul des volumes est activé. Comprendre cette distinction vous aide à déterminer quelles données lire et lesquelles vous souhaitez modifier.

2. Définissez le premier essai comme un problème de recherche d’éléments. Par exemple, commencez par apprendre à isoler les éléments de pièce du projet selon un critère précis. Le cours d’Autodesk University présente la collecte et le filtrage d’éléments avec RevitPythonShell parmi ses principaux objectifs pédagogiques. Avant d’écrire du code, décrivez simplement les éléments à sélectionner et la signification de la condition de filtrage. Vérifiez les appels API précis dans le guide développeur et les exemples de code d’Autodesk.

3. Conservez Revit Lookup dans la liste des outils du cours. La ressource d’Autodesk University cite Revit Lookup parmi les outils utilisés pendant le cours, mais la description fournie ne détaille ni ses fonctions ni les étapes d’utilisation. Consultez donc sa documentation pour savoir comment l’utiliser, sans présumer d’une fonction d’inspection particulière ou d’un chemin dans l’interface. Vous éviterez ainsi de considérer comme un élément établi du parcours d’apprentissage une fonctionnalité que les sources ne confirment pas.

4. Étudiez les modifications du modèle en même temps que les Transactions. Le cours compte parmi ses principaux thèmes l’exécution d’opérations sur des éléments via RevitPythonShell. Avant tout essai qui modifie les données du modèle, définissez précisément la modification visée et limitez-en la portée. Modifier une information comme le nom d’une pièce et lire une valeur en lecture seule comme la surface ne sont pas la même opération. N’élargissez pas l’automatisation avant d’avoir vérifié l’effet de la modification sur le fichier du projet. Les sources ne fournissent pas d’exemple de code précis pour démarrer et terminer une transaction ; vérifiez donc la méthode à appliquer dans la documentation de l’API concernée.

5. Fixez-vous un objectif pour enregistrer et réutiliser un outil Python. Le cours d’initiation vise également à apprendre à enregistrer et à utiliser des outils Python. Commencez par préparer un petit essai pour une seule tâche, puis évaluez s’il est nécessaire de réutiliser le même outil. pyRevit figure dans la liste des outils du cours, mais le texte source ne fournit ni commande pyRevit précise ni workflow d’utilisation. Consultez la documentation actuelle de cet outil pour les détails d’installation et d’utilisation.

6. Comparez le résultat aux propriétés de la pièce. Lorsque vous utilisez l’API, comparer les informations obtenues aux propriétés de la pièce affichées dans Revit vous aide à vérifier les données lues. Selon la documentation d’Autodesk, le numéro d’une pièce doit être unique dans le projet ; si le numéro a déjà été utilisé, Revit affiche un avertissement, mais permet de continuer. Ne confondez pas l’affichage d’un avertissement pendant le test avec le blocage complet de l’opération. La surface et le périmètre sont des valeurs en lecture seule ; pour le volume, le statut en lecture seule dépend de l’activation du calcul des volumes.

Erreurs fréquentes

• Présumer de la version : le cours d’initiation ne précise ni version de Revit ni version des outils. Vérifiez séparément les informations d’installation et de compatibilité.

• Penser que toutes les propriétés des pièces sont modifiables : la surface et le périmètre sont en lecture seule. Le volume est également défini comme étant en lecture seule uniquement lorsque le calcul des volumes est activé. Vérifiez la nature de la propriété avant d’effectuer une opération.

• Écrire du code sans définir le filtre : déterminez d’abord quels éléments sélectionner et selon quelles conditions, puis appuyez-vous sur la documentation de l’API et les exemples de code.

• Négliger les Transactions : si vos essais visent à modifier le modèle, intégrez les transactions à votre parcours d’apprentissage. Vérifiez la méthode exacte dans la documentation de l’API.

• Déduire des fonctions non mentionnées dans les sources à partir du nom d’un outil : RevitPythonShell, Revit Lookup et pyRevit figurent parmi les outils du cours, mais la source ne décrit ni toutes leurs fonctions ni les étapes d’installation à jour.

Étapes suivantes : workflows d’architecture et de visualisation

Vous pouvez suivre ce parcours de démarrage pour comprendre des données de projet comme le numéro et le nom d’une pièce, son type d’utilisation et ses finitions. La page consacrée à l’API Revit évoque des possibilités d’extension des fonctionnalités essentielles du logiciel dans des domaines comme l’automatisation, la simulation et la construction. Cela indique une piste à explorer pour les tâches de données répétitives ; cela ne signifie pas qu’une automatisation donnée produira le même résultat dans tous les projets.

Pour les architectes et les architectes d’intérieur, la priorité est de comprendre la nature des données du modèle et les propriétés disponibles. Les équipes BIM et de visualisation peuvent, quant à elles, évaluer le traitement des informations dont elles ont besoin au moyen de petits essais. Avant de passer à un outil plus important, vérifiez la compatibilité des outils avec la version de Revit utilisée, l’impact des modifications sur le projet et les conditions de licence. Le cours d’Autodesk University présente une approche d’accès à l’API à l’aide d’outils gratuits, mais cette mention ne précise pas les conditions de licence actuelles de tous les logiciels et de toutes les versions.

Sources et licence

Ce guide a été adapté en turc à partir de la page développeur de l’API Revit d’Autodesk, du document sur les propriétés des pièces de l’aide d’Autodesk Revit 2025 et du cours d’Autodesk University intitulé « Revit Programming for Beginners: Easily Access the Revit API Using Free Tools ». Les références indiquent le statut de licence « libre » ; aucune licence Creative Commons précise n’étant mentionnée, aucune affirmation relative à une licence ouverte n’est avancée.