Base théorique

Nouvelle REST API entre Grasshopper et Connection

Steel

v25.0

Connection

Grasshopper

Cet article est aussi disponible en :

Le plugin Grasshopper est mis à jour vers la nouvelle API IDEA StatiCa Connection et la version IOM. Il offre une nouvelle expérience plus conforme aux API modernes. Chaque composant est étroitement couplé à l'interaction avec l'API.

Avec la sortie de la nouvelle API Rest Connection, les composants Grasshopper actuels liés à l'ancienne API (ConHiddenCalculator) ne fonctionneront plus car cette API n'est plus prise en charge à partir de la version 24.1.3 d'IDEA StatiCa.

Installation du plugin

Tout comme avec les versions précédentes, le plugin peut être installé via le Rhino Package Manager. Ouvrez le Package Manager en tapant PackageManager dans l'invite de commande Rhino. Mettez simplement à jour ou installez la dernière version disponible du plugin IDEA StatiCa.

Les avantages du nouveau plugin Grasshopper

Avec la nouvelle version du plugin, les utilisateurs ont accès aux fonctionnalités améliorées de la nouvelle API et à une interaction beaucoup plus facile entre Grasshopper et IDEA StatiCa Connection.

Ancienne version du plugin 0.1.X

Difficile de comprendre ce qui se passe dans l'API lors de l'utilisation des composants
Beaucoup d'opérations d'E/S
Les opérations longues (comme le calcul) provoquent le gel du script
Beaucoup de composants pour tous les objets
Ne fonctionne pas avec plusieurs connexions dans un projet
Difficile de choisir une version spécifique d'IDEA StatiCa

Nouvelle version du plugin 0.2.0

Très étroitement couplé à la culture réelle de l'API (transition plus facile vers Python ou C#)
Les projets sont sur le serveur jusqu'à ce qu'ils soient enregistrés par l'utilisateur
Les composants API sont asynchrones, les utilisateurs peuvent continuer à scripter pendant que les composants calculent
Décomposition automatique des objets API
Fonctionne nativement avec toutes les connexions du projet
L'attacheur/exécuteur d'API permet une spécification facile de la version
Exportation de fichiers IFC directement dans Grasshopper
Le flux de travail d'application de modèle est unifié avec l'application
Les broches et ancrages peuvent être définis dans les composants IOM

Aperçu des composants

Le nouveau plugin est divisé en deux panneaux dans le ruban Grasshopper.

App Common : Composants API communs à toutes les API de conception IDEA StatiCa.
Connection : Composants spécifiques à l'API de connexion.

Connexion à l'API via Grasshopper

Comme pour les autres clients API, vous pouvez connecter le script Grasshopper à une instance d'API runner (Connection Service Attacher) ou démarrer le service dans Grasshopper (Connection Service Runner). Un utilisateur doit sélectionner l'un des composants ci-dessus et l'exécuter avant que l'un des composants API puisse s'exécuter.

Incorrect :

Un message d'erreur vous sera fourni sur le composant si le composant a tenté de s'exécuter sans connexion API valide.

Correct :

Une fois qu'il y a une connexion API valide, le composant Service ne devrait pas avoir besoin d'être réexécuté jusqu'à ce que le script soit fermé ou que l'on s'en éloigne. La connexion est stockée localement afin que tous les composants puissent y accéder.

Composants API

Le bouton « Active » ci-dessous identifie facilement les composants qui interagissent avec l'API. Un composant peut être exécuté une fois en cliquant sur le bouton Run ou exécuté en continu en utilisant un interrupteur vrai/faux câblé au composant actif.

Les composants API sont étroitement liés aux contrôleurs dans l'API Connection. Les contrôleurs sont soit basés sur des actions (Calcul, Export, Rapport) soit basés sur des objets (Effet de charge, Membre, Paramètres, etc.).

Basés sur des actions : Les contrôleurs basés sur des actions effectuent des tâches ou des opérations spécifiques sur une connexion ou un projet spécifique, notamment les fonctionnalités de calcul ou d'exportation

Basés sur des objets : Les contrôleurs basés sur des objets auront généralement un composant Get et un composant Update :

Get : Récupère tous les objets de type contrôleur dans la connexion et récupère des objets spécifiques qui peuvent être déconstruits ou modifiés.
Update : Met à jour les objets fournis qui ont été mis à jour dans le script Grasshopper. Les objets sont mis à jour à l'aide du composant automatique Modify Object.

La plupart des composants API prendront des entrées et fourniront des sorties d'objets, qui peuvent être déconstruits ou modifiés.Fournir des composants dans ce format réduit le nombre global de composants que les utilisateurs doivent ajouter.

L'exemple le plus basique consiste à déconstruire un projet pour obtenir les informations disponibles qu'il contient, telles que les connexions disponibles.

Exemple simple – mise à jour des paramètres de connexion

Voir l'exemple simple de fonctionnement du composant Modify. L'image ci-dessous montre un exemple d'utilisation de l'API et des composants d'objet automatique dans une application simple d'un modèle et de mise à jour des paramètres de connexion.

Exemples prêts à l'emploi

Une liste complète d'exemples est disponible pour les utilisateurs qui téléchargent le plugin dans le fichier compressé : %appdata%\McNeel\Rhinoceros\packages\8.0\IdeaStatiCaGrasshopper\[0.0.0]\Examples 0.2.0.zip