Nova API REST entre Grasshopper e Connection
Com o lançamento da nova API REST de Connection, os componentes Grasshopper atuais 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. Basta atualizar ou instalar a versão mais recente disponível do plugin IDEA StatiCa.
Vantagens do novo plugin Grasshopper
Com a nova versão do plugin, os utilizadores têm acesso a funcionalidades melhoradas da nova API e a uma interação muito mais simples entre o Grasshopper e o IDEA StatiCa Connection.
Versão antiga do plugin 0.1.X
- Difícil de compreender o que acontece na API ao utilizar os componentes
- Muitas operações de E/S
- Operações longas (como o cálculo) causam o bloqueio do script
- 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
- 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 criar scripts enquanto os componentes calculam
- Decomposição automática de objetos da API
- Funciona nativamente com todas as ligações no projeto
- O attacher/runner da API permite uma especificação fácil da versão
- Exportação de 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 no friso do Grasshopper.
- App Common: Componentes da API comuns a todas as APIs de cálculo do IDEA StatiCa.
- Connection: Componentes específicos da API de ligação.
Ligação à API através do Grasshopper
À semelhança de outros clientes de API, pode ligar o script Grasshopper a uma instância de API runner (Connection Service Attacher) ou iniciar o serviço dentro do Grasshopper (Connection Service Runner). O utilizador deve selecionar um dos componentes acima e executá-lo antes de qualquer um dos componentes da API poder ser executado.
Incorreto:
Será apresentada uma mensagem de erro no componente caso este tenha tentado ser executado sem uma ligação de API válida.
Correto:
Uma vez estabelecida uma ligação de API válida, o componente Service não necessita 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 utilizando um interruptor verdadeiro/falso ligado ao componente ativo.
Os componentes da API estão estreitamente relacionados com os Controllers na API de Connection. Os Controllers são baseados em ações (Cálculo, Exportação, Relatório) ou baseados em objetos (Efeito da ação, Elemento, Parâmetros, etc.).
Baseados em ações: Os controllers baseados em ações executam tarefas ou operações específicas numa ligação ou projeto específico, incluindo funcionalidades de cálculo ou exportação.
Baseados em objetos: Os controllers baseados em objetos terão tipicamente um componente Get e um componente Update:
- Get: Obtém 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 modificados no script Grasshopper. Os objetos são atualizados utilizando 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 é a desconstrução de um Projeto para obter as informações disponíveis no mesmo, como as ligações disponíveis.
Exemplo simples – atualização de parâmetros de ligação
Veja o exemplo simples de como o componente Modify funciona. 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 utilizar
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
Compatibilidade de versões
O novo plugin, versão 0.2.0, está disponível no Rhino Package Manager e funcionará com o IDEA StatiCa versão 24.1.3 e posteriores.
A versão anterior 0.1.x também estará disponível e funcionará com o IDEA StatiCa versão 24.1.2 e anteriores.
Lançado na versão 24.1.4 do IDEA StatiCa