Nueva API REST entre Grasshopper y Connection
Con el lanzamiento de la nueva API Rest de Connection, los componentes actuales de Grasshopper relacionados con la API antigua (ConHiddenCalculator) ya no funcionarán ya que esta API ya no es compatible desde la versión 24.1.3 de IDEA StatiCa.
Instalación del plugin
Al igual que con las versiones anteriores, el plugin puede instalarse a través del Rhino Package Manager. Abra el Package Manager escribiendo PackageManager en el símbolo del sistema de Rhino. Simplemente actualice o instale la última versión disponible del plugin de IDEA StatiCa.
Las ventajas del nuevo plugin de Grasshopper
Con la nueva versión del plugin, los usuarios tienen acceso a características mejoradas de la nueva API y una interacción mucho más fácil entre Grasshopper e IDEA StatiCa Connection.
Versión antigua del plugin 0.1.X
- Difícil de entender qué está sucediendo en la API al usar componentes
- Muchas operaciones de IO
- Las operaciones largas (como el cálculo) hacen que el script se congele
- Muchos componentes para todos los objetos
- No funciona con múltiples conexiones en un proyecto
- Difícil elegir una versión específica de IDEA StatiCa
Nueva versión del plugin 0.2.0
- Muy estrechamente acoplado a la cultura real de la API (transición más fácil a Python o C#)
- Los proyectos están en el servidor hasta que el usuario los guarda
- Los componentes de la API son asíncronos, los usuarios pueden continuar programando mientras los componentes están calculando
- Descomposición automática de objetos de la API
- Funciona nativamente con todas las conexiones en el proyecto
- El adjuntador/ejecutor de API permite una especificación de versión fácil
- Exportar archivos IFC directamente en Grasshopper
- El flujo de trabajo de aplicación de plantillas está unificado con la aplicación
- Los pines y anclajes están disponibles para ser definidos en los componentes IOM
Descripción general de los componentes
El nuevo plugin se divide en dos paneles en la cinta de Grasshopper.
- App Common: Componentes de API que son comunes en todas las APIs de diseño de IDEA StatiCa.
- Connection: Componentes que son específicos de la API de conexión.
Conexión a la API a través de Grasshopper
Similar a otros clientes de API, puede conectar el script de Grasshopper a una instancia de API ejecutora (Connection Service Attacher) o iniciar el servicio dentro deGrasshopper (Connection Service Runner). Un usuario debe seleccionar uno de los componentes anteriores y ejecutarlo antes de que cualquiera de los componentes de la API pueda ejecutarse.
Incorrecto:
Se le proporcionará un mensaje de error en el componente si el componente ha intentado ejecutarse sin una conexión de API válida.
Correcto:
Una vez que hay una conexión de API válida, el componente de Servicio no debería necesitar volver a ejecutarse hasta que el script se cierre o se navegue fuera de él. La conexión se almacena localmente para que todos los componentes puedan acceder a ella.
Componentes de la API
El botón "Active" a continuación identifica fácilmente los componentes que interactúan con la API. Un componente puede ejecutarse una vez haciendo clic en el botón Run o ejecutarse continuamente usando un interruptor verdadero/falso conectado al componente activo.
Los componentes de la API están estrechamente relacionados con los Controladores en la API de Connection. Los Controladores están basados en acciones (Cálculo, Exportación, Informe) o basados en objetos (Efecto de carga, Miembro, Parámetros, etc.).
Basados en acciones: Los controladores basados en acciones realizan tareas u operaciones específicas en una conexión o proyecto específico, estos incluyen funcionalidad de cálculo o exportación
Basados en objetos: Los controladores basados en objetos normalmente tendrán un componente Get y un componente Update:
- Get: Recupera todos los objetos de tipo controlador en la Connection y recupera objetos específicos que pueden ser deconstruidos o modificados.
- Update: Actualiza los objetos proporcionados que han sido actualizados en el script de Grasshopper. Los objetos se actualizan usando el componente automático Modify Object.
La mayoría de los componentes de la API tomarán entradas y proporcionarán salidas de objetos, que pueden ser deconstruidos o modificados.Proporcionar componentes en este formato reduce el número total de componentes que los usuarios necesitan agregar.
El ejemplo más básico es deconstruir un Proyecto para obtener la información disponible dentro de él, como las conexiones disponibles.
Ejemplo simple – actualización de parámetros de conexión
Vea el ejemplo simple de cómo funciona el componente Modify. La imagen a continuación muestra un ejemplo del uso de componentes de API y Automatic Object en una aplicación simple de una plantilla y actualización de parámetros de conexión.
Ejemplos listos para usar
Una lista completa de ejemplos está disponible para los usuarios que descarguen el plugin en el archivo comprimido: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip
Compatibilidad de versiones
El nuevo plugin, versión 0.2.0, está disponible en el Rhino Package Manager y funcionará con IDEA StatiCa versión 24.1.3 y posteriores.
La versión anterior 0.1.x también estará disponible y funcionará con IDEA StatiCa versión 24.1.2 y anteriores.
Lanzado en IDEA StatiCa versión 24.1.4