Bază de cunoștințe

Nou API REST între Grasshopper și Connection

Steel

v25.0

Connection

Grasshopper

Parametric design

Acest articol este disponibil și în:

Tradus de AI din engleză

Plugin-ul Grasshopper a fost actualizat la noul API IDEA StatiCa Connection și versiunea IOM. Acesta oferă o experiență nouă, mai aliniată cu API-urile moderne. Fiecare componentă este strâns cuplată cu interacțiunea API.

Odată cu lansarea noului API REST Connection, componentele Grasshopper actuale legate de vechiul API (ConHiddenCalculator) nu vor mai funcționa, deoarece acest API nu mai este suportat începând cu versiunea IDEA StatiCa 24.1.3.

Instalarea plugin-ului

La fel ca în versiunile anterioare, plugin-ul poate fi instalat prin intermediul Rhino Package Manager. Deschideți Package Manager tastând PackageManager în linia de comandă Rhino. Pur și simplu actualizați sau instalați cea mai recentă versiune disponibilă a plugin-ului IDEA StatiCa.

Avantajele noului plugin Grasshopper

Cu noua versiune a plugin-ului, utilizatorii au acces la funcționalități îmbunătățite ale noului API și la o interacțiune mult mai ușoară între Grasshopper și IDEA StatiCa Connection.

Versiunea veche a plugin-ului 0.1.X

Dificil de înțeles ce se întâmplă în API la utilizarea componentelor
Multe operații de intrare/ieșire
Operațiile de lungă durată (cum ar fi calculul) cauzează înghețarea scriptului
Multe componente pentru toate obiectele
Nu funcționează cu mai multe îmbinări într-un proiect
Dificil de ales o versiune specifică a IDEA StatiCa

Noua versiune a plugin-ului 0.2.0

Strâns cuplată cu cultura reală a API-ului (tranziție mai ușoară la Python sau C#)
Proiectele rămân pe server până când sunt salvate de utilizator
Componentele API sunt asincrone, utilizatorii pot continua scripting-ul în timp ce componentele calculează
Descompunere automată a obiectelor API
Funcționează nativ cu toate îmbinările din proiect
Atașatorul/rulorul API permite specificarea ușoară a versiunii
Export fișiere IFC direct în Grasshopper
Fluxul de lucru pentru aplicarea șablonului este unificat cu aplicația
Pinii și ancorele pot fi definite în componentele IOM

Prezentare generală a componentelor

Noul plugin este împărțit în două panouri în bara de instrumente Grasshopper.

App Common: Componente API comune tuturor API-urilor de proiectare IDEA StatiCa.
Connection: Componente specifice API-ului de îmbinare.

Conectarea la API prin Grasshopper

Similar altor clienți API, puteți conecta scriptul Grasshopper la o instanță API runner (Connection Service Attacher) sau puteți porni serviciul în cadrul Grasshopper (Connection Service Runner). Un utilizator trebuie să selecteze una dintre componentele de mai sus și să o ruleze înainte ca oricare dintre componentele API să poată rula.

Incorect:

Veți primi un mesaj de eroare pe componentă dacă aceasta a încercat să ruleze fără o conexiune API validă.

Corect:

Odată ce există o conexiune API validă, componenta Service nu ar trebui să fie rulată din nou până când scriptul este închis sau navigat în altă parte. Conexiunea este stocată local astfel încât toate componentele să o poată accesa.

Componente API

Butonul „Active" de mai jos identifică cu ușurință componentele care interacționează cu API-ul. O componentă poate fi rulată o singură dată făcând clic pe butonul Run sau executată continuu folosind un comutator adevărat/fals conectat la componenta activă.

Componentele API sunt strâns legate de Controllere din API-ul Connection. Controllerele sunt fie bazate pe acțiuni (Calcul, Export, Raport), fie bazate pe obiecte (Efect de încărcare, Element, Parametri etc.).

Bazate pe acțiuni: Controllerele bazate pe acțiuni efectuează sarcini sau operații specifice pe o îmbinare sau un proiect specific, acestea incluzând funcționalități de calcul sau export

Bazate pe obiecte: Controllerele bazate pe obiecte vor avea de obicei o componentă Get și o componentă Update:

Get: Recuperează toate obiectele de tipul controllerului din Connection și recuperează obiecte specifice care pot fi descompuse sau modificate.
Update: Actualizează obiectele furnizate care au fost modificate în scriptul Grasshopper. Obiectele sunt actualizate folosind componenta automată Modify Object.

Majoritatea componentelor API vor prelua intrări și vor furniza ieșiri de obiecte, care pot fi descompuse sau modificate. Furnizarea componentelor în acest format reduce numărul total de componente pe care utilizatorii trebuie să le adauge.

Cel mai simplu exemplu este descompunerea unui Proiect pentru a obține informațiile disponibile în acesta, cum ar fi îmbinările disponibile.

Exemplu simplu – actualizarea parametrilor îmbinării

Consultați exemplul simplu despre cum funcționează componenta Modify. Imaginea de mai jos prezintă un exemplu de utilizare a componentelor API și Automatic Object într-o aplicație simplă a unui șablon și actualizarea parametrilor îmbinării.

Exemple gata de utilizare

O listă completă de exemple este disponibilă utilizatorilor care descarcă plugin-ul în fișierul zip: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip