Uso de secuencias de comandos de Python

Acerca del mando PIP

Con el comando PIP, puede instalar y gestionar paquetes de Python, por ejemplo, paquetes personalizados que no forman parte de la biblioteca estándar de Python.

Acerca del comando BIMPYTHON

Con el comando BIMPYTHON, puede consultar y gestionar datos de un modelo dentro BricsCAD BIMde , usando un script Python (*.py) adecuado.

Los scripts de Python pueden ser tan simples como obtener cantidades y propiedades asociadas de objetos y entidades BIM, o tan elaborados como implementar una serie de cálculos basados en los parámetros del modelo disponibles.

Varios scripts de ejemplo en Python están disponibles en el BricsCAD BIM instalador, en la carpeta C:\Users\%username%\AppData\Roaming\Bricsys\BricsCAD\V27x64\en_US\Support\Bim\Scripts :

  • calculate_weight.py permite calcular el peso de las entidades en función de su volumen y densidad.
  • schedules.py permite generar horarios personalizados y exportarlos a archivos CSV.
  • set_name_and_number.py llena las propiedades de nombre y número según la historia, el tipo de BIM y su ubicación.
  • tag_to_number.py permite copiar el número ID, si forma parte del Nombre (tras una importación IFC), a la propiedad Número.
  • thermal_transmittance.py calcula la transmitancia térmica en función de la conductividad térmica de las capas.

También puede usar scripts desde la pestaña Archivos del panel Navegador de Proyectos BIM (consulta el artículo sobre el panel Navegador de Proyectos BIM ).

Nota:
  • BricsCAD no se entrega con un Shell de Python, por lo que los scripts deben prepararse en una aplicación de editor de texto o código.
  • El lenguaje de programación Python, junto con sus bibliotecas estándar, está integrado BricsCAD BIM , por lo que no es necesario instalarlos por separado a menos que tenga bibliotecas y paquetes personalizados que desee usar en sus scripts.

Ejecutando un script en Python

  1. Abre un nuevo archivo o BricsCAD un archivo donde quieras ejecutar un script en Python.
  2. Escriba BIMPYTHON en la línea de comandos y pulse Enter.

    Se abre el cuadro de diálogo Seleccionar script en Python .

  3. Seleccione un archivo PY y haga clic en Abrir para ejecutarlo.
    Nota: Si el script contiene módulos que no están ya instalados, BricsCAD muestra un mensaje con sus nombres. Usa el comando PIP para instalarlos.
  4. A menos que haya especificado que los datos se exporten o muestren en un programa externo fuera BricsCADde , BricsCAD informe la salida en la línea de comandos.

Configuración de un script en Python

Utilice la aplicación de texto o editor de código que elija para preparar el guion. Abra un nuevo archivo, escriba el código necesario tal como se ejemplifica a continuación y luego guarde el archivo con la extensión '.py'.

  1. Antes de obtener acceso a la API, importe o "llame" a los módulos que desee tener en el script.
    Nota: Si los módulos no forman parte de la biblioteca estándar de Python, asegúrate de que hayan sido instalados por separado de antemano. Para esto, puedes usar el comando PIP.

    Puede "importar" un módulo estándar, como matemáticas e "importar como" uno externo, por ejemplo Pyplot, que es una colección de funciones en el paquete matplotlib:

    importar matemáticas 
    importar matplotlib.pyplot como plt
  2. Una vez "llamadas" las bibliotecas que desee, el siguiente paso es obtener acceso a la API para consultar los elementos dentro del BricsCAD modelo. Esta es la gama de objetos BIM y sirve como punto de entrada al modelo.

    Importa el current_model desde el módulo bricscad.bim:

    desde bricscad.bim importar modelo_actual
  3. Ahora, puedes consultar el modelo con estas sentencias de ejemplo:
    # Mostrar información sobre las longitudes de las paredes en el modelo 
     lengths = [wall.prop('Length') para pared en current_model().filter(Type='Wall')] 
    print(f'longitudes de pared. máx: {max(longitudes)}, promedio: {suma(longitudes)/len(longitudes)}') 
    # Crea una selección e imprime los objetos 
     current_model().filter(Type='Wall', IsExternal=True).select() 
     para muro en bim_model.filter(Type='Wall', IsExternal=True, Longitud=max(longitudes)): 
     impresión (pared) 

    Los mapeadores de bricscad.bim.Objects son encadenables. Este es un ejemplo para obtener las partes del techo que están cerca de una pared:

    # Obtener todas las partes del techo dentro del rango de 40 cm de todas las paredes 
     Roof_parts = current_model().filter(Type='Roof').parts() 
     Roof_parts_close_to_wall = current_model().filter(Type='Wall').within_distance(40 , 'cm', rango_búsqueda=partes_del_techo) 

    Mientras que este es un ejemplo de una declaración de función para filtrar:

    # Filtrar partes del techo de más de 50 unidades de proyecto 
     def is_long(obj): 
     return obj.prop('Length') > 50 
     roof_parts.filter(is_long) 
  4. También puede exportar y mostrar datos en varios formatos:

    # crear una lista de diccionario 
     wall_info = [ 
     { 'Handle': wall.get_property('Handle'), 
            'Longitud': wall.get_property('Longitud'), 
            'Altura': wall.get_property('Altura') 
        } para pared en current_model().filter(Type='Wall')] 
    # exportar a .json 
    import json 
    file = open('C:\Users\%username%\Desktop\file.json', 'w+') 
    archivo.write(json.dumps(wall_info, indent=4)) 
    file.close() 
    # trazar un histograma 
     importar matplotlib.pyplot como plt 
     importar pandas como pd 
     df = pd.DataFrame(wall_info) 
     df.hist(); 
     plt.mostrar() 
    # exportar a .csv 
    df.to_csv(r'C:\Users\%username%\Desktop\file.csv', índice = Falso) 

BricsCAD Clases de API y sintaxis

get_property(prop_name)
Devuelve el valor de la propiedad del Objeto con el nombre dado.
set_property(prop_name, valor)
Establece un valor para el nombre de la propiedad (prop_name).
distance_to(other_obj, unidades='mm', distance_mode='exacto')
  • Calcula la distancia entre dos objetos.
  • Opciones para unidades argumentativas: cualquier valor de unidades de unidades ('Centímetros', 'Pies', 'Parsecs', etc.) y las abreviaturas 'mm', 'cm', 'm', 'km' y 'ft'.
  • Opciones para el argumento modo_distancia: 'bbox_center', 'bbox', exacto'.
partes()
Devuelve los subelementos de este objeto.
padre()
Lo contrario de parts(), devuelve el objeto principal de este subelemento.
capas()
Devuelve el objeto iterablePlies asociado.
within_distance(distancia, unidad='mm', distance_mode='exacto', search_range=bim_model)
  • Devuelve los objetos que están dentro de la distancia de la distancia del argumento.
  • Opciones para unidades de argumento: ver distancia_a.
  • Opciones para el argumento modo_distancia: ver distancia_hasta.
aperturas()
Devuelve las aberturas asociadas de este objeto.
espacios()
Devuelve los espacios asociados de este objeto.
delimitando_elementos()
Devuelve los elementos delimitadores asociados de este objeto (espacio).
seleccionar()
Agrega objetos a la selección.
deseleccionar()
Elimina el objeto de la selección.
__eq__() y __hash__()
Hace que el objeto sea interoperable, por ejemplo, con un conjunto o diccionario en Python.
clase bricscad.bim.Objects
Define la colección de BricsCAD BIM objetos
filter(función)
Filtra este rango con un parámetro de función.
filtro( **condiciones )
Filtra este rango con condiciones dadas como argumentos de palabras clave.
partes()
Devuelve las partes de todos los elementos de este rango.
padres()
Devuelve los objetos principales de los elementos en este rango.
within_distance(distancia, unidad='indefinido', distance_mode='exacto', search_range=bim_model)
Devuelve aquellos objetos que están dentro de la distancia de cualquier objeto en este rango.
aperturas()
Devuelve las aberturas asociadas de estos objetos.
espacios()
Devuelve los espacios asociados de estos objetos.
delimitando_elementos()
Devuelve los elementos delimitadores asociados de estos objetos (espaciales).
seleccionar()
Agrega objetos a la selección.
deseleccionar()
Elimina objetos de la selección.
__len__ ()
Devuelve el número de objetos en este rango.
bricscad.bim.list_properties(obj)
Devuelve la lista de propiedades disponibles de la entidad o capa pasada.
bricscad.bim.current_model()
Devuelve los Objetos en el espacio de modelos del documento activo.
clase Bricscad.bim.Plies
Contenedor indexado y divisible de objetos Ply :
__iter__()
__getitem__(index)
__getitem__(slice)
__len__()
clase bricscad.bim.Ply
Objeto de capa individual.
get_property(prop_name)
Devuelve el valor de propiedad del objeto Ply con el nombre dado.