Knihovna článků

Nové REST API mezi Grasshopperem a Přípojí

Ocel

v25.0

Connection

Grasshopper

Parametric design

Tento článek je dostupný také v dalších jazycích:

Translated by AI from English

Plugin Grasshopper je aktualizován na nové IDEA StatiCa Connection API a verzi IOM. Poskytuje nové prostředí, které je více v souladu s moderními API. Každá komponenta je úzce spojena s interakcí API.

S vydáním nového Rest Connection API přestanou současné komponenty Grasshopperu související se starým API (ConHiddenCalculator) fungovat, 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 prostřednictvím Rhino Package Manager. Otevřete Package Manager zadáním PackageManager do příkazového řádku Rhino. Jednoduše aktualizujte nebo nainstalujte nejnovější dostupnou verzi pluginu IDEA StatiCa.

Výhody nového pluginu Grasshopper

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

Stará verze pluginu 0.1.X

Těžko pochopitelné, co se děje v API při používání komponent
Mnoho IO operací
Dlouhé operace (jako výpočet) způsobují zamrznutí skriptu
Mnoho komponent pro všechny objekty
Nefunguje s více přípoji v projektu
Obtížný výběr konkrétní verze IDEA StatiCa

Nová verze pluginu 0.2.0

Velmi úzce spjatá se skutečnou kulturou API (snazší přechod na Python nebo C#)
Projekty jsou na serveru, dokud je uživatel neuloží
Komponenty API jsou asynchronní, uživatelé mohou pokračovat ve skriptování, zatímco komponenty počítají
Automatické rozkládání objektů API
Nativně funguje se všemi přípoji v projektu
API attacher/runner umožňuje snadnou specifikaci verze
Export IFC souborů přímo v Grasshopperu
Pracovní postup aplikace šablon je sjednocen s aplikací
Čepy a kotvy lze definovat v komponentách IOM

Přehled komponent

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

App Common: Komponenty API, které jsou společné pro všechna návrhová API IDEA StatiCa.
Connection: Komponenty, které jsou specifické pro API přípojů.

Připojení k API prostřednictvím Grasshopperu

Podobně jako u jiných klientů API můžete připojit skript Grasshopperu k instanci runner API (Connection Service Attacher) nebo spustit službu v rámci Grasshopperu (Connection Service Runner). Uživatel musí vybrat jednu z výše uvedených komponent a spustit ji před tím, než mohou být spuštěny jakékoli komponenty API.

Špatně:

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

Správně:

Jakmile existuje platné připojení API, komponenta Service by neměla být znovu spuštěna, dokud není skript uzavřen nebo od něj není přecházeno jinam. Připojení je uloženo lokálně, aby k němu měly přístup všechny komponenty.

Komponenty API

Tlačítko "Active" níže snadno identifikuje komponenty, které interagují s API. Komponenta může být spuštěna jednou kliknutím na tlačítko Run nebo průběžně prováděna pomocí přepínače true/false zapojeného do aktivní komponenty.

Komponenty API úzce souvisejí s Controllers v Connection API. Controllers jsou buď založené na akcích (Výpočet, Export, Zpráva) nebo založené na objektech (Zatěžovací účinek, Prut, Parametry atd.).

Založené na akcích: Controllery založené na akcích provádějí specifické úkoly nebo operace na konkrétním přípoji nebo projektu, patří sem funkce výpočtu nebo exportu

Založené na objektech: Controllery založené na objektech budou typicky mít komponentu Get a komponentu Update:

Get: Načte všechny objekty typu controller v přípoji a načte konkrétní objekty, které mohou být rozloženy nebo upraveny.
Update: Aktualizuje poskytnuté objekty, které byly aktualizovány ve skriptu Grasshopperu. Objekty jsou aktualizovány pomocí automatické komponenty Modify Object.

Většina komponent API bude přijímat vstupy a poskytovat výstupy objektů, které mohou být rozloženy nebo upraveny.Poskytování komponent v tomto formátu snižuje celkový počet komponent, které musí uživatelé přidat.

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 komponent Automatic Object v jednoduché aplikaci šablony a aktualizaci parametrů přípoje.

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

Úplný seznam příkladů je k dispozici 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