Bază de date

API REST nou între Grasshopper și Connection

Steel

v25.0

Connection

Grasshopper

Parametric design

Acest articol este disponibil și în:

Translated by AI from English

Plugin-ul Grasshopper este actualizat la noul API IDEA StatiCa Connection și versiunea IOM. Acesta oferă o experiență nouă care este mai în concordanță cu API-urile moderne. Fiecare componentă este strâns cuplată la 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 Rhino Package Manager. Deschideți Package Manager tastând PackageManager în promptul 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 o interacțiune mult mai ușoară între Grasshopper și IDEA StatiCa Connection.

Versiunea veche a plugin-ului 0.1.X

Greu de înțeles ce se întâmplă în API atunci când se utilizează componentele
Multe operații IO
Operațiile lungi (cum ar fi calculul) determină blocarea scriptului
Multe componente pentru toate obiectele
Nu funcționează cu conexiuni multiple într-un proiect
Greu de ales o versiune specifică de IDEA StatiCa

Noua versiune a plugin-ului 0.2.0

Foarte strâns cuplat la cultura actuală a API (tranziție mai ușoară către Python sau C#)
Proiectele sunt 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 conexiunile din proiect
API attacher/runner permite o specificare ușoară a versiunii
Exportă fișiere IFC direct în Grasshopper
Fluxul de lucru al aplicării șablonului este unificat cu aplicația
Pinii și ancorele sunt disponibile pentru a fi definite în componentele IOM

Prezentare generală a componentelor

Noul plugin este împărțit în două panouri în panglica Grasshopper.

App Common: Componente API care sunt comune tuturor API-urilor de proiectare IDEA StatiCa.
Connection: Componente care sunt specifice API-ului de conexiune.

Conectarea la API prin Grasshopper

Similar altor cliențiAPI, 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.

Greșit:

Veți primi un mesaj de eroare pe componentă dacă componenta 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 necesară re-rularea până când scriptul este închis sau se navighează departe de el. 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 Controllers în API-ul Connection. Controllers sunt fie bazate pe acțiuni (Calcul, Export, Raport) fie bazate pe obiecte (Efect de încărcare, Membru, Parametri etc.).

Bazate pe acțiuni: Controllers bazate pe acțiuni efectuează sarcini sau operații specifice pe o conexiune sau proiect specific, acestea includ funcționalitatea de calcul sau export

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

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

Majoritatea componentelor API vor primi 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 cadrul acestuia, cum ar fi conexiunile disponibile.

Exemplu simplu – actualizarea parametrilor de conexiune

Vedeți exemplul simplu al modului în care funcționează componenta Modify. Imaginea de mai jos prezintă un exemplu de utilizare a componentelor API și Automatic Object într-o aplicare simplă a unui șablon și actualizarea parametrilor de conexiune.

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