Extensibilidad

DesignBuilder puede ampliarse mediante distintos tipos de scripts o complementos. Cada sistema se dirige a un caso de uso y nivel de complejidad diferentes. Ambos pueden utilizarse al mismo tiempo y se admiten varios complementos y scripts activos.

• Los scripts se conectan a determinadas etapas de una simulación de DesignBuilder para modificar el proceso o generar informes.
• Los complementos son un superconjunto de los scripts y ofrecen funciones adicionales, como crear un submenú personalizado en el menú principal de DesignBuilder, que permite procesar datos de DesignBuilder de forma puntual.

Los scripts pueden escribirse en C# o Python. Los complementos se escriben en C#.

En general, los scripts se utilizan cuando se necesita una solución rápida y se acepta que el programa controle las llamadas en puntos de conexión clave. Los complementos son más apropiados para proyectos de personalización mayores en los que el código se precompila y puede ejecutarse bajo control del usuario.

Nota: La Guía de usuario de herramientas de extensibilidad y API explica cómo usuarios y desarrolladores pueden personalizar y ampliar DesignBuilder mediante scripts y complementos. Describe la API de DesignBuilder para acceder a modelos, procesos de simulación y tablas de datos y modificarlos. Explica cómo escribir y activar scripts en C# o Python, implementar puntos de conexión en simulaciones y desarrollar complementos avanzados que añaden menús dinámicos e integran bibliotecas externas. También trata atributos del modelo, tablas de base de datos y extracción de geometría, ofreciendo un marco para crear flujos personalizados y automatizar tareas en DesignBuilder.

Nota: La Guía de referencia de la API de DesignBuilder es la fuente principal de ayuda sobre las clases, colecciones, enumeraciones y demás elementos de la API.

Scripts

DesignBuilder proporciona 3 conjuntos de herramientas de scripts para que los usuarios más expertos personalicen simulaciones y generen informes especiales.

• Energy Management System (EMS) - conjunto potente de herramientas de scripts de ejecución de EnergyPlus para escribir código portable que personalice el comportamiento de EnergyPlus de simulación.
• CS-Script - permite ejecutar código C# estándar, normalmente antes y después de las simulaciones, para modificar el IDF predeterminado generado por DesignBuilder y acceder a los datos de entrada y salida del modelo de DesignBuilder para crear informes personalizados.
• Python - conjunto de herramientas para ejecutar código Python en puntos de conexión clave, normalmente antes y después de simulaciones como CS-Script, para modificar el IDF predeterminado generado por DesignBuilder mediante la herramienta eppy , o para procesar resultados y crear informes personalizados.

Se puede acceder a las herramientas de scripts mediante el icono Scripts de la barra de herramientas y la opción de menú Herramientas > Scripts , que abre el cuadro Gestor de scripts . Los temas de ayuda de cada tipo de script ofrecen más detalles.

Nota: Los 3 tipos de script también pueden utilizarse para desarrollar EMS personalizado, IDF personalizado y Script personalizado como variables de diseño.

Complementos

Los complementos pueden realizar todas las funciones de CS-Script y además permiten añadir submenús personalizados al menú principal de DesignBuilder Complementos para procesar modelos y resultados de DesignBuilder. Suelen ser más adecuados para proyectos mayores cuyo código fuente puede compilarse en una DLL. Por ejemplo, un módulo de comprobación normativa que requiera procesar en profundidad el modelo y los resultados de DesignBuilder se implementaría normalmente como complemento.

Puedes acceder a complementos de DesignBuilder desde:

• página de descarga de scripts y complementos - ejemplos desarrollados por DesignBuilder

• repositorio Github - varios ejemplos con código fuente para ayudar a los desarrolladores a crear sus propios complementos