Nowe REST API między Grasshopper i Connection

Po wydaniu nowego Rest Connection API, dotychczasowe komponenty Grasshopper związane ze starym API (ConHiddenCalculator) nie będą już działać, ponieważ to API nie jest już obsługiwane od wersji IDEA StatiCa 24.1.3.

Instalacja wtyczki

Podobnie jak w przypadku starszych wersji, wtyczkę można zainstalować za pomocą Rhino Package Manager. Otwórz Package Manager, wpisując PackageManager w wierszu poleceń Rhino. Wystarczy zaktualizować lub zainstalować najnowszą dostępną wersję wtyczki IDEA StatiCa.

Zalety nowej wtyczki Grasshopper

Dzięki nowej wersji wtyczki użytkownicy mają dostęp do rozszerzonych funkcji nowego API oraz znacznie łatwiejszej interakcji między Grasshopper a IDEA StatiCa Connection.

Stara wersja wtyczki 0.1.X

• Trudno zrozumieć, co dzieje się w API podczas korzystania z komponentów
• Duża liczba operacji wejścia/wyjścia
• Długie operacje (np. obliczenia) powodują zawieszenie skryptu
• Duża liczba komponentów dla wszystkich obiektów
• Brak obsługi wielu połączeń w projekcie
• Trudny wybór konkretnej wersji IDEA StatiCa

Nowa wersja wtyczki 0.2.0

• Bardzo ścisłe powiązanie z kulturą rzeczywistego API (łatwiejsze przejście do Python lub C#) 
• Projekty pozostają na serwerze do momentu zapisania przez użytkownika
• Komponenty API są asynchroniczne – użytkownicy mogą kontynuować tworzenie skryptów podczas obliczeń komponentów
• Automatyczna dekompozycja obiektów API
• Natywna obsługa wszystkich połączeń w projekcie
• Moduł dołączający/uruchamiający API umożliwia łatwe określenie wersji
• Eksport plików IFC bezpośrednio w Grasshopper 
• Przepływ pracy z zastosowaniem szablonów jest ujednolicony z aplikacją
• Piny i kotwy są dostępne do zdefiniowania w komponentach IOM

Przegląd komponentów

Nowa wtyczka jest podzielona na dwa panele na wstążce Grasshopper. 

1. App Common: Komponenty API wspólne dla wszystkich API projektowych IDEA StatiCa. 
2. Connection: Komponenty specyficzne dla Connection API. 

Łączenie z API przez Grasshopper

Podobnie jak w przypadku innych klientów API, można podłączyć skrypt Grasshopper do działającej instancji API (Connection Service Attacher) lub uruchomić usługę w ramach Grasshopper (Connection Service Runner). Użytkownik musi wybrać jeden z powyższych komponentów i uruchomić go przed uruchomieniem jakiegokolwiek komponentu API. 

Błędnie:

Na komponencie zostanie wyświetlony komunikat o błędzie, jeśli komponent próbował uruchomić się bez prawidłowego połączenia z API.

Poprawnie: 

Po nawiązaniu prawidłowego połączenia z API komponent Service nie wymaga ponownego uruchamiania do momentu zamknięcia skryptu lub przejścia do innego miejsca. Połączenie jest przechowywane lokalnie, dzięki czemu wszystkie komponenty mają do niego dostęp.

Komponenty API

Przycisk „Active" widoczny poniżej umożliwia łatwe zidentyfikowanie komponentów współpracujących z API. Komponent można uruchomić jednorazowo, klikając przycisk Run, lub wykonywać go w sposób ciągły, używając przełącznika true/false podłączonego do aktywnego komponentu.

Komponenty API są ściśle powiązane z kontrolerami w Connection API. Kontrolery są albo oparte na działaniach (Calculation, Export, Report), albo oparte na obiektach (efekt obciążenia, element, parametry itp.).

Oparte na działaniach: Kontrolery oparte na działaniach wykonują określone zadania lub operacje na konkretnym połączeniu lub projekcie – obejmują funkcje obliczeniowe lub eksportu.

 Oparte na obiektach: Kontrolery oparte na obiektach zazwyczaj posiadają komponent Get i komponent Update:

• Get: Pobiera wszystkie obiekty danego typu kontrolera w Connection i zwraca konkretne obiekty, które można dekonstruować lub modyfikować. 
• Update: Aktualizuje dostarczone obiekty, które zostały zmodyfikowane w skrypcie Grasshopper. Obiekty są aktualizowane za pomocą automatycznego komponentu Modify Object.

Większość komponentów API przyjmuje dane wejściowe i dostarcza dane wyjściowe w postaci obiektów, które można dekonstruować lub modyfikować. Dostarczanie komponentów w tym formacie zmniejsza ogólną liczbę komponentów, które użytkownicy muszą dodawać.

Najprostszym przykładem jest dekonstrukcja projektu w celu uzyskania dostępnych w nim informacji, takich jak dostępne połączenia. 

Prosty przykład – aktualizacja parametrów połączenia

Zobacz prosty przykład działania komponentu Modify. Poniższy obraz przedstawia przykład użycia komponentów API i Automatic Object w prostym zastosowaniu szablonu oraz aktualizacji parametrów połączenia. 

Gotowe przykłady

Pełna lista przykładów jest dostępna dla użytkowników, którzy pobiorą wtyczkę w pliku skompresowanym: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip

Zgodność wersji

Nowa wtyczka w wersji 0.2.0 jest dostępna w Rhino Package Manager i będzie współpracować z IDEA StatiCa w wersji 24.1.3 i nowszych.

Starsza wersja 0.1.x będzie również dostępna i będzie współpracować z IDEA StatiCa w wersji 24.1.2 i starszych.

Wydano w IDEA StatiCa wersja 24.1.4