Nueva API REST entre Grasshopper y Connection

Este artículo también está disponible en:
Traducido por IA del inglés
El plugin de Grasshopper se ha actualizado a la nueva API de IDEA StatiCa Connection y a la versión IOM. Proporciona una nueva experiencia más alineada con las APIs modernas. Cada componente está estrechamente vinculado a la interacción con la API.

Con el lanzamiento de la nueva API REST de Connection, los componentes actuales de Grasshopper relacionados con la API antigua (ConHiddenCalculator) dejarán de funcionar, ya que esta API ya no es compatible a partir de 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.

Ventajas del nuevo plugin de Grasshopper

Con la nueva versión del plugin, los usuarios tienen acceso a las funciones mejoradas de la nueva API y a una interacción mucho más sencilla entre Grasshopper e IDEA StatiCa Connection.

Versión antigua del plugin 0.1.X

  • Difícil de entender qué ocurre en la API al usar los componentes
  • Muchas operaciones de E/S
  • Las operaciones largas (como el cálculo) hacen que el script se congele
  • Muchos componentes para todos los objetos
  • No funciona con múltiples uniones en un proyecto
  • Difícil elegir una versión específica de IDEA StatiCa

Nueva versión del plugin 0.2.0

  • Muy estrechamente vinculado a la cultura real de la API (transición más sencilla a Python o C#) 
  • Los proyectos permanecen 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 calculan
  • Descomposición automática de objetos de la API
  • Funciona de forma nativa con todas las uniones del proyecto
  • El conector/ejecutor de la API permite especificar fácilmente la versión
  • 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 definirse en los componentes IOM

Descripción general de los componentes

El nuevo plugin se divide en dos paneles en la cinta de Grasshopper. 

  1. App Common: Componentes de la API que son comunes a todas las APIs de diseño de IDEA StatiCa. 
  2. Connection: Componentes específicos de la API de unión. 
inline image in article

Conexión a la API a través de Grasshopper

De forma 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 de Grasshopper (Connection Service Runner). El usuario debe seleccionar uno de los componentes anteriores y ejecutarlo antes de que cualquiera de los componentes de la API pueda ejecutarse. 

Incorrecto:

Recibirá un mensaje de error en el componente si este ha intentado ejecutarse sin una conexión de API válida.

inline image in article

Correcto: 

Una vez que existe una conexión de API válida, el componente Service no necesita 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.

inline image in article

Componentes de la API

El botón "Active" que aparece 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 de forma continua utilizando un interruptor verdadero/falso conectado al componente activo.

inline image in article

Los componentes de la API están estrechamente relacionados con los Controladores de la API de Connection. Los controladores son de tipo acción (Cálculo, Exportación, Informe) o de tipo objeto (Efecto de carga, Elemento, Parámetros, etc.).

Basados en acciones: Los controladores basados en acciones realizan tareas u operaciones específicas sobre una unión o proyecto concreto, e incluyen funcionalidades de cálculo o exportación.

 Basados en objetos: Los controladores basados en objetos tendrán típicamente un componente Get y un componente Update:

  • Get: Recupera todos los objetos del tipo del controlador en la unión y obtiene objetos específicos que pueden descomponerse o modificarse. 
  • Update: Actualiza los objetos proporcionados que han sido modificados en el script de Grasshopper. Los objetos se actualizan utilizando 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 descomponerse o modificarse. Proporcionar componentes en este formato reduce el número total de componentes que los usuarios necesitan añadir.

El ejemplo más básico es descomponer un Proyecto para obtener la información disponible en él, como las uniones disponibles. 

inline image in article

Ejemplo sencillo – actualización de parámetros de unión

Vea el ejemplo sencillo de cómo funciona el componente Modify. La imagen a continuación muestra un ejemplo del uso de componentes de API y de objetos automáticos en una aplicación simple de una plantilla y la actualización de parámetros de unión. 

inline image in article

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

inline image in article

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.

Publicado en IDEA StatiCa versión 24.1.4

Prueba la última versión de IDEA StatiCa hoy mismo

Obtén 14 días de acceso completo, totalmente gratis.

Artículos relacionados

Notas de la versión IDEA StatiCa 25.0