1 · Hello workflow

Objectif

Créer ton premier workflow MecaPy, calculer la pression dynamique de pointe $q_p(z_e)$ d’un vent réglementaire (EN 1991-1-4), et voir le résultat. Durée estimée : 10-15 min.

Pré-requis

• Un compte MecaPy actif (login OK).
• Le package eurocode-1-1-4 (version ≥ 0.3.0) est déployé sur ton environnement — sinon contacte ton administrateur.

Ce que tu vas apprendre

À la fin de ce chapitre, tu sauras :

• Créer un workflow vide depuis l’espace Workflows.
• Ajouter un nœud d’entrée (input) typé.
• Ajouter un nœud fonction depuis le catalogue des packages.
• Créer un nœud constante depuis un port d’entrée vacant (la manière la plus rapide pour figer une valeur normative).
• Connecter les ports en respectant les types.
• Sauvegarder et exécuter le workflow.
• Lire le résultat d’un calcul.

Le calcul qu’on va modéliser

L’Eurocode 1 partie 1-4 (vent) définit la pression dynamique de pointe $q_p(z)$ à une altitude $z$ au-dessus du sol :

$$q_p(z) \;=\; \bigl(1 + 7\,I_v(z)\bigr)\;\cdot\;\tfrac{1}{2}\,\rho\,v_m(z)^{2}$$

où $I_v(z)$ est l’intensité de turbulence et $v_m(z)$ la vitesse moyenne, toutes deux calculées depuis la vitesse de référence $v_{b,0}$ (région climatique) et la rugosité du terrain — chaîne complète §4 :

$$\begin{aligned} v_b &= c_\text{dir} \cdot c_\text{season} \cdot v_{b,0} \\ v_m(z) &= c_r(z) \cdot c_0(z) \cdot v_b \\ I_v(z) &= \frac{k_I}{c_0(z) \cdot \ln(z/z_0)} \end{aligned}$$

Les coefficients $c_\text{dir}$, $c_\text{season}$, $c_0$ et $k_I$ valent 1,0 dans les conditions standard ; le package les expose avec cette valeur par défaut, donc on n’aura pas à les câbler.

Pour notre exemple :

• $v_{b,0} = 26\ \text{m/s}$ (région française 3, Bretagne intérieure)
• $\text{terrain} = \texttt{"II"}$ (zone à végétation basse, fermes isolées)
• $z_e = 3{,}40\ \text{m}$ (altitude du centre de notre panneau)
• $\rho = 1{,}25\ \text{kg/m}^{3}$ (masse volumique de l’air à basse altitude)

Résultat attendu : $q_p \approx 722\ \text{Pa} = 0{,}72\ \text{kN/m}^{2}$.

Étapes

1. Créer le workflow

   Depuis le menu Workflows, clique sur + New workflow. Donne un nom : Tutoriel ch01 - Pression vent.

   

   Le canvas est la zone centrale où tu vas composer ton calcul, sous forme de graphe orienté. À gauche, la palette d’outils ; à droite, le panneau de propriétés (vide pour l’instant).

2. Ajouter le nœud fonction qp

   On part de la fonction et on tirera les inputs depuis ses ports — c’est plus rapide que de placer les inputs d’abord.

   Clic droit sur le canvas → Add function node. Dans le picker :

   • Package : eurocode-1-1-4
   • Version : 0.3.0 (dernière déployée)
   • Function : qp

   

   Le nœud apparaît avec ses ports d’entrée à gauche ($v_{b,0}$, $z$, $\text{terrain}$, $\rho$, $c_\text{dir}$, …) et sa sortie $q_p$ à droite. Les ports avec une valeur par défaut ($c_\text{dir}$, $c_\text{season}$, $c_0$, $k_I$ — tous à 1,0) peuvent rester non-connectés : la fonction utilisera la valeur recommandée Eurocode automatiquement.

   

3. Créer les trois inputs depuis les ports

   Plutôt que d’aller chercher le nœud Input dans la palette, tu peux partir du port d’entrée : clique sur le point du port d’entrée à gauche du nœud qp, garde appuyé, et relâche sur une zone vide du canvas. Un popup apparaît :

   • Add input → crée un nœud Input typé et le câble pour toi.
   • Add constant → crée un nœud Constante typé et le câble.

   Fais cette manipulation 3 fois, une par port, en choisissant Add input. Chaque Input créé prend automatiquement le label <fonction>.<port> :

   Port de qp	Type	Label auto-rempli
   vb_0	Velocity	qp.vb_0
   z	Length	qp.z
   terrain	Literal["0", "I", "II", "III", "IV"]	qp.terrain

   

   Pourquoi le typage est précieux

   Le type Velocity est une quantité physique du catalogue MecaPy v1 — il porte une dimension (m/s) et empêche les branchements incohérents (impossible de brancher un Velocity sur un port qui attend une Length). Les inputs créés depuis le port héritent automatiquement du type attendu.

4. Créer la constante rho depuis son port

   Le port $\rho$ attend la masse volumique de l’air. Sa valeur normative est $1{,}25\ \text{kg/m}^3$ — pas la peine d’en faire un input que l’utilisateur devrait re-saisir à chaque run.

   Refais la même manipulation que pour les inputs (clic sur le point du port $\rho$, drag jusqu’à une zone vide du canvas, relâche), mais cette fois choisis Add constant dans le popup :

   

   Le panneau de propriétés s’ouvre sur le nouveau nœud :

   • Label : rho
   • Type : Density (déjà rempli, hérité du port)
   • Value : 1.25

   

   Les autres ports adimensionnels — $c_\text{dir}$, $c_\text{season}$, $c_0$, $k_I$ — restent non-connectés. La fonction utilisera leur valeur par défaut (1,0). On n’a donc à câbler que 4 entrées significatives sur 8.

5. Ajouter le nœud de sortie

   Clic droit sur le canvas → Add output. Connecte la sortie $q_p$ du nœud fonction sur le port d’entrée du nœud Output.

   

   Le canvas refuse les branchements incompatibles : si tu essaies de brancher un Velocity sur le port Pressure du nœud Output, l’edge n’est pas créée.

6. Sauvegarder

   Clique sur Save. Une notification confirme la sauvegarde.

   

   Sous le capot, MecaPy a créé une version du workflow. Chaque sauvegarde produit une nouvelle version immuable — tu peux toujours revenir à un état précédent.

7. Exécuter

   Clique sur Run (en haut à droite). Renseigne les 3 inputs :

   Input	Valeur
   qp.vb_0	26.0
   qp.z	3.40
   qp.terrain	"II"

   MecaPy schedule le calcul, qui se termine en quelques secondes. Sur la page du run, tu vois la valeur de sortie :

   $$q_p \;\approx\; 722\ \text{Pa}$$

   

   Soit 0,72 kN/m² — cohérent avec l’Eurocode pour ce site et cette altitude.

Ce que tu viens de faire

• Tu as composé un calcul normatif sous forme de graphe.
• Le typage des ports a évité les erreurs d’unités à la construction (impossible de brancher un Velocity sur un port Length).
• Les valeurs par défaut sur les facteurs adimensionnels recommandés Eurocode t’ont évité de câbler 4 nœuds redondants.
• L’exécution a été reproductible : mêmes inputs → même résultat, toujours.

Récupérer le workflow tout fait

Si tu veux comparer ton graphe à la version de référence, ou éviter de tout re-cliquer pour le chapitre 2, tu peux importer le workflow directement :

📥 Télécharger ch01-pression-vent.workflow.yaml

Depuis l’espace Workflows, clique sur Import, sélectionne le fichier, et MecaPy recrée le graphe à l’identique (en s’appuyant sur le digest source du package eurocode-1-1-4 pour résoudre les références fonction). Tu n’as plus qu’à le lancer.

Prochain chapitre

2 · Composition de plusieurs fonctions (à venir) : on ajoute Fw_signboard (force du vent sur panneau), puis on introduit les operators natifs (subtract, multiply) pour calculer le bras de levier et le moment au pied du poteau.