Knowledge base

Nova REST API entre Grasshopper e Connection

Steel

v25.0

Connection

Grasshopper

Parametric design

This article is also available in:

Translated by AI from English

O plugin Grasshopper foi atualizado para a nova API IDEA StatiCa Connection e versão IOM. Proporciona uma nova experiência mais alinhada com as APIs modernas. Cada componente está fortemente acoplado à interação da API.

Com o lançamento da nova Rest Connection API, os componentes atuais do Grasshopper relacionados com a API Antiga (ConHiddenCalculator) deixarão de funcionar, uma vez que esta API já não é suportada a partir da versão 24.1.3 do IDEA StatiCa.

Instalação do plugin

Tal como nas versões anteriores, o plugin pode ser instalado através do Rhino Package Manager. Abra o Package Manager digitando PackageManager na linha de comandos do Rhino. Simplesmente atualize ou instale a versão mais recente disponível do plugin IDEA StatiCa.

As vantagens do novo plugin Grasshopper

Com a nova versão do plugin, os utilizadores têm acesso a funcionalidades melhoradas da nova API e uma interação muito mais fácil entre o Grasshopper e o IDEA StatiCa Connection.

Versão antiga do plugin 0.1.X

Difícil de compreender o que está a acontecer na API ao usar componentes
Muitas operações IO
Operações longas (como cálculo) fazem com que o script congele
Muitos componentes para todos os objetos
Não funciona com múltiplas ligações num projeto
Difícil escolher uma versão específica do IDEA StatiCa

Nova versão do plugin 0.2.0

Muito fortemente acoplado à cultura real da API (transição mais fácil para Python ou C#)
Os projetos ficam no servidor até serem guardados pelo utilizador
Os componentes da API são assíncronos, os utilizadores podem continuar a programar enquanto os componentes estão a calcular
Decomposição automática de objetos da API
Funciona nativamente com todas as ligações no projeto
O anexador/executor da API permite uma especificação de versão fácil
Exportar ficheiros IFC diretamente no Grasshopper
O fluxo de trabalho de aplicação de modelos está unificado com a aplicação
Pinos e âncoras estão disponíveis para serem definidos nos Componentes IOM

Visão geral dos componentes

O novo plugin está dividido em dois painéis na faixa do Grasshopper.

App Common: Componentes da API que são comuns a todas as APIs de design do IDEA StatiCa.
Connection: Componentes que são específicos da API de ligação.

Ligar à API através do Grasshopper

Semelhante a outros clientes da API, pode ligar o script do Grasshopper a uma instância da API runner (Connection Service Attacher) ou iniciar o serviço dentro do Grasshopper (Connection Service Runner). Um utilizador deve selecionar um dos componentes acima e executá-lo antes que qualquer um dos componentes da API possa ser executado.

Errado:

Será fornecida uma mensagem de erro no componente se o componente tiver tentado executar sem uma ligação API válida.

Correto:

Uma vez que exista uma ligação API válida, o componente Service não deverá precisar de ser executado novamente até que o script seja fechado ou se navegue para fora dele. A ligação é armazenada localmente para que todos os componentes possam aceder a ela.

Componentes da API

O botão "Active" abaixo identifica facilmente os componentes que interagem com a API. Um componente pode ser executado uma vez clicando no botão Run ou executado continuamente usando um interruptor verdadeiro/falso ligado ao componente ativo.

Os componentes da API estão intimamente relacionados com os Controllers na Connection API. Os Controllers são baseados em ação (Cálculo, Exportação, Relatório) ou baseados em objeto (Efeito de carga, Membro, Parâmetros, etc.).

Baseados em ação: Os controllers baseados em ação executam tarefas ou operações específicas numa ligação ou projeto específico, incluindo funcionalidades de cálculo ou exportação

Baseados em objeto: Os controllers baseados em objeto terão tipicamente um componente Get e um componente Update:

Get: Recupera todos os objetos do tipo controller na Connection e recupera objetos específicos que podem ser desconstruídos ou modificados.
Update: Atualiza os objetos fornecidos que foram atualizados no script do Grasshopper. Os objetos são atualizados usando o componente automático Modify Object.

A maioria dos componentes da API receberá entradas e fornecerá saídas de objetos, que podem ser desconstruídos ou modificados.Fornecer componentes neste formato reduz o número total de componentes que os utilizadores precisam de adicionar.

O exemplo mais básico é desconstruir um Projeto para obter a informação disponível dentro dele, como as ligações disponíveis.

Exemplo simples – atualizar parâmetros de ligação

Veja o exemplo simples de como funciona o componente Modify. A imagem abaixo mostra um exemplo de utilização de componentes API e Automatic Object numa aplicação simples de um modelo e atualização de parâmetros de ligação.

Exemplos prontos a usar

Uma lista completa de exemplos está disponível para os utilizadores que descarregam o plugin no ficheiro comprimido: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip