Nové REST API mezi Grasshopper a Connection

S vydáním nového Rest Connection API již nebudou fungovat současné komponenty Grasshopperu související se starým API (ConHiddenCalculator), protože toto API již není podporováno od verze IDEA StatiCa 24.1.3.

Instalace pluginu

Stejně jako u starších verzí lze plugin nainstalovat přes Rhino Package Manager. Otevřete Package Manager zadáním příkazu PackageManager do příkazového řádku Rhina a poté nainstalujte nebo aktualizujte nejnovější verzi pluginu IDEA StatiCa. 

Výhody nového pluginu pro Grasshopper

S novou verzí pluginu mají uživatelé přístup k vylepšeným funkcím nového API a mnohem snazší interakci mezi Grasshopperem a IDEA StatiCa Connection. 

Stará verze pluginu 0.1.X 

• Těžké pochopit, co se děje v API při používání komponent 
• Mnoho IO operací 
• Dlouhotrvající operace způsobují zamrznutí skriptu 
• Mnoho komponent pro všechny objekty 
• Pouze jeden přípoj v projektu 
• Obtížný výběr specifické verze IDEA StatiCa

Nová verze pluginu 0.2.0 

• Velmi těsně spojená s aktuální API kulturou (snazší přechod na Python nebo C#) 
• Projekty jsou na serveru, dokud je uživatel neuloží 
• API komponenty jsou asynchronní, uživatelé mohou pokračovat ve skriptování během výpočtů 
• Automatické rozkládání API objektů 
• Přirozeně pracuje se všemi přípoji v projektu 
• API attacher/runner umožňuje snadnou specifikaci verze 
• Export IFC souborů přímo v Grasshopperu 
• Workflow používání šablon je sjednoceno s aplikací 
• Čepy a kotvy jsou k dispozici pro definici v IOM komponentách

Přehled komponent

Nový plugin je rozdělen do dvou panelů v pásu karet Grasshopperu. 

1. App Common: API komponenty, které jsou společné pro všechna IDEA StatiCa design API. 
2. Connection: Komponenty, které jsou specifické pro connection API. 

Připojení k API přes Grasshopper

Podobně jako u jiných API klientů můžete připojit Grasshopper skript k běžící instanci API (Connection Service Attacher) nebo spustit službu přímo v Grasshopperu (Connection Service Runner). Uživatel musí vybrat jednu z těchto komponent a spustit ji před tím, než může běžet jakákoliv API komponenta.

Špatně:

Zobrazí se chybová zpráva na komponentě, pokud se komponenta pokusila spustit bez platného API připojení. 

Správně:

Jakmile existuje platné API připojení, komponenta Service by neměla potřebovat opětovné spuštění, dokud není skript uzavřen nebo není přepnuto jinam. Připojení je uloženo lokálně, aby k němu měly přístup všechny komponenty.

API komponenty

Tlačítko "Active" níže snadno identifikuje komponenty, které komunikují s API. Komponenta může být spuštěna jedním klikem na tlačítko Run nebo může být průběžně vykonávána pomocí true/false přepínače připojeného k aktivní komponentě. 

API komponenty úzce souvisí s Controllery v Connection API. Controllery jsou buď akční (Výpočet, Export, Report) nebo objektové (Účinek zatížení, Prvek, Parametry, atd.). 

Akční: Akční controllery provádějí specifické úkoly nebo operace na konkrétním přípoji nebo projektu, včetně funkcí výpočtu nebo exportu 

Objektové: Objektové controllery typicky mají Get komponentu a Update komponentu: 

• Get: Získává všechny objekty typu controller v Connection a získává specifické objekty, které lze rozložit nebo upravit. 
• Update: Aktualizuje poskytnuté objekty, které byly upraveny v Grasshopper skriptu. Objekty jsou aktualizovány pomocí automatické komponenty Modify Object. 

Většina API komponent bude přijímat vstupy a poskytovat výstupy objektů, které lze rozložit nebo upravit. Poskytování komponent v tomto formátu snižuje celkový počet komponent, které musí použít. 

Nejzákladnějším příkladem je rozložení Projektu pro získání dostupných informací v něm, jako jsou dostupné přípoje.

Jednoduchý příklad – aktualizace parametrů přípoje

Podívejte se na jednoduchý příklad, jak funguje komponenta Modify. Obrázek níže ukazuje příklad použití API a automatických objektových komponent v při aplikaci jednoduché šablony a aktualizaci parametrů přípoje.

Připravené příklady k použití

Úplný seznam příkladů je dostupný uživatelům, kteří si stáhnou plugin v zazipovaném souboru: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip 

Kompatibilita verzí

Nový plugin, verze 0.2.0, je dostupný v Rhino Package Manager a bude fungovat s IDEA StatiCa verzí 24.1.3 a novější.

Starší verze 0.1.x bude také dostupná a bude fungovat s IDEA StatiCa verzí 24.1.2 a starší. 

Vydáno v IDEA StatiCa verzi 24.1.4