Revit API mit Python: Einstieg, Tools und erster Workflow

Was lernen Sie in diesem Leitfaden?

Beim Einstieg in die Revit API geht es nicht darum, sofort ein umfangreiches Plug-in zu entwickeln. Zunächst sollten Sie verstehen, wie sich Elemente im Modell finden, Eigenschaften auslesen und Änderungen verwalten lassen. Der Einsteigerkurs von Autodesk stellt den Zugang zur Revit API mit kostenlosen Tools vor. Zu den zentralen Themen gehören Elementfilter, Transaktionen (Transactions) und die Benutzeroberfläche. Auch das Speichern und Verwenden von Python-Tools zählt zu den Lernzielen.

Dieser Leitfaden fasst die Themen zu einem kleinen Workflow rund um Raumdaten zusammen. Ein Raum ist ein anschauliches Beispiel, um Eigenschaften zu Projektdaten wie Name, Nummer, Nutzungsart und Oberflächen zu untersuchen. Ziel ist nicht, einen bestimmten API-Aufruf oder ausführbaren Code vorzugeben, sondern die durch die Quellen belegten Tools und die Reihenfolge beim Lernen zu erläutern. Versionsangaben, Installationswege oder Codebeispiele, die in den Quellen nicht genannt werden, werden nicht vorausgesetzt.

Voraussetzungen und Tools

Im Kurs der Autodesk University kommen RevitPythonShell, Revit Lookup und pyRevit zum Einsatz. Teilnehmende sollten grundlegende Revit-Kenntnisse und Python-Kenntnisse auf Anfängerniveau mitbringen. Laut der Revit-Entwicklerseite von Autodesk bietet die API eine .NET-basierte Schnittstelle, mit der sich wiederkehrende Aufgaben automatisieren und die Kernfunktionen von Revit erweitern lassen.

Prüfen Sie vor dem Einstieg folgende Punkte:

• Die verwendete Revit-Installation und die Projektdatei.

• Grundkenntnisse in Revit und Python-Kenntnisse auf Anfängerniveau.

• Installations- und Kompatibilitätsinformationen für RevitPythonShell, Revit Lookup und pyRevit in Verbindung mit der verwendeten Revit-Version.

Der Einsteigerkurs nennt weder eine bestimmte Revit-Version noch die aktuellen Kompatibilitätsbedingungen der einzelnen Tools. Prüfen Sie daher vor der Installation die Dokumentation der jeweiligen Tools. Da die Quellen auch keine Anforderungen an ein Benutzerkonto erläutern, sollte keine bestimmte Kontoanforderung vorausgesetzt werden.

Schritt für Schritt zum Einstieg

1. Untersuchen Sie zuerst die Raumdaten in Revit. Wählen Sie einen Raum aus und sehen Sie sich die Felder in der Eigenschaften-Palette an. In der Dokumentation von Autodesk zu Raumeigenschaften werden beispielhaft Raumname, Nummer, Nutzungsart, Abteilung sowie Wand-, Decken- und Bodenoberflächen aufgeführt. Fläche und Umfang sind schreibgeschützt; auch das Volumen ist als schreibgeschützt angegeben, allerdings nur, wenn die Volumenberechnung aktiviert ist. Wenn Sie diesen Unterschied verstehen, können Sie besser entscheiden, welche Daten Sie auslesen und welche Sie ändern möchten.

2. Formulieren Sie den ersten Versuch als Aufgabe zum Finden von Elementen. Beginnen Sie zum Beispiel damit, Räume im Projekt nach einem bestimmten Kriterium zu identifizieren. Im Kurs der Autodesk University zählt das Sammeln und Filtern von Elementen mit RevitPythonShell zu den grundlegenden Lernzielen. Beschreiben Sie in einfachen Worten, welche Elemente ausgewählt werden sollen und was die Filterbedingung bedeutet, bevor Sie Code schreiben. Prüfen Sie konkrete API-Aufrufe anhand der Entwicklerdokumentation und der Codebeispiele von Autodesk.

3. Behalten Sie Revit Lookup in der Tool-Liste des Kurses. Die Quelle der Autodesk University nennt Revit Lookup als eines der im Kurs verwendeten Tools, erläutert aber weder dessen Funktionen noch einzelne Arbeitsschritte näher. Prüfen Sie daher die Dokumentation des Tools, statt eine bestimmte Funktion oder einen bestimmten Menüpfad vorauszusetzen. So behandeln Sie keine Funktion, die von den Quellen nicht belegt wird, als festen Bestandteil des Lernpfads.

4. Lernen Sie Modelländerungen zusammen mit dem Thema Transactions. Der Kurs führt Änderungen an Elementen über RevitPythonShell als eines der Hauptthemen auf. Definieren Sie vor Versuchen, die Modelldaten verändern, die gewünschte Änderung klar und in kleinem Umfang. Einen Wert wie den Raumnamen zu ändern ist etwas anderes, als einen schreibgeschützten Wert wie die Fläche auszulesen. Gehen Sie nicht zu einer umfangreichen Automatisierung über, bevor Sie die Auswirkungen der Änderung auf die Projektdatei geprüft haben. Da die Quellen kein konkretes Codebeispiel zum Starten und Beenden einer Transaktion enthalten, sollten Sie die passende Vorgehensweise in der einschlägigen API-Dokumentation nachschlagen.

5. Legen Sie fest, wie Sie ein Python-Tool speichern und wiederverwenden möchten. Auch das Speichern und Verwenden von Python-Tools zählt zu den Lernzielen des Einsteigerkurses. Bereiten Sie zunächst einen kleinen Versuch für eine einzelne Aufgabe vor und prüfen Sie anschließend, ob Sie dieselbe Lösung erneut benötigen. pyRevit steht zwar auf der Tool-Liste des Kurses, der Quellentext nennt jedoch weder einen bestimmten pyRevit-Befehl noch einen konkreten Workflow. Installations- und Anwendungsdetails finden Sie in der aktuellen Dokumentation des Tools.

6. Vergleichen Sie das Ergebnis mit den Raumeigenschaften. Wenn Sie die Ergebnisse Ihrer API-Arbeit mit den in Revit angezeigten Raumeigenschaften vergleichen, können Sie die ausgelesenen Daten überprüfen. Laut Autodesk-Dokumentation muss die Raumnummer innerhalb des Projekts eindeutig sein. Wurde die Nummer bereits verwendet, zeigt Revit eine Warnung an, erlaubt aber die Fortsetzung. Verwechseln Sie eine Warnung während des Tests nicht damit, dass der Vorgang vollständig blockiert wird. Fläche und Umfang sind schreibgeschützt; beim Volumen hängt der Schreibschutz davon ab, ob die Volumenberechnung aktiviert ist.

Häufige Fehler

• Eine Version voraussetzen: Der Einsteigerkurs nennt weder eine bestimmte Revit- noch eine Tool-Version. Prüfen Sie Installations- und Kompatibilitätsangaben gesondert.

• Annehmen, dass sich jede Raumeigenschaft bearbeiten lässt: Fläche und Umfang sind schreibgeschützt. Auch das Volumen ist nur dann als schreibgeschützt angegeben, wenn die Volumenberechnung aktiviert ist. Prüfen Sie die Eigenschaft, bevor Sie sie bearbeiten.

• Code schreiben, bevor der Filter feststeht: Legen Sie zunächst fest, welche Elemente anhand welcher Bedingung ausgewählt werden sollen. Arbeiten Sie anschließend mit der API-Dokumentation und den Codebeispielen weiter.

• Transactions auslassen: Nehmen Sie das Thema Transaktionen in Ihren Lernplan auf, wenn Sie Änderungen am Modell vornehmen möchten. Prüfen Sie die konkrete Vorgehensweise in der API-Dokumentation.

• Aus einem Tool-Namen Funktionen ableiten, die in den Quellen nicht beschrieben werden: RevitPythonShell, Revit Lookup und pyRevit werden als Tools des Kurses aufgeführt. Die Quellen erläutern jedoch weder sämtliche Funktionen der Tools noch aktuelle Installationsschritte.

Nächste Schritte: Workflows in Architektur und Visualisierung

Mit diesem Einstieg können Sie Projektdaten wie Raumnummer, Name, Nutzungsart und Oberflächen besser verstehen. Die Revit-API-Seite von Autodesk nennt Möglichkeiten, die Kernfunktionen der Software unter anderem für Automatisierung, Simulation und Bauwesen zu erweitern. Das bietet einen Ansatzpunkt, um wiederkehrende Datenaufgaben zu untersuchen, bedeutet aber nicht, dass eine bestimmte Automatisierung in jedem Projekt dasselbe Ergebnis liefert.

Für Architektinnen, Architekten und Innenarchitekturteams ist es wichtig, die Beschaffenheit der Modelldaten und die verfügbaren Eigenschaften zu verstehen. BIM- und Visualisierungsteams können in kleinen Tests prüfen, wie sich die benötigten Informationen verarbeiten lassen. Bevor Sie ein größeres Tool entwickeln, kontrollieren Sie die Kompatibilität mit der verwendeten Revit-Version, die Auswirkungen von Änderungen auf das Projekt und die Lizenzbedingungen. Der Kurs der Autodesk University beschreibt den Zugang zur API mit kostenlosen Tools; diese Aussage erläutert jedoch nicht die aktuellen Lizenzbedingungen aller Softwareprodukte und Versionen.

Quellen und Lizenz

Dieser Leitfaden wurde auf Grundlage der Revit-API-Entwicklerseite von Autodesk, der Dokumentation zu Raumeigenschaften in der Autodesk Revit 2025-Hilfe und des Kurses „Revit Programming for Beginners: Easily Access the Revit API Using Free Tools“ der Autodesk University ins Türkische übertragen und redaktionell angepasst. In den Quelldatensätzen ist der Lizenzstatus als „frei“ angegeben. Da keine konkrete Creative-Commons-Lizenz genannt wird, wird keine offene Lizenz behauptet.