Usar scripts Python

Sobre o comando PIP

Com o comando PIP, você pode instalar e gerenciar pacotes Python, por exemplo, pacotes personalizados que não fazem parte da biblioteca padrão do Python.

Sobre o comando BIMPYTHON

Com o comando BIMPYTHON, você pode consultar e gerenciar dados de um modelo dentro do BricsCAD BIM, utilizando um script Python (*.py) adequado.

Os scripts Python podem ser tão simples quanto obter quantidades e propriedades associadas de objetos e entidades BIM, ou ser tão elaborados quanto implementar uma série de cálculos com base nos parâmetros disponíveis do modelo.

Vários scripts Python de exemplo estão disponíveis no instalador BricsCAD BIM, na pasta C:\Users\%username%\AppData\Roaming\Bricsys\BricsCAD\V27x64\en_US\Support\Bim\Scripts:

  • O arquivo calculate_weight.py permite calcular o peso de entidades com base em seu volume e densidade.
  • O arquivo schedules.py permite gerar 'schedules' personalizados, e exportá-los para arquivos CSV.
  • O arquivo set_name_and_number.py preenche as propriedades de nome e número com base no pavimento, tipo de BIM, e no seu Local.
  • O arquivo tag_to_number.py permite copiar o número ID, caso faça parte do Nome (após uma importação IFC), para a propriedade Number (número).
  • O arquivo thermal_transmittance.py calcula a transmitância térmica com base na condutividade térmica das subcamadas.

Você também pode usar scripts de dentro da aba Arquivos do painel BIM Navegador de Projetos (veja o artigo do painel BIM Navegador do Projeto).

Nota:
  • O BricsCAD não inclui uma interface (Shell) Python, portanto, os scripts precisam ser preparados numa aplicação para edição de texto ou de código.
  • A Linguagem de Programação Python - Python Programming Language, juntamente com suas bibliotecas padrão, está incorporada no BricsCAD BIM, portanto não há necessidade de instalá-las separadamente, a menos que você tenha pacotes personalizados e bibliotecas de seu uso, que deseja utilizar em seus scripts.

Executando um script Python

  1. Abra um novo ou um arquivo do BricsCAD no qual você gostaria de executar um script Python.
  2. Digite BIMPYTHON na linha de Comando, e pressione Enter.

    A caixa de diálogo Selecione o Script Python é aberta.

  3. Selecione um arquivo PY e clique Abrir para executá-lo.
    Nota: Se o script contiver módulos que ainda não estejam instalados, BricsCAD exibe uma mensagem listando seus nomes. Use o comando PIP para instalá-los.
  4. A menos que você tenha especificado que os dados devem ser exportados ou exibidos em um programa externo BricsCAD, BricsCAD exibe a saída na linha de Comando.

Configurando um script Python

Utilize o editor de texto ou de código de sua preferência para preparar o script. Abra um novo arquivo, escreva o código necessário conforme exemplificado abaixo, então salve o arquivo com a extensão '.py'.

  1. Antes de obter acesso à API, importe ou 'call' (chame) os módulos desejados que você deseja ter no script.
    Nota: Se os módulos não fazem parte da biblioteca standard Python, certifique-se de que esses foram instalados separadamente de antemão. Para isso, você pode usar o comando PIP.

    Você pode "importar" um módulo padrão, como 'Math' e "importar como" um módulo externo, como por exemplo Pyplot, que é uma coleção de funções no pacote Matplotlib:

    import math  
    import matplotlib.pyplot as plt
  2. Com as bibliotecas escolhidas sendo "chamadas", o próximo passo é obter acesso à API para consultar os elementos dentro do modelo do BricsCAD. Esta é a faixa de objetos BIM, e serve como um ponto de entrada para o modelo.

    Importe o current_model (modelo_atual) do módulo bricscad.bim:

    from bricscad.bim import current_model
  3. Agora, você pode consultar o modelo com essas instruções de exemplo.
    # Display info about the lengths of walls in the model 
    lengths = [wall.prop('Length') for wall in current_model().filter(Type='Wall')] 
    print(f'wall lengths. max: {max(lengths)}, avg: {sum(lengths)/len(lengths)}') 
    # Create a selection and print the objects 
    current_model().filter(Type='Wall', IsExternal=True).select() 
    for wall in bim_model.filter(Type='Wall', IsExternal=True, Length=max(lengths)): 
        print(wall) 

    Os mapeadores do bricscad.bim.Objects são encadeáveis. Este é um exemplo para obter as partes do telhado que estão perto de uma parede:

    # Get all parts of roof within 40cm range of all walls 
    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) 

    Onde este é um exemplo de uma instrução de função para filtrar:

    # Filter roof parts longer than 50 project units 
    def is_long(obj):  
        return obj.prop('Length') > 50 
    roof_parts.filter(is_long) 
  4. Você também pode exportar e mostrar dados em vários formatos:

    # create a dictionary list 
    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')] 
    # export to .json 
    import json 
    file = open('C:\Users\%username%\Desktop\file.json', 'w+') 
    file.write(json.dumps(wall_info, indent=4)) 
    file.close() 
    # plotting a histogram 
    import matplotlib.pyplot as plt 
    import pandas as pd 
    df = pd.DataFrame(wall_info) 
    df.hist(); 
    plt.show() 
    # export to .csv 
    df.to_csv(r'C:\Users\%username%\Desktop\file.csv', index = False) 

BricsCAD API Classes e sintaxes

get_property(prop_name)
Retorna o valor da propriedade do Objeto com o nome fornecido.
set_property(prop_name, value)
Define um valor para o nome da propriedade (prop_name).
distance_to(other_obj, units='mm', distance_mode='exact')
  • Calcula a distância entre dois Objetos.
  • Opções para argumento units (unidades): quaisquer valores de unidades de INSUNITS ('Centimetros', 'Pés', 'Sub-unidades' etc.) e suas abreviações: 'mm', 'cm, 'm', 'km', 'ft'.
  • Options for argument distance_mode: 'bbox_center', 'bbox', exact'.
parts()
Retorna os sub-elementos desse objeto.
parent()
The opposite of parts(), returns the parent object of this sub-element.
plies()
Retorna o objeto iterável Subcamadas associado.
within_distance(distance, unit='mm', distance_mode='exact', search_range=bim_model)
  • Retorna os objetos que estão dentro do argumento distance (distância).
  • Opções para argumento units: consulte distance_to.
  • Opções para argumento distance_mode: veja distance_to.
openings()
Retorna as aberturas associadas desse objeto.
spaces()
Retorna os espaços associados desse objeto.
bounding_elements()
Retorna os elementos delimitadores associados desse objeto (espaço).
select()
Adiciona Objeto à seleção.
deselect()
Remove Objeto da seleção.
__eq__() and __hash__()
Torna o Objeto interoperável, ex., com um conjunto ou dicionário em Python.
class BricsCAD.BIM.Objects
Define a coleção de Objetos BricsCAD BIM
filter(function)
Filtra esse intervalo com um parâmetro de função.
filter( **conditions )
Filtra esse intervalo com condições dadas como argumentos de palavra-chave.
parts()
Retorna as peças de todos os elementos nesse intervalo.
parents()
Retorna os objetos 'pai' dos elementos nesse intervalo.
within_distance(distance, unit='undefined', distance_mode='exact', search_range=bim_model)
Retorna aqueles objetos que estão a uma distância de qualquer objeto nesse intervalo.
openings()
Retorna as aberturas associadas a esses objetos.
spaces()
Retorna os espaços associados desses objetos.
bounding_elements()
Retorna os elementos delimitadores associados desses objetos (espaciais).
select()
Adicionar Objetos à seleção.
deselect()
Remove Objetos da seleção.
__len__ ()
Retorna o número de Objetos neste intervalo.
bricscad.bim.list_properties(obj)
Retorna a lista de propriedades disponíveis da entidade passada ou subcamada.
bricscad.bim.current_model()
Retorna os Objetos no Model Space do documento ativo.
class bricscad.bim.Plies
Contêiner indexado e fatiável de objetos Ply (subcamada).
__iter__()
__getitem__(index)
__getitem__(slice)
__len__()
class bricscad.bim.Ply
Objeto subcamada individual.
get_property(prop_name)
Retorna o valor da propriedade do objeto Subcamada com o nome fornecido.