Neue REST API zwischen Grasshopper und Connection

Mit der Veröffentlichung der neuen REST Connection API werden die aktuellen Grasshopper-Komponenten, die sich auf die alte API (ConHiddenCalculator) beziehen, nicht mehr funktionieren, da diese API ab IDEA StatiCa Version 24.1.3 nicht mehr unterstützt wird.

Installation des Plugins

Wie bei älteren Versionen kann das Plugin über den Rhino Package Manager installiert werden. Öffnen Sie den Package Manager, indem Sie PackageManager in der Rhino-Befehlszeile eingeben. Aktualisieren oder installieren Sie einfach die neueste verfügbare Version des IDEA StatiCa-Plugins.

Vorteile des neuen Grasshopper-Plugins

Mit der neuen Version des Plugins haben Benutzer Zugang zu erweiterten Funktionen der neuen API und einer wesentlich einfacheren Interaktion zwischen Grasshopper und IDEA StatiCa Connection.

Alte Plugin-Version 0.1.X

• Schwer nachvollziehbar, was bei der Verwendung von Komponenten in der API passiert
• Viele Ein-/Ausgabe-Operationen
• Lange Operationen (wie Berechnungen) führen dazu, dass das Skript einfriert
• Viele Komponenten für alle Objekte
• Funktioniert nicht mit mehreren Verbindungen in einem Projekt
• Schwierige Auswahl einer bestimmten Version von IDEA StatiCa

Neue Plugin-Version 0.2.0

• Sehr eng an die eigentliche API-Kultur gekoppelt (einfacherer Übergang zu Python oder C#) 
• Projekte verbleiben auf dem Server, bis sie vom Benutzer gespeichert werden
• API-Komponenten sind asynchron, Benutzer können weiter skripten, während Komponenten berechnen
• Automatische Zerlegung von API-Objekten
• Funktioniert nativ mit allen Verbindungen im Projekt
• API-Attacher/Runner ermöglicht eine einfache Versionsangabe
• IFC-Dateien direkt in Grasshopper exportieren 
• Der Vorlagen-Anwendungsworkflow ist mit der Anwendung vereinheitlicht
• Pins und Anker können in den IOM-Komponenten definiert werden

Komponentenübersicht

Das neue Plugin ist in zwei Bereiche im Grasshopper-Menüband unterteilt. 

1. App Common: API-Komponenten, die für alle IDEA StatiCa-Design-APIs gemeinsam sind. 
2. Connection: Komponenten, die spezifisch für die Connection API sind. 

Verbindung mit der API über Grasshopper

Ähnlich wie bei anderen API-Clients können Sie das Grasshopper-Skript mit einer Runner-API-Instanz (Connection Service Attacher) verbinden oder den Dienst innerhalb von Grasshopper starten (Connection Service Runner). Ein Benutzer muss eine der oben genannten Komponenten auswählen und ausführen, bevor eine der API-Komponenten ausgeführt werden kann. 

Falsch:

Sie erhalten eine Fehlermeldung an der Komponente, wenn die Komponente versucht hat, ohne eine gültige API-Verbindung zu laufen.

Richtig: 

Sobald eine gültige API-Verbindung besteht, muss die Service-Komponente nicht erneut ausgeführt werden, bis das Skript geschlossen oder verlassen wird. Die Verbindung wird lokal gespeichert, sodass alle Komponenten darauf zugreifen können.

API-Komponenten

Die Schaltfläche „Active" unten identifiziert leicht Komponenten, die mit der API interagieren. Eine Komponente kann einmalig durch Klicken auf die Schaltfläche Run ausgeführt oder kontinuierlich durch einen True/False-Schalter, der in die aktive Komponente eingebunden ist, ausgeführt werden.

API-Komponenten sind eng mit Controllern in der Connection API verwandt. Controller sind entweder aktionsbasiert (Berechnung, Export, Bericht) oder objektbasiert (Lasteffekt, Bauteil, Parameter usw.).

Aktionsbasiert: Aktionsbasierte Controller führen spezifische Aufgaben oder Operationen an einer bestimmten Verbindung oder einem Projekt durch, darunter Berechnungs- oder Exportfunktionen.

 Objektbasiert: Objektbasierte Controller verfügen in der Regel über eine Get-Komponente und eine Update-Komponente:

• Get: Ruft alle Controller-Typ-Objekte in der Connection ab und gibt spezifische Objekte zurück, die zerlegt oder geändert werden können. 
• Update: Aktualisiert bereitgestellte Objekte, die im Grasshopper-Skript geändert wurden. Objekte werden mithilfe der automatischen Modify Object-Komponente aktualisiert.

Die meisten API-Komponenten nehmen Eingaben entgegen und liefern Ausgaben von Objekten, die zerlegt oder geändert werden können. Die Bereitstellung von Komponenten in diesem Format reduziert die Gesamtanzahl der Komponenten, die Benutzer hinzufügen müssen.

Das einfachste Beispiel ist die Zerlegung eines Projekts, um die darin verfügbaren Informationen zu erhalten, wie z. B. die verfügbaren Verbindungen. 

Einfaches Beispiel – Verbindungsparameter aktualisieren

Sehen Sie das einfache Beispiel, wie die Modify-Komponente funktioniert. Das Bild unten zeigt ein Beispiel für die Verwendung von API- und automatischen Objektkomponenten in einer einfachen Anwendung einer Vorlage und der Aktualisierung von Verbindungsparametern. 

Gebrauchsfertige Beispiele

Eine vollständige Liste von Beispielen steht Benutzern zur Verfügung, die das Plugin in der ZIP-Datei herunterladen: %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip

Versionskompatibilität

Das neue Plugin, Version 0.2.0, ist im Rhino Package Manager verfügbar und funktioniert mit IDEA StatiCa Version 24.1.3 und neuer.

Die ältere Version 0.1.x ist ebenfalls verfügbar und funktioniert mit IDEA StatiCa Version 24.1.2 und älter.

Veröffentlicht in IDEA StatiCa Version 24.1.4