Nuova API REST tra Grasshopper e Connection
Con il rilascio della nuova API REST per Connection, i componenti Grasshopper attuali 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
Come per 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. Aggiornare o installare semplicemente l'ultima versione disponibile del plugin IDEA StatiCa.
I vantaggi del nuovo plugin Grasshopper
Con la nuova versione del plugin, gli utenti hanno accesso alle funzionalità avanzate della nuova API e a un'interazione molto più semplice tra Grasshopper e IDEA StatiCa Connection.
Vecchia versione del plugin 0.1.X
- Difficile capire cosa accade nell'API durante l'utilizzo dei componenti
- Numerose operazioni di I/O
- Le operazioni lunghe (come il calcolo) causano il blocco dello script
- Molti componenti per tutti gli oggetti
- Non funziona con più collegamenti in un progetto
- Difficile scegliere una versione specifica di IDEA StatiCa
Nuova versione del plugin 0.2.0
- Strettamente integrato con la cultura effettiva dell'API (transizione più semplice a Python o C#)
- I progetti rimangono sul server fino al salvataggio da parte dell'utente
- I componenti API sono asincroni: gli utenti possono continuare a scrivere script mentre i componenti eseguono i calcoli
- Decomposizione automatica degli oggetti API
- Funziona nativamente con tutti i collegamenti nel progetto
- L'attacher/runner dell'API consente una facile specifica della versione
- Esportazione di file IFC direttamente in Grasshopper
- Il flusso di lavoro per l'applicazione dei modelli è unificato con l'applicazione
- I pin e gli 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 di IDEA StatiCa.
- Connection: componenti specifici per l'API di collegamento.
Connessione all'API tramite Grasshopper
Come per altri client API, è possibile collegare lo script Grasshopper a un'istanza API runner (Connection Service Attacher) o avviare il servizio all'interno di Grasshopper (Connection Service Runner). L'utente deve selezionare uno dei componenti sopra indicati ed eseguirlo prima che qualsiasi componente API possa essere avviato.
Errato:
Verrà visualizzato un messaggio di errore sul componente se quest'ultimo ha tentato di essere eseguito senza una connessione API valida.
Corretto:
Una volta stabilita una connessione API valida, il componente Service non dovrà essere rieseguito fino alla chiusura dello script o alla navigazione verso un'altra posizione. La connessione viene memorizzata localmente in modo che tutti i componenti possano accedervi.
Componenti API
Il pulsante "Active" sottostante identifica facilmente i componenti che interagiscono con l'API. Un componente può essere eseguito una volta cliccando il pulsante Run oppure eseguito in modo continuo utilizzando un interruttore vero/falso collegato al componente attivo.
I componenti API sono strettamente correlati ai Controller nell'API Connection. I Controller sono basati su azioni (Calcolo, Esportazione, Report) o su oggetti (Effetto del carico, Elemento, Parametri, ecc.).
Basati su azioni: I controller basati su azioni eseguono compiti o operazioni specifiche su un collegamento o progetto specifico, tra cui 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 del tipo controller nel collegamento e recupera oggetti specifici che possono essere decostruiti o modificati.
- Update: Aggiorna gli oggetti forniti che sono stati modificati nello script Grasshopper. Gli oggetti vengono aggiornati utilizzando il componente automatico Modify Object.
La maggior parte dei componenti API accetta input e fornisce output di oggetti, che possono essere decostruiti o modificati. Fornire i componenti in questo formato riduce il numero complessivo di componenti che gli utenti devono aggiungere.
L'esempio più semplice è la decostruzione di un Progetto per ottenere le informazioni disponibili al suo interno, come i collegamenti disponibili.
Esempio semplice – aggiornamento dei parametri di collegamento
Vedere il semplice esempio di come funziona il componente Modify. L'immagine seguente mostra un esempio di utilizzo dei componenti API e Automatic Object in una semplice applicazione di un modello e nell'aggiornamento dei parametri di collegamento.
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
Compatibilità delle versioni
Il nuovo plugin, versione 0.2.0, è disponibile nel Rhino Package Manager e funzionerà con IDEA StatiCa versione 24.1.3 e successive.
La versione precedente 0.1.x sarà anch'essa disponibile e funzionerà con IDEA StatiCa versione 24.1.2 e precedenti.
Rilasciato nella versione 24.1.4 di IDEA StatiCa