Wissensdatenbank

Neue REST-API zwischen Grasshopper und Connection

Stahl

v25.0

Connection

Grasshopper

Parametric design

Dieser Artikel ist auch verfügbar in:

Aus dem Englischen mithilfe von KI übersetzt.

Das Grasshopper-Plugin wurde auf die neue IDEA StatiCa Connection API und IOM-Version aktualisiert. Es bietet eine neue Erfahrung, die besser mit modernen APIs übereinstimmt. Jede Komponente ist eng mit der API-Interaktion gekoppelt.

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

Installation des Plugins

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

Die Vorteile des neuen Grasshopper-Plugins

Mit der neuen Version des Plugins haben Benutzer Zugriff auf erweiterte Funktionen der neuen API und eine viel einfachere Interaktion zwischen Grasshopper und IDEA StatiCa Connection.

Alte Plugin-Version 0.1.X

Schwer zu verstehen, was in der API passiert, wenn Komponenten verwendet werden
Viele IO-Operationen
Lange Operationen (wie Berechnung) führen dazu, dass das Skript einfriert
Viele Komponenten für alle Objekte
Funktioniert nicht mit mehreren Verbindungen in einem Projekt
Schwierig, eine bestimmte Version von IDEA StatiCa auszuwählen

Neue Plugin-Version 0.2.0

Sehr eng mit der tatsächlichen API-Kultur gekoppelt (einfacherer Übergang zu Python oder C#)
Projekte befinden sich 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 Versionsspezifikation
IFC-Dateien direkt in Grasshopper exportieren
Template-Anwendungs-Workflow ist mit der Anwendung vereinheitlicht
Bolzen und Anker können in den IOM-Komponenten definiert werden

Komponentenübersicht

Das neue Plugin ist in zwei Panels im Grasshopper-Ribbon unterteilt.

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

Verbindung zur API über Grasshopper

Ähnlich wie bei anderen API-Clients können Sie das Grasshopper-Skript mit einer Runner-API-Instanz verbinden (Connection Service Attacher) oder den Service 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 auf der Komponente, wenn die Komponente versucht hat, ohne gültige API-Verbindung zu laufen.

Richtig:

Sobald eine gültige API-Verbindung besteht, sollte die Service-Komponente nicht erneut ausgeführt werden müssen, bis das Skript geschlossen oder davon weg navigiert 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 einmal durch Klicken auf die Schaltfläche Run ausgeführt oder kontinuierlich ausgeführt werden, indem ein True/False-Toggle mit der aktiven Komponente verbunden wird.

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

Aktionsbasiert: Aktionsbasierte Controller führen spezifische Aufgaben oder Operationen an einer bestimmten Verbindung oder einem Projekt aus, dazu gehören Berechnungs- oder Exportfunktionen

Objektbasiert: Objektbasierte Controller haben typischerweise eine Get-Komponente und eine Update-Komponente:

Get: Ruft alle Controller-Typ-Objekte in der Connection ab und ruft spezifische Objekte ab, die zerlegt oder modifiziert werden können.
Update: Aktualisiert bereitgestellte Objekte, die im Grasshopper-Skript aktualisiert 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 modifiziert werden können.Die Bereitstellung von Komponenten in diesem Format reduziert die Gesamtzahl 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 – Aktualisierung von Verbindungsparametern

Sehen Sie sich das einfache Beispiel an, 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.

Sofort einsatzbereite Beispiele

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