Verwenden von Python-Skripten
Über den PIP-Befehl
Mit dem Befehl PIP können Sie Python-Pakete installieren und verwalten, beispielsweise benutzerdefinierte Pakete, die nicht Teil der Python-Standardbibliothek sind.
Über den Befehl BIMPYTHON
Mit dem Befehl BIMPYTHON können Sie Daten aus einem Modell in BricsCAD BIM abfragen und verwalten, indem Sie ein geeignetes Python-Skript (*.py) verwenden.
Die Python-Skripte können so einfach sein wie das Abrufen von Mengen und zugehörigen Eigenschaften von Objekten und BIM-Objekten oder so aufwendig wie die Implementierung einer Reihe von Berechnungen auf der Grundlage der verfügbaren Modellparameter.
Mehrere Beispiel-Python-Skripte sind im BricsCAD BIM Installer im Ordner C:\Users\%Benutzername%\AppData\Roaming\Bricsys\BricsCAD\V27x64\de_DE\Support\Bim\Scripts verfügbar:
- calculate_weight.py ermöglicht die Berechnung des Gewichts von Objekten auf Basis ihres Volumens und ihrer Dichte.
- schedules.py ermöglicht das Generieren benutzerdefinierter Bauteillisten und deren Export in CSV-Dateien.
- set_name_and_number.py füllt die Eigenschaften Name und Nummer basierend auf dem Geschoss, dem BIM-Typ und deren Position.
- tag_to_number.py ermöglicht das Kopieren der ID-Nummer, falls diese Teil des Namens ist (nach einem IFC-Import), in die Eigenschaft Nummer.
- thermal_transmittance.py berechnet die Wärmedurchlässigkeit auf Basis der Wärmeleitfähigkeit der Schichten.
Sie können auch Skripte innerhalb der Registerkarte Dateien des Panels BIM Projekt-Browser verwenden (siehe den Artikel BIM Projekt-Browser Panel).
- BricsCAD wird ohne Python-Shell ausgeliefert, daher müssen die Skripte in einem Text- oder Code-Editor erstellt werden.
- Die Programmiersprache Python ist zusammen mit ihren Standardbibliotheken in BricsCAD BIM eingebettet, so dass Sie diese nicht separat installieren müssen, es sei denn, Sie haben eigene Pakete und Bibliotheken, die Sie in Ihren Skripten verwenden möchten.
Ausführung eines Python-Skripts
- Öffnen Sie eine neue Datei oder eine BricsCAD-Datei, in der Sie ein Python-Skript ausführen möchten.
- Geben Sie BIMPYTHON in die Befehlszeile ein und drücken Sie die Eingabetaste.
Der Dialog Python-Skript auswählen wird geöffnet.
- Wählen Sie eine PY-Datei aus und klicken Sie auf Öffnen, um sie auszuführen.Anmerkung: Wenn das Skript Module enthält, die noch nicht installiert sind, zeigt BricsCAD eine Meldung an, in der deren Namen aufgeführt sind. Verwenden Sie den Befehl PIP, um sie zu installieren.
- Sofern Sie nicht angegeben haben, dass die Daten in einem externen Programm außerhalb von BricsCAD exportiert oder angezeigt werden sollen, meldet BricsCAD die Ausgabe in der Befehlszeile.
Einrichten eines Python-Skripts
Verwenden Sie zum Erstellen des Skripts einen Text- oder Code-Editor Ihrer Wahl. Öffnen Sie eine neue Datei, schreiben Sie den erforderlichen Code wie unten gezeigt und speichern Sie die Datei anschließend mit der Endung ".py".
- Bevor Sie Zugriff auf die API erhalten, importieren oder rufen Sie alle gewünschten Module auf, die Sie im Skript haben möchten.Anmerkung: Wenn die Module nicht Teil der Python-Standardbibliothek sind, stellen Sie sicher, dass sie zuvor separat installiert wurden. Dazu können Sie den Befehl PIP verwenden.
Sie können "importieren" für ein Standardmodul verwenden, z. B. Mathematik, und "importieren als" für ein externes Modul, z. B. Pyplot, das eine Sammlung von Funktionen im Matplotlib-Paket ist:
import math import matplotlib.pyplot as plt - Wenn Ihre gewünschten Bibliotheken "aufgerufen" sind, besteht der nächste Schritt darin, Zugriff auf die API zu erhalten, um die Elemente innerhalb des BricsCAD-Modells abzufragen. Dies ist der Bereich der BIM-Objekte und dient als Einstiegspunkt in das Modell.
Importieren Sie das aktuelle Modell aus dem Modul bricscad.bim:
from bricscad.bim import current_model - Jetzt können Sie das Modell mit diesen Beispielanweisungen abfragen:
# Informationen über die Längen von Wänden im Modell anzeigen lengths = [wall.prop('Length') for wall in current_model().filter(Type='Wall')] print(f'wall lengths. max: {max(lengths)}, avg: {sum(lengths)/len(lengths)}')# Erstellen Sie eine Auswahl und drucken Sie die Objekte current_model().filter(Type='Wall', IsExternal=True).select() for wall in bim_model.filter(Type='Wall', IsExternal=True, Length=max(lengths)): print(wall)Die Mapper der bricscad.bim.Objects sind verkettbar. Dies ist ein Beispiel, um die Teile des Daches zu erhalten, die sich in der Nähe einer Wand befinden:
# Holen Sie sich alle Teile des Daches in eine Reichweite von 40 cm von allen Wänden roof_parts = current_model().filter(Type='Roof').parts() roof_parts_close_to_wall = current_model().filter(Type='Wall').within_distance(40, 'cm', search_range=roof_parts)Während dies ein Beispiel für eine Funktionsanweisung zum Filtern ist:
# Dachteile filtern, die länger als 50 Projekteinheiten sind def is_long(obj): return obj.prop('Length') > 50 roof_parts.filter(is_long) -
Sie können Daten in verschiedenen Formaten exportieren und anzeigen:
# Erstellen Sie eine Wörterbuchliste wall_info = [ { 'Handle': wall.get_property('Handle'), 'Length': wall.get_property('Length'), 'Height': wall.get_property('Height') } for wall in current_model().filter(Type='Wall')]# Nach .json exportieren import json file = open('C:\Users\%username%\Desktop\file.json', 'w+') file.write(json.dumps(wall_info, indent=4)) file.close()# Plotten eines Histogramms import matplotlib.pyplot as plt import pandas as pd df = pd.DataFrame(wall_info) df.hist(); plt.show()# Nach .csv exportieren df.to_csv(r'C:\Users\%username%\Desktop\file.csv', index = False)
BricsCAD API-Klassen und Syntaxen
- get_property(prop_name)
- Gibt den Eigenschaftswert des Objekts mit dem angegebenen Namen zurück.
- set_property(prop_name, value)
- Legt einen Wert für den Eigenschaftsnamen (prop_name) fest.
- distance_to(other_obj, units='mm', distance_mode='exact')
-
- Berechnet die Entfernung zwischen zwei Objekten.
- Optionen für Argument units: alle Einheiten aus insunits ('Zentimeter', 'Fuß', 'Parsec' usw.) und die Abkürzungen 'mm', 'cm, 'm', 'km' und 'ft'.
- Optionen für Argument distance_mode: 'bbox_center', 'bbox', exact'.
- parts()
- Gibt die Unterelemente dieses Objekts zurück.
- parent()
- Das Gegenteil von parts(), gibt das übergeordnete Objekt dieses Unterelements zurück.
- plies()
- Gibt das zugeordnete iterierbare Objekt
Plieszurück.
- within_distance(distance, unit='mm', distance_mode='exact', search_range=bim_model)
-
- Gibt die Objekte zurück, die sich innerhalb des Abstands des Arguments distance befinden.
- Optionen für Argument units: sehen Sie distance_to.
- Optionen für Argument distance_mode: sehen Sie distance_to.
- openings()
- Gibt die zugehörigen Öffnungen dieses Objekts zurück.
- spaces()
- Gibt die zugeordneten Bereiche dieses Objekts zurück.
- bounding_elements()
- Gibt die zugehörigen Begrenzungselemente dieses (Bereich-) Objekts zurück.
- select()
- Fügt Objekt zur Auswahl hinzu.
- deselect()
- Entfernt das Objekt aus der Auswahl.
- __eq__() and __hash__()
- Macht das Objekt interoperabel, zum Beispiel mit einem Python-Satz oder -Wörterbuch.
- class bricscad.bim.Objects
- Definiert die Sammlung von BricsCAD BIM-Objekten
- bricscad.bim.list_properties(obj)
- Gibt die Liste der verfügbaren Eigenschaften der übergebenen Entität oder Schicht zurück.
- bricscad.bim.current_model()
- Gibt die Objekte im Modelbereich des aktiven Dokuments zurück.
- class bricscad.bim.Plies
- Indexierter, aufteilbarer Container mit Schicht-Objekten:
- class bricscad.bim.Ply
- Einzelnes Schicht-Objekt.
