par Steve Baer, Scott Davidson, et Andy Payne (Dernière mise à jour :  lundi 28 octobre 2024)

Description

Hops est un composant pour Grasshopper dans Rhino 7 et Rhino 8 pour Windows. Hops ajoute des fonctions externes à Grasshopper. Comme d’autres langages de programmation, les fonctions vous permettent :

• de simplifier des algorithmes complexes en utilisant plusieurs fois la même fonction ;
• d’éliminer les combinaisons de composants dupliquées en plaçant les combinaisons communes dans une fonction ;
• de partager des documents de Grasshopper avec d’autres membres de l’équipe ;
• de référencer des documents de Grasshopper dans plusieurs projets ;
• de résoudre des documents externes en parallèle, ce qui permet d’accélérer les grands projets ;
• d’exécuter de manière asynchrone des calculs longs sans bloquer les interactions entre Rhino et Grasshopper.

Les fonctions de Hops sont stockées en tant que documents de Grasshopper distincts. Le composant Hops adaptera ses entrées et sorties afin de correspondre à la fonction spécifiée. Pendant le calcul, Hops résout la définition dans un processus indépendant, puis renvoie les résultats dans le document dans lequel vous travaillez.

Comment utiliser Hops ?

Installer Hops

Il y a plusieurs façons d’installer Hops sur votre machine.

1. Installez Hops (Cela lancera Rhino.)
2. Ou tapez PackageManager dans la ligne de commande de Rhino.
   1. Ensuite, recherchez « Hops ».
   2. Sélectionnez Hops et installez-le.

Créer une fonction Hops

Les fonctions Hops sont des documents de Grasshopper avec des entrées et des sorties spéciales.

Définition des entrées

Les entrées de Hops sont créées à partir des composants Get. Les composants Get disponibles dans Grasshopper se trouvent sous l’onglet Params > groupe Util :

Le nom du composant sera le nom du paramètre d’entrée de Hops. Ainsi, dans l’exemple ci-dessous, nous avons trois composants Get Number que nous avons appelés A, B et C. Chacun de ces composants Get devient un paramètre d’entrée lorsque Hops compile la définition.

Chaque composant Get dispose d’un menu contextuel (accessible par clic droit) permettant d’accéder à différentes options.

• Nom du composant - Il s’agit du nom qui sera attribué à l’entrée du composant Hops.
• Prompt - Cette entrée sera l’infobulle qui s’affichera lorsque vous survolerez ce paramètre dans le composant Hops.
• Enable/Disable - Permet d’activer ou de désactiver ce composant.
• At Least - Cette option n’est utilisée que par le lecteur de Grasshopper et permet de définir le nombre minimum de valeurs à accepter pour cette entrée.
• At Most - Cette option permet de définir le nombre maximum de valeurs à accepter pour cette entrée (par défaut = 1). Si cette valeur est fixée à 1, le composant Hops traitera cette entrée comme un Item Access. Toutefois, si cette valeur est supérieure à un (ou non définie), Hops traitera cette entrée comme un List Access.
• Tree Access - Cette option permet de définir si vous souhaitez introduire un arbre de données par cette entrée. Cette entrée n’est utilisée que dans Hops et si elle est définie sur True, elle remplacera la valeur At Most définie précédemment.
• Minimum et Maximum - Ces options facultatives ne sont utilisées que pour le lecteur de Grasshopper. Elles permettent de limiter le nombre d’entrées numériques.
• Presets - Cette option facultative n’est utilisée que pour le lecteur de Grasshopper et ne se trouve que sur les composants Get String, Integer et Number. Cette boîte de dialogue vous permet de définir une liste d’options prédéfinies qui s’afficheront pour l’utilisateur dans l’invite de la ligne de commande.

Définition des sorties

Les sorties de Hops peuvent être définies à l’aide des composants Context Bake ou Context Print. Le nom du paramètre d’entrée dans l’un ou l’autre des composants contextuels sera utilisé comme nom du paramètre de sortie de Hops.

Utiliser le composant Hops

1. Placez le composant Hops de Grasshopper sur la toile. Vous le trouverez dans l’onglet Params > groupe Util.
2. Cliquez avec le bouton droit de la souris sur le composant Hops, puis cliquez sur Path.
3. Sélectionnez une fonction de Hops. Il peut s’agir d’une définition de Grasshopper sur votre ordinateur, sur un ordinateur distant ou d’un point de terminaison REST.
4. Le composant affichera les entrées et les sorties.
5. Vous pouvez à présent utiliser ce nouveau composant comme n’importe quel autre composant de Grasshopper.

Remarque à propos de Hops pour les utilisateurs de macOS

Le composant Hops fonctionne en tandem avec une instance locale d’un serveur Rhino.compute qui, en général, est lancé à chaque fois que vous ouvrez Grasshopper. Cependant, ce serveur ne fonctionnera pas sous macOS, ce qui signifie que deux autres options s’offrent à vous. Vous pouvez :

1. faire en sorte qu’une API REST appelle un serveur distant fonctionnant sous Windows.
2. faire en sorte qu’une API REST appelle un serveur python ghhops_server fonctionnant localement.

La première option (appeler un serveur Windows distant) nécessitera quelques modifications au niveau de l’installation de la machine distante. Pour plus d’informations sur la configuration d’un serveur distant, reportez-vous à la section Configuration d’une machine distante.

La deuxième option (appeler un serveur python local) est couverte plus en détail dans la section intitulée Appeler un serveur CPython.

Paramètres de Hops

Paramètres d’application

Les paramètres de Hops contrôlent le fonctionnement de Hops au niveau de l’application. Pour y accéder, cliquez sur le menu déroulant de Grasshopper File > Preferences > Solver.

• Hops-Compute server URLs - Liste des adresses IP ou URL de toutes les machines ou serveurs Compute distants.
• API Key - La clé API est une chaîne de texte secrète réservée à votre serveur Compute et aux applications qui utilisent l’API Compute, par exemple b8f91f04-3782-4f1c-87ac-8682f865bf1b. Elle n’est pas obligatoire si vous effectuez des tests localement, mais doit être utilisée dans un environnement de production. En essence, c’est ainsi que le serveur Compute s’assure que les appels de l’API proviennent uniquement de vos applications. Vous pouvez saisir n’importe quelle chaîne de caractères unique et secrète pour vous et vos applications informatiques. Conservez-la en lieu sûr.
• Max Concurrent requests - Ce paramètre permet de limiter le nombre de requêtes actives dans des situations asynchrones. Ainsi, Hops ne fait pas des milliers de demandes pendant que la demande initiale est en cours de traitement.
• Clear Hops Memory cache - En cliquant sur ce bouton, vous effacez de la mémoire toutes les solutions enregistrées précédemment.
• Hide Rhino.Compute Console Window - Hops résoudra les définitions en arrière-plan ; mais parfois, l’affichage de la fenêtre peut être utile pour détecter des erreurs.
• Launch Local Rhino.Compute at Start - Cochez cette case pour les machines distantes lorsque Compute doit démarrer avant que des requêtes ne soient envoyées.
• Child Process Count - Cette option sert à limiter le nombre de demandes de processus parallèles supplémentaires. Il est recommandé de définir ce paramètre selon le nombre de cœurs disponibles.
• Function Sources - Cette section vous permet d’ajouter un chemin (soit vers un répertoire local, soit vers une URL) menant aux fonctions de Hops fréquemment utilisées (c’est-à-dire des définitions de Grasshopper).

Paramètres des composants

Cliquez avec le bouton droit de la souris sur le composant Hops pour sélectionner les options permettant de contrôler le fonctionnement de Hops.

• Parallel Computing - Pour passer chaque élément vers un nouveau nœud parallèle si cela est possible.
• Path… - C’est là que vous indiquez l’emplacement de la fonction GH à résoudre. Il peut s’agir d’un nom de fichier, d’une adresse IP ou d’une URL.
• Show Input: Path - Le chemin d’accès devient une entrée du composant de sorte qu’il peut être défini directement sur la toile de GH.
• Show Input: Enabled - Affiche une entrée Enabled qui exécute le composant en fonction d’une valeur booléenne True ou False.
• Asynchronous - L’interface utilisateur ne sera pas bloquée en attendant qu’un processus distant résolve la définition et la définition sera mise à jour lorsque la résolution sera terminée.
• Cache In Memory - Les solutions précédentes sont enregistrées en mémoire sur la machine locale afin d’améliorer les performances si les mêmes entrées ont déjà été calculées.
• Cache On Server - Les solutions précédentes sont enregistrées sur le serveur distant pour améliorer les performances. Actuellement, cette option n’est disponible que pour les services Hops distants.

Configuration de la machine distante

Par défaut, Hops utilise votre ordinateur local pour résoudre les fonctions de Grasshopper. Toutefois, il est possible de configurer des ordinateurs distants (c’est-à-dire des serveurs) ou des machines virtuelles que Hops pourra appeler.

Pour effectuer des appels API vers une machine distante, veuillez suivre ce guide sur la mise en place d’un environnement de production.

Appeler un serveur CPython

Utiliser Hops pour appeler CPython. Les principaux avantages de ce composant sont les suivants :

1. Il appelle des bibliothèques CPython, y compris Numpy et SciPy ;
2. Il utilise certaines des bibliothèques les plus récentes disponibles pour CPython, telles que TensorFlow ;
3. Il permet de créer des fonctions réutilisables et d’utiliser le traitement parallèle ;
4. Il prend en charge des modes de débogage réels, y compris les points d’arrêt ;
5. Prise en charge intégrale de Visual Studio Code ;
6. D’autres applications et services prenant en charge une API Python peuvent également utiliser les bibliothèques incluses ici ;
7. Le composant Hops essaie de détecter les changements au niveau des entrées et des sorties sur un serveur et se reconstruit lui-même.

Démarrer avec CPython dans Grasshopper

Ce module Python vous aide à créer des fonctions Python (plus précisément CPython) et à les utiliser dans vos scripts de Grasshopper avec les nouveaux composants Hops.

Obligatoire :

1. Rhino 7.4 ou une version plus récente.
2. CPython 3.8 ou supérieur
3. Composant Hops pour Grasshopper
4. Visual Studio Code fortement recommandé

Tutoriel vidéo :

Ce module peut utiliser son serveur HTTP intégré par défaut pour fournir les fonctions en tant que composants de Grasshopper, ou agir en tant qu’intergiciel pour une application Flask. Il peut également fonctionner avec Rhino.Inside.CPython pour donner un accès complet à l’API RhinoCommon.

Questions fréquentes

Est-il possible d’imbriquer des fonctions Hops dans d’autres fonctions ?

Oui, il est possible d’imbriquer la fonction Hops dans d’autres fonctions. On appelle cela recursion et la limite de récursion par défaut est fixée à 10.

L’utilisation de Hops est-elle payante ?

Hops est gratuit.

Peut-on utiliser Hops avec le lecteur de Grasshopper pour créer des commandes ?

Oui, les fonctions Hops peuvent utiliser les composants Context Bake et Context Print pour créer des commandes de Rhino dans le lecteur de Grasshopper.

Hops prend-il en charge le traitement parallèle ?

Oui, Hops lance par défaut un processus parallèle pour chaque branche de flux d’entrée d’un arbre de données.

Quels sont les types d’entrée et de sortie pris en charge par Hops ? (Il prend en charge tous les types courants, demandez-en d’autres si vous en avez besoin)

Hops transmet les types de données standard de Grasshopper (chaînes de caractères, nombres, lignes, etc.). Pour d’autres types de données tels que les images ou les fichiers météorologiques EPW, utilisez une chaîne de caractères pour le nom du fichier afin que la fonction externe puisse également lire le même fichier.

Les composants des modules peuvent-ils être exécutés dans des fonctions Hops ?

Oui, tous les modules de Grasshopper installés peuvent être exécutés dans une fonction Hops.

Peut-on l’utiliser pour des calculs extrêmement longs dans une fonction ?

Oui, chaque composant Hops dispose d’une option permettant de résoudre les problèmes de manière asynchrone. L’interface utilisateur ne sera pas bloquée dans l’attente de la résolution d’un processus distant et la définition sera mise à jour lorsque la résolution sera terminée. Hops attendra que tous les appels de fonction aient été retournés avant de transmettre les résultats aux composants en aval.

Modifier cette page

Modifier sur GitHub

Historique

Admin