Utilizzare gli script Python
Informazioni sul comando PIP
Con il comando PIP è possibile installare e gestire pacchetti Python, ad esempio pacchetti personalizzati che non fanno parte della libreria standard di Python.
Informazioni sul comando BIMPYTHON
Il comando BIMPYTHON consente di interrogare e gestire i dati di un modello in BricsCAD BIM, utilizzando uno script Python (*.py) appropriato.
Gli script python possono essere semplici per ottenere quantità e proprietà associate agli oggetti e alle entità BIM, o elaborati per implementare una serie di calcoli basati sui parametri disponibili nel modello.
Il programma di installazione di BricsCAD BIM include diversi script Python di esempio nella seguente cartella: C:\Users\%username%\AppData\Roaming\Bricsys\BricsCAD\V27x64\en_US\Support\Bim\Scripts
- calculate_weight.py consente di calcolare il peso delle entità in base al volume e alla densità.
- schedules.py consente di generare abachi personalizzati ed esportarli in file CSV.
- set_name_and_number.py compila le proprietà del nome e del numero in base al piano, al tipo BIM e alla posizione delle entità.
- tag_to_number.py consente di copiare il numero ID, se fa parte del Nome (dopo un’importazione IFC), nella proprietà Numero.
- thermal_transmittance.py calcola la trasmittanza termica in base alla conducibilità termica degli strati.
È possibile utilizzare gli script anche dalla scheda File del pannello Navigatore Progetto BIM (vedere l’articolo Pannello Navigatore Progetto BIM).
- BricsCAD non include una Shell Python, quindi gli script devono essere preparati in un editor di testo o di codice.
- Il linguaggio di programmazione Python, insieme alle sue librerie standard, è incorporato in BricsCAD BIM quindi non è necessario installarle separatamente, a meno che non si dispongano di pacchetti e librerie personalizzate che si desidera utilizzare negli script.
Esecuzione di uno script Python
- Aprire un nuovo file o un file BricsCAD dove si vuole eseguire uno script Python.
- Digita BIMPYTHON nella Barra dei comandi e premere Invio.
Si apre la finestra di dialogo Seleziona script Python.
- Selezionare un file PY e cliccare su Apri per eseguirlo.Nota: Se lo script contiene moduli non ancora installati, BricsCAD visualizza un messaggio che ne elenca i nomi. Utilizzare il comando PIP per installarli.
- A meno che non siano stati specificati i dati da esportare o visualizzare in un programma esterno al di fuori di BricsCAD, BricsCAD segnala l'output nella Barra dei comandi.
Configurazione di uno script Python
Utilizzare l'applicazione di testo o di codice che si preferisce per preparare lo script. Aprire un nuovo file, scrivere il codice necessario come illustrato di seguito, quindi salvare il file con estensione '.py'.
- Prima di ottenere l'accesso all'API, importa o chiama tutti i moduli che vuoi avere nello script.Nota: Se i moduli non fanno parte della libreria standard di Python, assicurarsi che siano stati installati separatamente in precedenza. A tale scopo, è possibile utilizzare il comando PIP.
È possibile utilizzare l'istruzione "import" per importare un modulo standard, come math, e l'istruzione "import as" per importare un modulo esterno, ad esempio Pyplot, che è una raccolta di funzioni contenute nel pacchetto matplotlib:
import math import matplotlib.pyplot as plt - Con le librerie desiderate "chiamate", il passo successivo consiste nell'ottenere l'accesso all'API per interrogare gli elementi all'interno del modello BricsCAD. Questo è l'intervallo di oggetti BIM ed è un punto di ingresso del modello.
Importare current_model dal modulo bricscad.bim:
da bricscad.bim import current_model - Ora, è possibile interrogare il modello con queste istruzioni di esempio.
# Visualizza le informazioni sulle lunghezze dei muri nel modello lengths = [wall.prop('Length') for wall in current_model().filter(Type='Wall')] print(f'wall lengths. max: {max(lengths)}, avg: {sum(lengths)/len(lengths)}')# Crea una selezione e stampa gli oggetti current_model().filter(Type='Wall', IsExternal=True).select() for wall in bim_model.filter(Type='Wall', IsExternal=True, Length=max(lengths)): print(wall)I mappatori del bricscad.bim.Objects sono concatenabili. Questo è un esempio per ottenere le parti del tetto che sono vicine a un muro:
# Ottieni tutte le parti del tetto entro un raggio di 40 cm da tutte le pareti 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)Mentre questo è un esempio di istruzione di una funzione per filtrare:
# Filtrare le parti del tetto più lunghe di 50 unità di progetto def is_long(obj): return obj.prop('Length') > 50 roof_parts.filter(is_long) -
È inoltre possibile esportare e mostrare i dati in vari formati:
# Crea una lista di dizionari 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')]# esporta in .json import json file = open('C:\Users\%username%\Desktop\file.json', 'w+') file.write(json.dumps(wall_info, indent=4)) file.close()# tracciare un istogramma import matplotlib.pyplot as plt import pandas as pd df = pd.DataFrame(wall_info) df.hist(); plt.show()# esporta in .csv df.to_csv(r'C:\Users\%username%\Desktop\file.csv', index = False)
Classi e sintassi dell’API di BricsCAD
- get_property(prop_name)
- Restituisce il valore della proprietà dell'Oggetto con il nome specificato.
- set_property(prop_name, value)
- Imposta un valore per il nome della proprietà (prop_name).
- distance_to(other_obj, units='mm', distance_mode='exact')
-
- Calcola la distanza tra due Oggetti.
- Opzioni per l'argomento units: qualsiasi valore di unità di misura di insunits ('Centimeters', 'Feet', 'Parsecs' ecc.) e le abbreviazioni 'mm', 'cm', 'm', 'km' e 'ft'.
- Opzioni per l'argomento distance_mode: 'bbox_center', 'bbox', 'exact'.
- parts()
- Restituisce i sottoelementi di questo oggetto.
- parent()
- L'opposto di parts() restituisce l'oggetto padre di questo elemento secondario.
- plies()
- Restituisce gli
Stratiassociati all'oggetto.
- within_distance(distance, unit='mm', distance_mode='exact', search_range=bim_model)
-
- Restituisce gli oggetti che si trovano entro la distanza dell'argomento distanza.
- Opzioni per l'argomento units: vedere distance_to.
- Opzioni per l'argomento distance_mode: vedi distance_to.
- openings()
- Restituisce le aperture associate di questo oggetto.
- spaces()
- Restituisce gli spazi associati di questo oggetto.
- bounding_elements()
- Restituisce gli elementi di contorno associati di questo oggetto (space).
- select()
- Aggiunge Oggetti alla selezione.
- deselect()
- Rimuove Oggetti dalla selezione.
- __eq__() and __hash__()
- Rende l'Oggetto interoperabile, ad esempio, con un insieme o dizionario Python.
- classe bricscad.bim.Objects
- Definisce la collezione degli Oggetti di BricsCAD BIM
- bricscad.bim.list_properties(obj)
- Restituisce l'elenco delle proprietà disponibili dell'entità passata o dello strato.
- bricscad.bim.current_model()
- Restituisce gli Oggetti nello spazio modello del documento attivo.
- class bricscad.bim.Plies
- Contenitore sezionabile e indicizzato di oggetti Strato:
- class bricscad.bim.Ply
- Oggetto singolo strato.
