Conoscenza di base

Nuova REST API tra Grasshopper e Connection

Steel

v25.0

Connection

Grasshopper

Parametric design

Questo articolo è disponibile in:

Translated by AI from English

Il plugin Grasshopper è aggiornato alla nuova API di IDEA StatiCa Connection e alla versione IOM. Fornisce una nuova esperienza più in linea con le API moderne. Ogni componente è strettamente accoppiato all'interazione con l'API.

Con il rilascio della nuova Rest Connection API, gli attuali componenti Grasshopper relativi alla vecchia API (ConHiddenCalculator) non funzioneranno più poiché questa API non è più supportata dalla versione 24.1.3 di IDEA StatiCa.

Installazione del plugin

Proprio come con le versioni precedenti, il plugin può essere installato tramite il Rhino Package Manager. Aprire il Package Manager digitando PackageManager nel prompt dei comandi di Rhino. Semplicemente aggiornare o installare l'ultima versione disponibile del plugin IDEA StatiCa.

I vantaggi del nuovo plugin Grasshopper

Con la nuova versione del plugin, gli utenti hanno accesso a funzionalità avanzate della nuova API e un'interazione molto più semplice tra Grasshopper e IDEA StatiCa Connection.

Vecchia versione del plugin 0.1.X

Difficile capire cosa sta accadendo nell'API quando si utilizzano i componenti
Molte operazioni IO
Operazioni lunghe (come il calcolo) causano il blocco dello script
Molti componenti per tutti gli oggetti
Non funziona con connessioni multiple in un progetto
Difficile scegliere una versione specifica di IDEA StatiCa

Nuova versione del plugin 0.2.0

Molto strettamente accoppiato alla cultura effettiva dell'API (transizione più facile a Python o C#)
I progetti sono sul server fino a quando non vengono salvati dall'utente
I componenti API sono asincroni, gli utenti possono continuare a scrivere script mentre i componenti stanno calcolando
Decomposizione automatica degli oggetti API
Funziona nativamente con tutte le connessioni nel progetto
L'attacher/runner API consente una facile specifica della versione
Esportare file IFC direttamente in Grasshopper
Il flusso di lavoro dell'applicazione template è unificato con l'applicazione
Pin e ancoraggi sono disponibili per essere definiti nei componenti IOM

Panoramica dei componenti

Il nuovo plugin è suddiviso in due pannelli nella barra multifunzione di Grasshopper.

App Common: Componenti API comuni a tutte le API di progettazione IDEA StatiCa.
Connection: Componenti specifici per l'API di connessione.

Connessione all'API tramite Grasshopper

Analogamente ad altri client API, è possibile connettere lo script Grasshopper a un'istanza APIrunner (Connection Service Attacher) o avviare il servizio all'interno di Grasshopper (Connection Service Runner). Un utente deve selezionare uno dei componenti sopra indicati ed eseguirlo prima che qualsiasi componente API possa essere eseguito.

Errato:

Verrà fornito un messaggio di errore sul componente se il componente ha tentato di essere eseguito senza una connessione API valida.

Corretto:

Una volta che c'è una connessione API valida, il componente Service non dovrebbe aver bisogno di essere rieseguito fino a quando lo script non viene chiuso o ci si allontana da esso. La connessione è memorizzata localmente in modo che tutti i componenti possano accedervi.

Componenti API

Il pulsante "Active" qui sotto identifica facilmente i componenti che interagiscono con l'API. Un componente può essere eseguito una volta facendo clic sul pulsante Run o eseguito continuamente utilizzando un interruttore vero/falso collegato al componente attivo.

I componenti API sono strettamente correlati ai Controller nell'API di Connection. I Controller sono basati su azioni (Calcolo, Esportazione, Report) o basati su oggetti (Effetto di carico, Membro, Parametri, ecc.).

Basati su azioni: I controller basati su azioni eseguono compiti o operazioni specifiche su una connessione o progetto specifico, questi includono funzionalità di calcolo o esportazione

Basati su oggetti: I controller basati su oggetti avranno tipicamente un componente Get e un componente Update:

Get: Recupera tutti gli oggetti di tipo controller nella Connection e recupera oggetti specifici che possono essere decostruiti o modificati.
Update: Aggiorna gli oggetti forniti che sono stati aggiornati nello script Grasshopper. Gli oggetti vengono aggiornati utilizzando il componente automatico Modify Object.

La maggior parte dei componenti API accetterà input e fornirà output di oggetti, che possono essere decostruiti o modificati.Fornire componenti in questo formato riduce il numero complessivo di componenti che gli utenti devono aggiungere.

L'esempio più basilare è decostruire un Progetto per ottenere le informazioni disponibili al suo interno, come le connessioni disponibili.

Esempio semplice – aggiornamento dei parametri di connessione

Vedere l'esempio semplice di come funziona il componente Modify. L'immagine qui sotto mostra un esempio di utilizzo di componenti API e Automatic Object in una semplice applicazione di un template e aggiornamento dei parametri di connessione.

Esempi pronti all'uso

Un elenco completo di esempi è disponibile per gli utenti che scaricano il plugin nel file compresso: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip