La API de Revit y pyRevit: el código como herramienta de control técnico y QA en obra

La automatización orientada al aseguramiento de calidad (QA)

Automatizar no es solo ahorrar minutos en el reloj; es garantizar la coherencia absoluta de los datos del modelo.

Cuando se habla de automatización en entornos BIM, es muy común centrarse en la ganancia de tiempo: 'este script hace en dos segundos un trabajo de varias horas'. Aunque ese beneficio en los plazos es real y muy positivo, para nuestro flujo es un aspecto secundario. El verdadero valor de la automatización es la consistencia y fiabilidad de la información técnica que se genera.

En proyectos de cierta complejidad, tareas manuales como renombrar un conjunto de 150 planos bajo estándares específicos o rellenar uno a uno los parámetros de despiece de perfiles estructurales tienen una alta probabilidad de acumular pequeñas discrepancias tipográficas debido al carácter repetitivo de la tarea. La introducción manual de datos puede dar lugar a variaciones de nomenclatura, parámetros vacíos o erratas de fase.

Un script, en cambio, ejecuta las reglas de validación de manera idéntica y sistemática el 100% de las veces. Al estructurar digitalmente las tareas repetitivas, aseguramos que la documentación de despiece esté coordinada y lista para su traslado a fábrica, permitiendo que el equipo de diseño centre sus esfuerzos en la definición técnica del proyecto.

Python y pyRevit frente al entorno de Dynamo

Nodos visuales para experimentar frente a código estructurado para el uso diario del estudio.

Dentro del ecosistema de Revit, la automatización suele dividirse en dos caminos: la programación visual con Dynamo y el desarrollo de código nativo (generalmente Python) a través de la API de Revit con herramientas como pyRevit. En nuestro estudio no vemos esto como una competición, sino como herramientas complementarias según el problema.

Dynamo es una herramienta espectacular para explorar relaciones geométricas complejas, resolver paramétricamente superficies de doble curvatura o realizar comprobaciones rápidas de diseño. Su entorno de nodos y cables facilita la experimentación visual inmediata. Por otro lado, para flujos estables y fijos de uso diario del estudio, las dependencias de paquetes externos y la actualización entre versiones del software pueden requerir mantenimiento adicional.

Cuando el objetivo es dotar al estudio de herramientas de producción fijas y robustas, la API nativa y pyRevit son imbatibles. pyRevit nos permite compilar código Python sobre la marcha y desplegar interfaces de usuario personalizadas (botones, menús, barras de herramientas) integradas directamente en la interfaz de Revit. Es transparente para el usuario final: no hay que configurar nodos ni abrir reproductores externos. El técnico ejecuta el proceso de fondo con un solo clic, logrando una experiencia fluida y muy estable para la producción del estudio.

El código como auditor activo (Caso práctico)

Un parámetro vacío en el modelo detiene la fabricación. Auditar con código antes de exportar es nuestro control de calidad.

En proyectos industrializados como los de Steel Frame, cada barra metálica se corta a medida en una perfiladora CNC controlada por ordenador. La máquina recibe directamente un archivo de datos exportado desde nuestro modelo BIM. Si una sola de las 1.200 barras del modelo tiene el parámetro 'MGZ_Codigo_Montaje' vacío o erróneo, la máquina de taller detiene la producción o descarta la pieza, paralizando la cadena de montaje en obra durante días.

Revisar 1.200 elementos a mano en la interfaz de Revit es ineficiente y propicio al error humano. Para solucionarlo, programamos scripts en Python que auditan la base de datos del modelo en segundos. Si el script encuentra algún perfil sin código asignado, reporta su ID exacto y nos impide exportar el archivo de taller hasta que el error sea corregido.

El script que compartimos abajo es una muestra real de nuestro flujo de control: recorre los elementos de la categoría Structural Framing, extrae su código de montaje y alerta inmediatamente de cualquier omisión. Esto garantiza que la información que enviamos a fábrica esté validada al 100%.

Criterio MGZ: La automatización no es para ahorrar un par de clics por comodidad. Es el filtro tecnológico que asegura que cada pieza del modelo llegue a la obra con un dato fiable y construible.

La API de Revit: El paso de dibujante a gestor de bases de datos

Entender la base de datos de Autodesk es el paso definitivo para el control total del modelo.

Para programar sobre Revit, el primer paso mental y el más difícil es entender que el software no es una herramienta de dibujo tradicional; es una base de datos relacional envuelta en una interfaz tridimensional. Cada elemento —un muro, una puerta, un tornillo, una rejilla— es una fila en esa base de datos, y sus propiedades son columnas de parámetros.

Cuando el modelador entiende esto, el paradigma cambia por completo. Deja de dibujar líneas y empieza a consultar y manipular una base de datos. La API de Revit (Application Programming Interface) nos abre las puertas para realizar consultas complejas que serían imposibles a través de la interfaz estándar, permitiendo que la información fluya sin límites y que el modelo sea verdaderamente útil para todas las fases de la edificación.