Tudásbázis

Új REST API a Grasshopper és a Connection között

Steel

v25.0

Connection

Grasshopper

Parametric design

Ez a cikk a következő nyelveken is elérhető

Translated by AI from English

A Grasshopper beépülő modul frissítve lett az új IDEA StatiCa Connection API-ra és IOM verzióra. Egy új élményt nyújt, amely jobban illeszkedik a modern API-khoz. Minden komponens szorosan kapcsolódik az API interakcióhoz.

Az új Rest Connection API kiadásával a régi API-hoz kapcsolódó jelenlegi Grasshopper komponensek (ConHiddenCalculator) többé nem fognak működni, mivel ez az API már nem támogatott az IDEA StatiCa 24.1.3 verziójától kezdve.

A beépülő modul telepítése

Akárcsak a régebbi verziók esetében, a beépülő modul telepíthető a Rhino Package Manager segítségével. Nyissa meg a Package Managert a PackageManager beírásával a Rhino parancssorba. Egyszerűen frissítse vagy telepítse az IDEA StatiCa beépülő modul legújabb elérhető verzióját.

Az új Grasshopper beépülő modul előnyei

A beépülő modul új verziójával a felhasználók hozzáférnek az új API továbbfejlesztett funkcióihoz és sokkal könnyebb interakcióhoz a Grasshopper és az IDEA StatiCa Connection között.

Régi beépülő modul verzió 0.1.X

Nehéz megérteni, hogy mi történik az API-ban a komponensek használatakor
Sok IO művelet
A hosszú műveletek (mint a számítás) a szkript lefagyását okozzák
Sok komponens az összes objektumhoz
Nem működik több csatlakozással egy projektben
Nehéz kiválasztani az IDEA StatiCa egy adott verzióját

Új beépülő modul verzió 0.2.0

Nagyon szorosan kapcsolódik a tényleges API kultúrához (könnyebb átmenet Pythonra vagy C#-ra)
A projektek a szerveren vannak, amíg a felhasználó el nem menti őket
Az API komponensek aszinkronok, a felhasználók folytathatják a szkriptelést, miközben a komponensek számítanak
Az API objektumok automatikus lebontása
Natívan működik a projekt összes csatlakozásával
Az API csatoló/futtató lehetővé teszi a könnyű verzió meghatározást
IFC fájlok exportálása közvetlenül a Grasshopperben
A sablon alkalmazási munkafolyamat egységes az alkalmazással
A csapok és horgonyok definiálhatók az IOM komponensekben

Komponensek áttekintése

Az új beépülő modul két panelre van bontva a Grasshopper szalagon.

App Common: API komponensek, amelyek közösek az összes IDEA StatiCa tervezési API-ban.
Connection: Komponensek, amelyek specifikusak a connection API-hoz.

Csatlakozás az API-hoz a Grasshopperen keresztül

Hasonlóan más API kliensekhez, csatlakoztathatja a Grasshopper szkriptet egy futtató API példányhoz (Connection Service Attacher), vagy elindíthatja a szolgáltatást a Grasshopperen belül (Connection Service Runner). A felhasználónak ki kell választania a fenti komponensek egyikét és futtatnia kell, mielőtt bármelyik API komponens futhat.

Helytelen:

Hibaüzenetet kap a komponensen, ha a komponens érvényes API kapcsolat nélkül próbált futni.

Helyes:

Amint van érvényes API kapcsolat, a Service komponenst nem kell újra futtatni, amíg a szkript be nem zárul vagy el nem navigál tőle. A kapcsolat helyileg van tárolva, így minden komponens hozzáférhet.

API komponensek

Az alábbi "Active" gomb könnyen azonosítja az API-val interakcióba lépő komponenseket. Egy komponens egyszer futtatható a Run gombra kattintva, vagy folyamatosan végrehajtható egy igaz/hamis kapcsoló használatával, amely az aktív komponenshez van kötve.

Az API komponensek szorosan kapcsolódnak a Connection API Controllerjeihez. A Controllerek vagy művelet-alapúak (Calculation, Export, Report) vagy objektum-alapúak (Load effect, Member, Parameters, stb.).

Művelet-alapú: A művelet-alapú controllerek specifikus feladatokat vagy műveleteket végeznek egy adott csatlakozáson vagy projekten, ezek közé tartozik a számítási vagy exportálási funkcionalitás

Objektum-alapú: Az objektum-alapú controllerek jellemzően rendelkeznek egy Get komponenssel és egy Update komponenssel:

Get: Lekéri az összes controller-típusú objektumot a Connectionben és lekéri azokat a specifikus objektumokat, amelyek lebonthatók vagy módosíthatók.
Update: Frissíti a megadott objektumokat, amelyek frissítve lettek a Grasshopper szkriptben. Az objektumok az automatikus Modify Object komponens használatával frissülnek.

A legtöbb API komponens objektumok bemeneteit veszi át és kimeneteit adja, amelyek lebonthatók vagy módosíthatók.A komponensek ilyen formátumban való biztosítása csökkenti a felhasználók által hozzáadandó komponensek teljes számát.

A legalapvetőbb példa egy Project lebontása, hogy megkapjuk a benne elérhető információkat, mint például az elérhető csatlakozásokat.

Egyszerű példa – csatlakozási paraméterek frissítése

Tekintse meg az egyszerű példát arra, hogyan működik a Modify komponens. Az alábbi kép egy példát mutat az API és az Automatic Object komponensek használatára egy sablon egyszerű alkalmazásában és a csatlakozási paraméterek frissítésében.

Használatra kész példák

A példák teljes listája elérhető a beépülő modult letöltő felhasználók számára a tömörített fájlban: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip