Add FEM Equation Tutorial/fr

Introduction
Dans ce tutoriel, nous allons ajouter l'équation de flux à FreeCAD et implémenter le support pour le solveur Elmer. Assurez-vous d'avoir lu et compris Module d'extension FEM avant de lire ce tutoriel.

La tâche peut être divisée en quatre parties:
 * La première étape consiste à informer l'atelier de travail FEM d'un nouveau type d'équation. Cette étape ne doit être effectuée que si l'équation n'existe pas encore dans FreeCAD (par opposition à une équation qui est déjà dans FreeCAD mais qui n'est pas prise en charge par le solveur cible).
 * La deuxième étape consiste à ajouter un objet document représentant l’équation spécifique d’Elmer.
 * La troisième étape consiste à ajouter la prise en compte de la nouvelle équation dans le solveur d'Elmer.
 * Après cela, l'exportation d'analyse sous Elmer doit être étendue pour prendre en charge le nouveau type d'équation.

Ajout d'un nouveau type d'équation
In this step we are going to modify the following file:



The equation type is shared among all equation objects of the different solver. Each type has a string specifier (e.g. "Heat") and a dedicated command that adds the equation to the selected solver. This allows for a simpler GUI where we have only one button for the heat equation which is used for all supported solver.

First add the new equation to the module. Each equation requires two classes. A document proxy and a view proxy. Those two classes will later be used as base classes for the Elmer specific equation classes. Just copy-paste them from an existing equation type and adjust the icon path inside of the view proxy.

L'objet équation d'Elmer
Dans cette étape, nous allons modifier le fichier suivant:



et ajoutez le nouveau fichier suivant:



Commençons par le module qui implémente l'objet document. Il peut être copié à partir d'une équation existante. L'équation de l'écoulement dans Elmer est une équation potentiellement non linéaire. Cela signifie que nous allons focaliser notre travail sur.
 * Si la nouvelle équation ne prend en charge que les mots-clés des systèmes linéaires, copiez le module.
 * S'il prend également en charge les mots-clés non linéaires, copiez.

Keywords

 * If the new equation only supports keywords for linear systems copy the module.
 * If the new equation supports keywords for both linear and non-linear systems, copy.

The flow equation in Elmer is a potentially non-linear equation. This means that we are going to base our work on.

Editing files
Après avoir copié dans, ajustez
 * l’argument name de la fonction create module,
 * l’attribut Type de la classe Proxy
 * les classes de base des classes et
 * ainsi que les propriétés ajoutées via la fonction à ceux requis par l'équation.

Then you need to change the properties added via the function to those needed by the equation.

Au moment de la rédaction de ce tutoriel, l'équation de flux Elmer n'a aucunes propriétés particulières. Voir l'équation d'élasticité d'Elmer pour un exemple avec des propriétés.

Enfin, il faut enregistrer une définition de makeEquationStatcurrent dans en dupliquant une entrée disponible.

Enfin et surtout, enregistrez le nouveau fichier de module dans les deux fichiers  comme décrit dans Module d'extension FEM. Les listes appropriées peuvent être facilement trouvées en recherchant les fichiers de modules d’équations existants d’Elmer.

Extension de l'objet du solveur
Dans cette étape, nous allons modifier le fichier suivant:



À l'heure actuelle, nous avons informé FreeCAD qu'il existe un nouveau type d'équation et nous avons même ajouté une commande qui ajoute cette équation à l'objet solveur sélectionné. Nous avons également implémenté un objet d'équation concret pour Elmer. Que reste-t-il à faire maintenant pour faire le lien entre Elmer et l'équation de débit. Cela doit être fait directement dans l'objet solveur Elmer.

Enregistrez le module dans lequel nous venons d'implémenter notre nouvel objet équation avec le spécificateur d'équation de l'étape 1 (&quot;Flow&quot;) dans la liste  dans.

Extension de l'analyse à l'export
Dans cette étape, nous allons modifier le fichier suivant:



C'est la partie la plus exigeante de la mise en œuvre d'une nouvelle équation. Ce fichier contient la classe qui exporte l'analyse au format sif d'Elmer.

Pour chaque équation prise en charge, il existe une série de méthodes gérant l'exportation de l'équation respective. Copiez-les simplement à partir d'une équation existante et ajustez-les à vos besoins. Notre équation de flux utilise les méthodes suivantes:



You need to register the method inside the  class:

can control a series of other detailed methods. Our flow equation uses the following detailed methods:



We now finished the function part of the new equation. Next we'll connect the new equation through the GUI.

Gui tool to create an equation
We have just created a new equation class. To access it from the FEM GUI, we need to create a button and link it to the new equation class. Here is a tutorial: Add button to FEM toolbar tutorial.