Plot MultiAxes tutorial/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "La première chose que vous trouverez dans l'outil, {{KEY|16px|text-top=Ajouter, effacer ou éditer les axes Plot|link=Plot_Axes/fr [[Plot_Axes/fr|Plot...")
(Updating to match new version of source page)
 
(76 intermediate revisions by 5 users not shown)
Line 1: Line 1:
<languages/>
Avant de commencer ce didacticiel, lisez le [[Plot_Basic_tutorial/fr|Tutoriel de base]]. Dans ce tutoriel, vous apprendrez comment créer, et, modifier un tracé '''multi-axes'''.


{{TutorialInfo/fr
Ici, vous en apprendrez plus sur le '''[[Plot_Module/fr|module Plot]]'''.
|Topic=Atelier Plot
|Level=Intermediaire
|Time=
|Author=
|FCVersion=0.19
|Files=
}}


Veuillez effectuer le [[Plot_Basic_tutorial/fr|tutoriel de base]] avant de commencer avec ce tutoriel. Dans ce didacticiel, nous allons apprendre à créer et à modifier un tracé multiaxes. Vous pouvez en savoir plus sur l'[[Plot_Workbench/fr|Atelier Plot ici]].
[[Image:Plot_MultiAxes_Example.png|480px|center|exemple Multiaxes Plot]]
<center><span style="font-variant:small-caps">exemple Plot Multiaxes.</span></center>


[[Image:Plot_MultiAxes_Example.png|600px]]
Dans l'image précédente, vous pouvez avoir une idée du résultat que l'on peut obtenir.
{{Caption|Exemple de tracé multiaxe}}


Dans ce tutoriel, vous apprendrez :
Dans l'image, vous pouvez voir le résultat que nous obtiendrons approximativement. En suivant ce tutoriel, vous apprendrez :
* Comment créer un graphe multi-axes à partir de la [[Python_console/fr|console Python]].
* Comment éditer les propriétés des axes.
* Comment contrôler la grille et la légende lorsque plusieurs ensembles d'axes sont présents.
* Comment éditer la position des étiquettes, titres et légendes.


<span id="Plotting_data"></span>
* Comment créer un '''multiaxes Plot''' à partir de la Console Python.
==Traçage des données==
* Comment faire pour modifier les propriétés des axes.
* Comment contrôler la grille/légende, lorsque plusieurs axes sont présent.
* Comment faire pour modifier des étiquettes (labels), des titres, et, des positions des légendes.


Comme nous l'avons fait dans le [[Plot_Basic_tutorial/fr|tutoriel précédent]], nous allons utiliser la [[Python_console/fr|console Python]] ou des [[Macros/fr|macros]] pour tracer les données, mais dans ce cas, nous allons tracer les données en utilisant deux ensembles d'axes.
==Traceur de données==


<span id="Creating_plot_data"></span>
Comme nous l'avons fait dans le [[Plot_Basic_tutorial/fr|tutoriel]], nous utiliserons la console Python intégrée, ou des [[Macros/fr|macros]], afin de tracer les données, avec la différence, que dans ce cas nous tracerons les données dans deux axes différents.
===Création de données de tracé===


Dans cet exemple, nous allons tracer 3 fonctions, les deux utilisées dans le [[Plot_Basic_tutorial/fr|tutoriel précédent]] et une nouvelle fonction polynomiale. L'étendue de la fonction polynomiale est différente des autres fonctions, donc de nouveaux axes sont nécessaires. Les commandes suivantes vont créer les tableaux de données pour nous :
===Création de données Plot===


{{Code|code=
Dans cet exemple, nous allons tracer 3 fonctions, deux, sont celles utilisées dans [[Plot_Basic_tutorial/fr|le Tutoriel de base]], et, un polynôme.
import math
p = range(0,1001)
x = [2.0*xx/1000.0 for xx in p]
y = [xx**2.0 for xx in x]
t = [tt/1000.0 for tt in p]
s = [math.sin(math.pi*2.0*tt) for tt in t]
c = [math.cos(math.pi*2.0*tt) for tt in t]
}}


Comme ''x'' se déplace de 0 à 2, la fonction ''y'' a une valeur maximale de 4, donc si nous essayons de tracer cette fonction avec les fonctions trigonométriques, au moins une fonction sera tronquée ou mal mise à l'échelle, donc nous avons besoin d'un tracé multi-axes. Un tracé multiaxe dans FreeCAD est destiné à obtenir un tracé avec plusieurs axes, et non à obtenir plusieurs tracés dans le même document.
Le problème est que, un '''polynôme''', aura besoin de nouveaux axes, la raison est, la variation de la gamme, qui est différente de toutes les autres.


<span id="Drawing_functions,_adding_new_axes"></span>
Les commandes suivantes, vont nous créer des tableaux de données :
===Fonctions de dessin, ajout de nouveaux axes===
<syntaxhighlight>
import math
p = range(0,1001)
x = [2.0*xx/1000.0 for xx in p]
y = [xx**2.0 for xx in x]
t = [tt/1000.0 for tt in p]
s = [math.sin(math.pi*2.0*tt) for tt in t]
c = [math.cos(math.pi*2.0*tt) for tt in t]
</syntaxhighlight>
Comme '''x''' passe de '''0''' à '''2''', la fonction '''y''', a une valeur maximale de '''4''', donc, si nous essayons de tracer cette fonction avec des formules trigonométrique, au moins une fonction sera tronquée, ou mal ajustée, alors nous aurons besoin d'un '''Plot multi-axes'''.


Nous allons tracer les fonctions trigonométriques en utilisant les axes principaux. Si tous vos axes ont la même taille, il n'est pas important de savoir quelle fonction est tracée en premier. Mais si ce n'est pas le cas, la fonction qui utilise les plus grands axes, dans notre cas la fonction polynomiale, doit être tracée en dernier. La légende sera attachée au dernier système d'axes et il est plus pratique que ce soit le plus grand. Pour tracer les fonctions trigonométriques, il suffit de lancer quelques commandes.
La fonction '''Plot multi-axes''' de FreeCAD, est orienté de manière à obtenir un '''Plot''' à axes multiples, pour ne pas obtenir de multiples combinaisons dans le même document.


{{Code|code=
===Fonction ajoutant de nouveaux axes de dessin===
try:
from FreeCAD.Plot import Plot
except ImportError:
from freecad.plot import Plot


Plot.plot(t,s,r"$\sin\left( 2 \pi t \right)$")
Nous allons exécuter une fonction polynomiale à axes principaux. Si tous vos axes ont la même taille alors, il n'est pas pertinent que la fonction soit mesurées dans les axes, mais il faut que votre '''Plot''' aie des axes de dimensions différentes (comme dans cet exemple), les axes principaux doivent être plus grand (car ces axes ont un fond blanc).
Plot.plot(t,c,r"$\cos\left( 2 \pi t \right)$")
}}


Dans cet exemple, nous transmettons directement les étiquettes des séries pour la légende. Notez que les chaînes d'étiquettes ont le préfixe ''r'' afin d'empêcher Python d'essayer d'interpréter des caractères spéciaux (le symbole ''\'' est fréquemment utilisé dans la syntaxe [http://www.latex-project.org LaTeX]).
Pour ce faire, il suffit de lancer une commande :
<syntaxhighlight>
import Plot
Plot.plot(x,y,r"$x^2$")
</syntaxhighlight>
Dans cet exemple, nous transmettons directement l'étiquette (label) de la série pour la légende. Notez que la chaîne d'étiquettes, a le préfixe '''r''', afin d'éviter que Python ne tente d'interpréter les caractères spéciaux (symbole '''\''' qui est fréquemment utilisé dans la syntaxe [http://www.latex-project.org LaTeX]).


Maintenant nous pouvons tracer des fonctions trigonométriques, mais avant, créez de nouveaux axes. Dans '''[[Plot_Module/fr|FreeCAD Plot module]]''' lorsque vous créez de nouveaux axes, ces axes sont sélectionnés comme actifs, donc, de nouveaux '''Plots''', seront associés à ces axes.
Avant de pouvoir tracer la fonction polynomiale, nous devons créer de nouveaux axes. Dans l'[[Plot_Workbench/fr|atelier Plot]], les nouveaux axes sont automatiquement sélectionnés comme axes actifs et les nouveaux tracés seront associés à ces axes.
<syntaxhighlight>
Plot.addNewAxes()
Plot.plot(t,s,r"$\sin\left( 2 \pi t \right)$")
Plot.plot(t,c,r"$\cos\left( 2 \pi t \right)$")
</syntaxhighlight>
Comme vous pouvez le voir '''Plot''' est devenu fou, avec axes qui pointes, et, qui s'empiètent, courbes de même couleur, etc.. .


{{Code|code=
Maintenant nous avons besoin d'utiliser '''[[Plot_Module/fr|FreeCAD Plot module]]''', avec la complexité de ce graphique.
Plot.addNewAxes()
Plot.plot(x,y,r"$x^2$")
}}


Comme vous pouvez le constater, votre graphique est devenu fou, avec des repères d'axes qui se chevauchent, des courbes de la même couleur, etc. Nous devons maintenant utiliser l'[[Plot_Workbench/fr|atelier Plot]] pour corriger ce graphique.

<span id="Configuring_plot"></span>
==Configurer Plot==
==Configurer Plot==


<span id="Configuring_axes"></span>
===Configurer les axes===
===Configurer les axes===


La fonction [[Plot_Module/fr|FreeCAD Plot module]] fournit un outil, pour modifier les propriétés de chacun des axes.
L'[[Plot_Workbench/fr|atelier Plot]] fournit un outil permettant de modifier les propriétés des axes.


[[Image:Plot_Axes.png‎|center|Axes configuration tool icon]]
[[Image:Plot_Axes.svg‎]]
{{Caption|Icône de l'outil de configuration des axes}}
<center><span style="font-variant:small-caps">Axes configuration tool icon.</span></center>


Avec l'outil [[Plot_Axes/fr|axes]], vous pouvez ajouter ou supprimer des axes, et définir les axes actifs, qui seront ensuite utilisés si vous tracer d'autres données.
La première chose que vous trouverez dans l'outil, {{KEY|[[Image:Plot_Axes.png|16px|text-top=Ajouter, effacer ou éditer les axes Plot|link=Plot_Axes/fr]] [[Plot_Axes/fr|Plot_Axes]]}}, est le sélecteur d'axes actif.
Pour l'instant, nous allons travailler sur l'ensemble des axes 1, la dernière chose que nous générons


Pour modifier la taille du premier ensemble d'axes, associé aux fonctions trigonométriques, il faut d'abord l'activer en faisant passer les axes actifs de 1 à 0. Nous pouvons ensuite déplacer les curseurs de dimension horizontale et verticale pour réduire sa taille (essayez d'imiter l'exemple). Nous devons également modifier l'alignement des axes : sélectionnez respectivement haut et droite.
Puisque les axes actifs sont les derniers, les axes actifs sont placés en premier.


<span id="Configuring_series"></span>
L'outil axes, comme l'outil {{KEY|[[Image:Plot_Labels.png|16px|text-top=Éditer les labels|link=Plot_Labels/fr]] [[Plot_Labels/fr|Plot_Labels]]}}, permettent de définir les axes actifs, et, permettent de tracer plus de données dans l'axe que vous souhaitez (y compris ajouter/supprimer des axes). Pour l'instant, nous allons travailler sur les axes sélectionnés, et, qui sont associés aux fonctions trigonométriques.
===Configurer les séries===


Définissez les propriétés de la série comme nous l'avons fait dans le [[Plot_Basic_tutorial/fr|tutoriel précédent]].
In the dimensions sliders, we will move left horizontal and bottom vertical sliders (try to emulate example) in order to reduce axes size. Then we can set the axes alignement, changing it to top and right, and setting and small offset of two units.


<span id="Showing_grid_and_legend"></span>
===Configuring series===
===Affichage de la grille et de la légende===
Set series properties as we did in [[Plot_Basic_tutorial|previous tutorial]].


La [[Plot_Grid/fr|grille]] et la [[Plot_Legend/fr|légende]] peuvent être affichées, et masquées, avec les outils déjà décrits dans le [[Plot_Basic_tutorial/fr|tutoriel précédent]] mais dans ce cas le comportement est un peu différent car il y a deux ensembles d'axes.
===Showing grid and legend===
Grid and legend is shown and hide with the same tools that used in [[Plot_Basic_tutorial|previous tutorial]], but in this case the behaviour is a little bit different due to the presence of two different axes.


Les lignes de la grille sont ajoutées à l'ensemble des axes actifs. Pour ajouter des lignes au deuxième ensemble d'axes dans notre exemple, il faut d'abord l'activer en faisant passer les axes actifs de 0 à 1 dans l'outil [[Plot_Axes/fr|axes]].
Regarding grid lines, you can show lines for each axes set, for example, if you try to show grid now you will show only the grid of the trigonometrical functions, so in order to show the grid of polynomial function plot you needs to change active axes to 0 (using axes configuration tool) before using grid tool another time (Is possible that you need to press two times the tool).


Comme déjà mentionné, la légende sera positionnée par rapport aux derniers axes définis. Si vous montrez la légende maintenant, vous verrez qu'elle est vraiment mal placée mais nous corrigerons cela plus tard.
Regarding legend, the legend will be the same for both axes, so you can choose the axes that you want in order to show the legend, but is strongly recommended to use the biggest ones (0 in this example) because position will be refered to this axes coordinates. If you show the legend you can see that is really bad placed, we will fix this problem later.


<span id="Setting_axes_labels"></span>
===Setting axes labels===
===Définir les étiquettes des axes===
You can set axes labels with same tool used in [[Plot_Basic_tutorial|previous tutorial]], with the difference that now you have more axes. Since axes labels is ussually set as one per axis, is not a significant difference, but [[Plot_Module|FreeCAD Plot module]] allow you to set a title by axes too. In this case we only wants to set title to main axes, so set:

Lorsqu'il s'agit de définir les [[Plot_Labels/fr|étiquettes]] des axes, nous devons à nouveau composer avec nos deux ensembles d'axes. Mais comme les étiquettes sont généralement définies pour tous les axes, la procédure est la même que celle décrite dans le [[Plot_Basic_tutorial/fr|tutoriel précédent]]. L'[[Plot_Workbench/fr|atelier Plot]] vous permet de définir un titre par ensemble d'axes. Dans ce cas, nous voulons seulement définir un titre pour le dernier ensemble d'axes, le plus grand.


'''Axes 0:'''
'''Axes 0:'''
* Title = Multiaxes example
* X Label = $x$
* Y Label = $\mathrm{f} \left( x \right)$
'''Axes 1:'''
* X Label = $t$
* X Label = $t$
* Y Label = $\mathrm{f} \left( t \right)$
* Y Label = $\mathrm{f} \left( t \right)$
'''Axes 1:'''
* Title = Exemple multiaxes
* X Label = $x$
* Y Label = $\mathrm{f} \left( x \right)$


Modifiez la taille de la police de toutes les étiquettes à 20, et celle du titre à 24. Encore une fois, il y a un élément, le titre, qui est mal placé.
Set also 20 to fontsize for all but title, that uses a fontsize of 24. As happens with legend, title is bad placed, interseting with second axes set, so we need to solve both problems.


<span id="Setting_elements_position"></span>
===Setting elements position===
===Définir la position des éléments===
[[Plot_Module|FreeCAD Plot module]] provides a tool in order to set the position of several plot elements, as titles, labels or legend.


L'[[Plot_Workbench/fr|atelier Plot]] fournit un outil permettant de modifier la position de plusieurs éléments de tracé, tels que les titres, les étiquettes et les légendes.
[[Image:Plot_Positions.png‎|center|Position editor icon]]
<center><span style="font-variant:small-caps">Position editor icon.</span></center>


[[Image:Plot_Positions.svg]]
When you run the tool you see a list with all the editable elements. Title elements, as well as legend, can be moved in both directions, since axes labels can be moved only on the axes direction. Select title of axes 0 and move it to (0.24,1.01), then select legend and move it to a better position. You can increase legend labels fontsize too.
{{Caption|Icône de l'éditeur de position}}


Lorsque vous exécutez l'outil, vous verrez une liste de tous les éléments modifiables. Les titres et les légendes peuvent être déplacés dans les deux sens, mais les étiquettes d'axe ne peuvent être déplacées que le long de l'axe auquel elles appartiennent. Sélectionnez le titre de l'axe 1 et déplacez-le vers (0,24,1,01), puis sélectionnez la légende et déplacez-la vers une meilleure position. Vous pouvez également augmenter la taille de la police des étiquettes de la légende.
==Saving plot==
Now you can save your work. See [[Plot_Basic_tutorial|previous tutorial]] if you don't remeber how to do it.


<span id="Saving_plot"></span>
[[Category:Tutorials]]
==Sauvegarder un fichier Plot==


Vous pouvez maintenant enregistrer votre travail. Voir le [[Plot_Basic_tutorial/fr|tutoriel précédent]] si vous ne savez pas comment faire.



{{clear}}
{{Plot_Tools_navi{{#translation:}}}}
<languages/>
{{Userdocnavi{{#translation:}}}}
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Latest revision as of 12:59, 14 April 2023

Tutoriel
Thème
Atelier Plot
Niveau
Intermediaire
Temps d'exécution estimé
Auteurs
Version de FreeCAD
0.19
Fichiers exemples
Voir aussi
None

Veuillez effectuer le tutoriel de base avant de commencer avec ce tutoriel. Dans ce didacticiel, nous allons apprendre à créer et à modifier un tracé multiaxes. Vous pouvez en savoir plus sur l'Atelier Plot ici.

Exemple de tracé multiaxe

Dans l'image, vous pouvez voir le résultat que nous obtiendrons approximativement. En suivant ce tutoriel, vous apprendrez :

  • Comment créer un graphe multi-axes à partir de la console Python.
  • Comment éditer les propriétés des axes.
  • Comment contrôler la grille et la légende lorsque plusieurs ensembles d'axes sont présents.
  • Comment éditer la position des étiquettes, titres et légendes.

Traçage des données

Comme nous l'avons fait dans le tutoriel précédent, nous allons utiliser la console Python ou des macros pour tracer les données, mais dans ce cas, nous allons tracer les données en utilisant deux ensembles d'axes.

Création de données de tracé

Dans cet exemple, nous allons tracer 3 fonctions, les deux utilisées dans le tutoriel précédent et une nouvelle fonction polynomiale. L'étendue de la fonction polynomiale est différente des autres fonctions, donc de nouveaux axes sont nécessaires. Les commandes suivantes vont créer les tableaux de données pour nous :

import math
p = range(0,1001)
x = [2.0*xx/1000.0 for xx in p]
y = [xx**2.0 for xx in x]
t = [tt/1000.0 for tt in p]
s = [math.sin(math.pi*2.0*tt) for tt in t]
c = [math.cos(math.pi*2.0*tt) for tt in t]

Comme x se déplace de 0 à 2, la fonction y a une valeur maximale de 4, donc si nous essayons de tracer cette fonction avec les fonctions trigonométriques, au moins une fonction sera tronquée ou mal mise à l'échelle, donc nous avons besoin d'un tracé multi-axes. Un tracé multiaxe dans FreeCAD est destiné à obtenir un tracé avec plusieurs axes, et non à obtenir plusieurs tracés dans le même document.

Fonctions de dessin, ajout de nouveaux axes

Nous allons tracer les fonctions trigonométriques en utilisant les axes principaux. Si tous vos axes ont la même taille, il n'est pas important de savoir quelle fonction est tracée en premier. Mais si ce n'est pas le cas, la fonction qui utilise les plus grands axes, dans notre cas la fonction polynomiale, doit être tracée en dernier. La légende sera attachée au dernier système d'axes et il est plus pratique que ce soit le plus grand. Pour tracer les fonctions trigonométriques, il suffit de lancer quelques commandes.

try:
    from FreeCAD.Plot import Plot
except ImportError:
    from freecad.plot import Plot

Plot.plot(t,s,r"$\sin\left( 2 \pi t \right)$")
Plot.plot(t,c,r"$\cos\left( 2 \pi t \right)$")

Dans cet exemple, nous transmettons directement les étiquettes des séries pour la légende. Notez que les chaînes d'étiquettes ont le préfixe r afin d'empêcher Python d'essayer d'interpréter des caractères spéciaux (le symbole \ est fréquemment utilisé dans la syntaxe LaTeX).

Avant de pouvoir tracer la fonction polynomiale, nous devons créer de nouveaux axes. Dans l'atelier Plot, les nouveaux axes sont automatiquement sélectionnés comme axes actifs et les nouveaux tracés seront associés à ces axes.

Plot.addNewAxes()
Plot.plot(x,y,r"$x^2$")

Comme vous pouvez le constater, votre graphique est devenu fou, avec des repères d'axes qui se chevauchent, des courbes de la même couleur, etc. Nous devons maintenant utiliser l'atelier Plot pour corriger ce graphique.

Configurer Plot

Configurer les axes

L'atelier Plot fournit un outil permettant de modifier les propriétés des axes.

Icône de l'outil de configuration des axes

Avec l'outil axes, vous pouvez ajouter ou supprimer des axes, et définir les axes actifs, qui seront ensuite utilisés si vous tracer d'autres données.

Pour modifier la taille du premier ensemble d'axes, associé aux fonctions trigonométriques, il faut d'abord l'activer en faisant passer les axes actifs de 1 à 0. Nous pouvons ensuite déplacer les curseurs de dimension horizontale et verticale pour réduire sa taille (essayez d'imiter l'exemple). Nous devons également modifier l'alignement des axes : sélectionnez respectivement haut et droite.

Configurer les séries

Définissez les propriétés de la série comme nous l'avons fait dans le tutoriel précédent.

Affichage de la grille et de la légende

La grille et la légende peuvent être affichées, et masquées, avec les outils déjà décrits dans le tutoriel précédent mais dans ce cas le comportement est un peu différent car il y a deux ensembles d'axes.

Les lignes de la grille sont ajoutées à l'ensemble des axes actifs. Pour ajouter des lignes au deuxième ensemble d'axes dans notre exemple, il faut d'abord l'activer en faisant passer les axes actifs de 0 à 1 dans l'outil axes.

Comme déjà mentionné, la légende sera positionnée par rapport aux derniers axes définis. Si vous montrez la légende maintenant, vous verrez qu'elle est vraiment mal placée mais nous corrigerons cela plus tard.

Définir les étiquettes des axes

Lorsqu'il s'agit de définir les étiquettes des axes, nous devons à nouveau composer avec nos deux ensembles d'axes. Mais comme les étiquettes sont généralement définies pour tous les axes, la procédure est la même que celle décrite dans le tutoriel précédent. L'atelier Plot vous permet de définir un titre par ensemble d'axes. Dans ce cas, nous voulons seulement définir un titre pour le dernier ensemble d'axes, le plus grand.

Axes 0:

  • X Label = $t$
  • Y Label = $\mathrm{f} \left( t \right)$

Axes 1:

  • Title = Exemple multiaxes
  • X Label = $x$
  • Y Label = $\mathrm{f} \left( x \right)$

Modifiez la taille de la police de toutes les étiquettes à 20, et celle du titre à 24. Encore une fois, il y a un élément, le titre, qui est mal placé.

Définir la position des éléments

L'atelier Plot fournit un outil permettant de modifier la position de plusieurs éléments de tracé, tels que les titres, les étiquettes et les légendes.

Icône de l'éditeur de position

Lorsque vous exécutez l'outil, vous verrez une liste de tous les éléments modifiables. Les titres et les légendes peuvent être déplacés dans les deux sens, mais les étiquettes d'axe ne peuvent être déplacées que le long de l'axe auquel elles appartiennent. Sélectionnez le titre de l'axe 1 et déplacez-le vers (0,24,1,01), puis sélectionnez la légende et déplacez-la vers une meilleure position. Vous pouvez également augmenter la taille de la police des étiquettes de la légende.

Sauvegarder un fichier Plot

Vous pouvez maintenant enregistrer votre travail. Voir le tutoriel précédent si vous ne savez pas comment faire.