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

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

A bővítmény telepítése

A korábbi verziókhoz hasonlóan a bővítmény telepíthető a Rhino Package Manager segítségével. Nyissa meg a Package Managert a PackageManager parancs beírásával a Rhino parancssorba. Egyszerűen frissítse vagy telepítse az IDEA StatiCa bővítmény legújabb elérhető verzióját.

Az új Grasshopper bővítmény előnyei

A bővítmény új verziójával a felhasználók hozzáférhetnek az új API továbbfejlesztett funkcióihoz, és sokkal egyszerűbb az interakció a Grasshopper és az IDEA StatiCa Connection között.

Régi bővítmény 0.1.X verzió

• Nehéz megérteni, mi történik az API-ban a komponensek használatakor
• Sok I/O művelet
• A hosszú műveletek (például a számítás) lefagyasztják a szkriptet
• Sok komponens az összes objektumhoz
• Nem működik több kapcsolattal egy projektben
• Nehéz az IDEA StatiCa egy adott verzióját kiválasztani

Új bővítmény 0.2.0 verzió

• Szorosan kapcsolódik a tényleges API kultúrájához (könnyebb átállás Python-ra vagy C#-ra) 
• A projektek a szerveren maradnak, amíg a felhasználó el nem menti azokat
• Az API komponensek aszinkronok, a felhasználók folytathatják a szkriptelést, miközben a komponensek számítanak
• API objektumok automatikus szétbontása
• Natívan működik a projekt összes kapcsolatával
• Az API csatoló/futtató lehetővé teszi a verzió egyszerű megadását
• IFC fájlok exportálása közvetlenül a Grasshopperben 
• A sablon alkalmazási munkafolyamat egységesítve van az alkalmazással
• A csapok és horgonyok definiálhatók az IOM komponensekben

Komponensek áttekintése

Az új bővítmény két panelre van osztva a Grasshopper szalagon. 

1. App Common: API komponensek, amelyek közösek az összes IDEA StatiCa tervezési API-ban. 
2. Connection: Az kapcsolat API-ra jellemző komponensek. 

Csatlakozás az API-hoz Grasshopperen keresztül

Más API kliensekhez hasonlóan a Grasshopper szkriptet csatlakoztathatja 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 azt, mielőtt bármely API komponens futtatható lenne. 

Helytelen:

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

Helyes: 

Ha érvényes API kapcsolat áll fenn, 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 tárolódik, í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óval, amely az aktív komponensbe van bekötve.

Az API komponensek szorosan kapcsolódnak a Connection API vezérlőihez. A vezérlők vagy művelet alapúak (Számítás, Export, Jelentés) vagy objektum alapúak (Teherhatás, Szerkezeti elem, Paraméterek stb.).

Művelet alapú: A művelet alapú vezérlők meghatározott feladatokat vagy műveleteket végeznek egy adott kapcsolaton vagy projekten, ezek közé tartozik a számítási vagy exportálási funkció.

 Objektum alapú: Az objektum alapú vezérlőknek általában van egy Get és egy Update komponensük:

• Get: Lekéri az összes vezérlő típusú objektumot a kapcsolatban, és lekéri azokat a konkrét objektumokat, amelyek szétbonthatók vagy módosíthatók. 
• Update: Frissíti a Grasshopper szkriptben frissített megadott objektumokat. Az objektumok frissítése az automatikus Modify Object komponens segítségével történik.

A legtöbb API komponens objektumokat vesz bemenetként és ad ki kimenetként, amelyek szétbontható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 összesített számát.

A legalapvetőbb példa egy projekt szétbontása az abban elérhető információk megszerzéséhez, például az elérhető kapcsolatok lekéréséhez. 

Egyszerű példa – kapcsolati paraméterek frissítése

Tekintse meg az egyszerű példát a Modify komponens működéséről. 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 kapcsolati paraméterek frissítésében. 

Használatra kész példák

A példák teljes listája elérhető a bővítményt 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

Verziókompatibilitás

Az új bővítmény, a 0.2.0 verzió elérhető a Rhino Package Managerben, és az IDEA StatiCa 24.1.3-as és újabb verzióival fog működni.

A régebbi 0.1.x verzió szintén elérhető lesz, és az IDEA StatiCa 24.1.2-es és régebbi verzióival fog működni.

Megjelent az IDEA StatiCa 24.1.4-es verziójában