Plot Basic tutorial/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "{{Plot Tools navi/fr}} {{Userdocnavi/fr}}")
(Updating to match new version of source page)
 
(59 intermediate revisions by 3 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{TutorialInfo/fr
{{TutorialInfo/fr
|Topic=Tutoriel de base de l'atelier Plot
|Topic=Plot Workbench
|Level=Beginner
|Level=Débutant
|Time=
|Time=
|Author=
|Author=
|FCVersion=
|FCVersion=0.19
|Files=
|Files=
}}
}}


Dans ce tutoriel, nous allons apprendre, comment effectuer une approche de base, à l'aide du module '''Plot''', et, de la console Python. Vous en apprendrez plus ici, sur le '''[[Plot_Module/fr|module Plot]]'''.
Dans ce tutoriel, nous allons apprendre à créer un tracé de base à l'aide de l'[[Plot Workbench/fr|atelier Plot]] et de la [[Python console/fr|console Python]].


[[Image:Plot_Trigonometric_Example.png|600px|center|Basic plot example]]
[[Image:Plot_Trigonometric_Example.png|600px]]
{{Caption|Exemple de tracé de base}}
<center><span style="font-variant:small-caps">Basic plot example.</span></center>


Dans l'image précédente, vous pouvez voir à peux près le résultat que l'on obtiendra.
Dans l'image, vous pouvez voir le résultat que nous obtiendrons approximativement. En suivant ce tutoriel, vous apprendrez :
* Comment créer un Plot à partir de la [[Python_console/fr|console Python]].
* Comment tracer des données à partir de la [[Python_console/fr|console Python]].
* Comment afficher la [[Image:Plot_Grid.svg|24px]] [[Plot_Grid/fr|Plot Grille]].
* Comment afficher la [[Image:Plot_Legend.svg|24px]] [[Plot_Legend/fr|Plot Légende]].
* Comment éditer les [[Image:Plot_Series.svg|24px]] [[Plot_Series/fr|Plot Séries]] en introduisant le texte dans [http://www.latex-project.org LaTeX].
* Comment éditer les [[Image:Plot_Labels.svg|24px]] [[Plot_Labels/fr|Plot Etiquettes]] en introduisant le texte dans [http://www.latex-project.org LaTeX].
* Comment éditer les styles des séries.
* Comment sauvegarder votre tracé.


<span id="Plotting_data"></span>
À la suite de ce tutoriel, vous apprendrez à connaître :
==Traçage des données==


Pour tracer les données, vous n'avez pas besoin de créer un nouveau document FreeCAD, allez dans la [[Python_console/fr|console Python]] et entrez les commandes ou utilisez les [[Macros/fr|macros]].
* La création d'un '''Plot''' à partir de la Console Python.
* Comment tracer certaines données avec la Console Python.
* Comment faire pour afficher les lignes de la grille.
* Comment faire pour afficher les légendes.
* Comment faire pour modifier les étiquettes de '''Series''', introduire le texte dans [http://www.latex-project.org LaTeX].
* Comment faire pour modifier les étiquettes des axes, introduire le texte dans [http://www.latex-project.org LaTeX].
* Comment faire pour modifier les styles de '''Series'''.
* Comment enregistrer votre résultat '''Plot'''.

==Créer les données Plot==

Pour tracer les données, vous n'avez pas besoin de créer un nouveau document FreeCAD, il faut simplement aller dans la console '''Python''', et, entrer les commandes, ou utilisez les [[Macros/fr|macros]].


<span id="Creating_plot_document"></span>
===Création d'un document Plot===
===Création d'un document Plot===


Les documents '''Plot''', sont des documents spéciaux, qui peuvent être créés manuellement, pour y ajouter des données, ou le module peut en crée un automatiquement, lorsque vous démarrez le traçage de données.
Les tracés sont des documents spéciaux qui peuvent être créés manuellement afin d'ajouter des données ultérieurement ou l'atelier peut en créer un automatiquement lorsque vous commencez à tracer des données. La création de votre propre document de tracé présente deux avantages :
* Vous pouvez définir le libellé de la fenêtre du document.
* Vous pouvez contrôler le document dans lequel vous tracer vos données.


Pour créer un nouveau document de tracé, il suffit de lancer les commandes suivantes :
Créer votre propre document '''Plot''', a 2 avantages :


{{Code|code=
* Vous pouvez définir l'étiquette de la fenêtre du document.
try:
* Vous pouvez contrôler facilement le document dont vous ajoutez vos données.
from FreeCAD.Plot import Plot
except ImportError:
from freecad.plot import Plot


Afin de créer nouveau document '''Plot''', lancez simplement ces commandes :

{{Code|code=
import Plot
Plot.figure("TrigonometricTest")
Plot.figure("TrigonometricTest")
}}
}}


Dans FreeCAD version 0.19 il est nécessaire d'installer l'[[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench/fr|atelier Plot]] avec le [[Std_AddonMgr/fr|Gestionnaire des extensions]], alors qu'à partir de la version 0.20 de FreeCAD, l'extension externe n'est plus nécessaire pour réaliser des tracés. Les commandes ci-dessus vont créer un nouvel onglet dans la [[Main_view_area/fr|Zone de vue principale]] appelé '''TrigonometricTest'''. Le document nouvellement créé possède déjà un ensemble d'axes. Chaque document de tracé possède au moins un jeu d'axes.
Cela va créer un nouvel onglet sur la fenêtre principale, appelée '''TrigonometricTest '''.
Le nouveau document créé, a déjà un ensemble d'axes. Chaque document '''Plot''' a au moins un jeu d'axes, qui peut être supprimé, sans utiliser pleinement '''matplotlib'''.


<span id="Drawing_functions"></span>
===Fonctions de dessin===
===Fonctions de dessin===


Vous pouvez également commencer à travailler à partir d'ici car, comme nous l'avons déjà expliqué, la commande plot créera un nouveau document si nécessaire. La chose suivante à faire est de créer les données pour les fonctions sinus et cosinus que nous voulons tracer :
Vous pouvez commencer le travail, toutes commandes '''Plot''', démarrent un nouveau document, mais toutes les commandes '''Plot''', que vous exécuterez, ajouterons une '''Series''' de tracés, tant que vous ne créez pas un nouveau document. Donc pratiquement, il est préférable de conserver les documents '''Plot''' ouverts.

La première chose que nous devons faire, est de créer les données pour les fonctions '''sinus''', et, '''cosinus''', que nous voulons tracer :


{{Code|code=
{{Code|code=
Line 66: Line 65:
Ceci va créer 3 tableaux de données (avec 101 points) :
Ceci va créer 3 tableaux de données (avec 101 points) :


* '''t''' = '''Temps en secondes'''.
* ''t'' = Temps en secondes.
* '''s''' = fonction '''Sinus'''.
* ''s'' = fonction Sinus.
* '''c''' = fonction '''Cosinus'''.
* ''c'' = fonction Cosinus.


Afin de tracer les deux fonctions, il suffit de lancer les commandes suivantes :
Afin de tracer les deux fonctions, il suffit de lancer les commandes suivantes :
Line 77: Line 76:
}}
}}


Ces commandes vont tracer nos fonctions. La commande '''Plot''' permet d'utiliser une '''Series''' d'étiquettes, comme arguments, mais ultérieurement, nous allons modifier les données à l'aide du module '''Plot''', donc, nous ne transmettrons pas encore ces données.
La commande '''plot''' permet d'utiliser l'étiquette de la série comme argument, mais comme nous la modifierons plus tard à l'aide des outils de l'atelier Plot, nous ne transmettons pas encore cette donnée.


<span id="Configuring_plot"></span>
==Configurez '''Plot'''==
==Configurez Plot==


<span id="Showing_grid_and_legend"></span>
===Afficher la grille, et, les légendes===
===Affichage de la grille et de la légende===


Changez l'atelier de FreeCAD en l'[[Plot_Workbench/fr|atelier Plot]] avec {{MenuCommand|Affichage → Atelier → Plot}}. (vous devez d'abord installer l'extension avec le [[Std_AddonMgr/fr|Gestionnaire des extensions]]). Une fois l'atelier chargé, utilisez l'outil [[Plot_Grid/fr|grille]] pour afficher la grille.
Pour modifier l'outil '''[[Plot_Module/fr|module Plot]]''' de FreeCAD, allez dans le menu '''Affichage -> Workbench'''. Lorsque vous avez activé, le module '''Plot''' utilisez l'outil '''Grid''' afin de l'afficher.


[[Image:Plot_Grid.png‎|center|Show/hide grid tool icon]]
[[Image:Plot_Grid.svg‎]]
{{Caption|Afficher/masquer l'icône de l'outil de grille}}
<center><span style="font-variant:small-caps">Show/hide grid tool icon.</span></center>


Vous pouvez répéter l'action pour le cacher. Vous pouvez également afficher la légende avec l'outil fourni.
Vous pouvez répéter l'action pour masquer la grille. Utilisez l'outil [[Plot_Legend/fr|Légende]] pour afficher ou masquer la légende.


[[Image:Plot_Legend.png‎|center|Show/hide legend tool icon]]
[[Image:Plot_Legend.svg]]
{{Caption|Afficher/masquer l'icône de l'outil de légende}}
<center><span style="font-variant:small-caps">Show/hide legend tool icon.</span></center>


Comme vous pouvez le voir, la légende est vide, parce que nous n'avons pas mis d'étiquette à la '''Series'''. La '''Series''' [[Plot_Module|module Plot]] sans étiquette, n'est pas représentée dans la légende, afin de permettre de dessiner une ligne auxiliaire.
Comme vous pouvez le voir, la légende est très petite et vide car nous n'avons pas encore défini d'étiquette de série. Dans l'[[Plot_Workbench/fr|atelier Plot]], les séries sans étiquette ne sont pas affichées dans la légende.


<span id="Setting_series_label"></span>
===Définir les étiquettes des '''Series'''===
===Définir l'étiquette de la série===


Avec l'outil '''Series''', vous pouvez modifier certains paramètres de la '''Series'''.
Avec l'outil [[Plot_Series/fr|Séries]], vous pouvez modifier les paramètres de chaque série.


[[Image:Plot_Series.png‎|center|Series configuration tool icon]]
[[Image:Plot_Series.svg‎]]
{{Caption|Icône de l'outil de configuration de la série}}
<center><span style="font-variant:small-caps">Series configuration tool icon.</span></center>


Tout d'abord, pour toutes les lignes sélectionnées que vous souhaitez modifier, pour l'exemple, nous allons commencer avec la première ligne.
Sélectionnez la série que vous voulez modifier, nous allons commencer par la première. Décochez '''No label''' et définissez cette étiquette :

Décochez la case '''No label''', et, la valeur de cette étiquette :


{{Code|code=
{{Code|code=
Line 110: Line 110:
}}
}}


Étant donné que [http://matplotlib.org/ matplotlib], prend en charge [http://www.latex-project.org LaTeX], vous pouvez définir toutes les étiquettes, ou les titres que vous voulez utiliser.
Puisque [http://matplotlib.org/ matplotlib] prend en charge [http://www.latex-project.org LaTeX], vous pouvez définir toutes les étiquettes et tous les titres en utilisant LaTeX. Définissez l'étiquette suivante pour la deuxième série :

Donnez l'étiquette suivante à la deuxième '''Series''' :


{{Code|code=
{{Code|code=
Line 118: Line 116:
}}
}}


<span id="Setting_series_style"></span>
===Définition d'un style à la '''Series'''===
===Définir le style de la série===


L'outils '''Series''', vous permet de définir un grand nombre de propriétés à la '''Series'''. Essayez de définir les propriétés affichées dans l'image exemple, modifiez les couleurs de la '''Series''', et, le style de dessin en une seconde.
Vous pouvez définir de nombreuses propriétés de la série. Essayez de définir les propriétés montrées dans l'image d'exemple, en changeant les couleurs et le style de dessin de la deuxième série.


<span id="Setting_axes_labels"></span>
===Définition des '''Labels''' des axes===
===Définir les étiquettes des axes===


Avec l'outil '''Labels''', vous pouvez définir des labels associées à tous les axes créés.
Avec l'outil [[Plot_Labels/fr|Etiquettes]], vous pouvez définir le titre et les étiquettes des axes.


[[Image:Plot_Labels.png‎|center|Labels tool icon]]
[[Image:Plot_Labels.svg‎]]
{{Caption|Icône de l'outil Étiquettes}}
<center><span style="font-variant:small-caps">Labels tool icon.</span></center>


Définir ces données :
Définir ces données :
Line 135: Line 135:
* Y Label = $y = \mathrm{f} \left( t \right)$
* Y Label = $y = \mathrm{f} \left( t \right)$


Modifiez également la taille de chacun d'eux à 20.
Modifiez également la taille de la police du titre et de toutes les étiquettes à 20.


<span id="Saving_plot"></span>
==Sauvez '''Plot'''==
==Sauvegarder le tracé==


Sauvegardes avec l'outil '''Plot''', vous pouvez enregistrer votre '''Plot''', dans un fichier image, dans plusieurs formats différents.
Avec l'outil [[Plot_Save/fr|Sauvegarde]], vous pouvez enregistrer votre tracé sous forme de fichier image dans plusieurs formats.


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


Sélectionnez d'abord le chemin et le nom du fichier de sortie.
Commencez par sélectionner le chemin du fichier de sortie. Vous pouvez utiliser la boîte de dialogue sélection fichier à l'aide de la touche à droite, de la ligne d'édition du chemin d'accès.


Vous pouvez définir la taille de l'image de sortie en pouces (inches), par exemple, nous pouvons définir '''11.7x8.3''', qui est un format '''DIN A4''', la taille d'une feuille de papier standard. La résolution de l'image, dépendra du '''DPI''' (Dots per inch ou points par pouce), par exemple avec '''100 dpi''', vous obtiendrez une image de '''1170 x 830 pixels'''.
Définissez la taille de l'image de sortie en pouces, par exemple, utilisez 11,7x8,3 pour obtenir un format '''DIN A4'''. DPI (Dots per inch) contrôlera la résolution de l'image, par exemple, utilisez 100 dpi. En combinaison avec les dimensions données, vous obtiendrez une image de 1170x830 pixels.


{{Plot Tools navi/fr}}
{{Userdocnavi/fr}}


{{Plot_Tools_navi{{#translation:}}}}
{{clear}}
{{Userdocnavi{{#translation:}}}}
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Latest revision as of 13:00, 14 April 2023

Tutoriel
Thème
Tutoriel de base de l'atelier Plot
Niveau
Débutant
Temps d'exécution estimé
Auteurs
Version de FreeCAD
0.19
Fichiers exemples
Voir aussi
None

Dans ce tutoriel, nous allons apprendre à créer un tracé de base à l'aide de l'atelier Plot et de la console Python.

Exemple de tracé de base

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

Traçage des données

Pour tracer les données, vous n'avez pas besoin de créer un nouveau document FreeCAD, allez dans la console Python et entrez les commandes ou utilisez les macros.

Création d'un document Plot

Les tracés sont des documents spéciaux qui peuvent être créés manuellement afin d'ajouter des données ultérieurement ou l'atelier peut en créer un automatiquement lorsque vous commencez à tracer des données. La création de votre propre document de tracé présente deux avantages :

  • Vous pouvez définir le libellé de la fenêtre du document.
  • Vous pouvez contrôler le document dans lequel vous tracer vos données.

Pour créer un nouveau document de tracé, il suffit de lancer les commandes suivantes :

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

Plot.figure("TrigonometricTest")

Dans FreeCAD version 0.19 il est nécessaire d'installer l' atelier Plot avec le Gestionnaire des extensions, alors qu'à partir de la version 0.20 de FreeCAD, l'extension externe n'est plus nécessaire pour réaliser des tracés. Les commandes ci-dessus vont créer un nouvel onglet dans la Zone de vue principale appelé TrigonometricTest. Le document nouvellement créé possède déjà un ensemble d'axes. Chaque document de tracé possède au moins un jeu d'axes.

Fonctions de dessin

Vous pouvez également commencer à travailler à partir d'ici car, comme nous l'avons déjà expliqué, la commande plot créera un nouveau document si nécessaire. La chose suivante à faire est de créer les données pour les fonctions sinus et cosinus que nous voulons tracer :

import math
t = range(0,101)
t = [tt/100.0 for tt in t]
s = [math.sin(2.0*math.pi*tt) for tt in t]
c = [math.cos(2.0*math.pi*tt) for tt in t]

Ceci va créer 3 tableaux de données (avec 101 points) :

  • t = Temps en secondes.
  • s = fonction Sinus.
  • c = fonction Cosinus.

Afin de tracer les deux fonctions, il suffit de lancer les commandes suivantes :

Plot.plot(t,s)
Plot.plot(t,c)

La commande plot permet d'utiliser l'étiquette de la série comme argument, mais comme nous la modifierons plus tard à l'aide des outils de l'atelier Plot, nous ne transmettons pas encore cette donnée.

Configurez Plot

Affichage de la grille et de la légende

Changez l'atelier de FreeCAD en l'atelier Plot avec Affichage → Atelier → Plot. (vous devez d'abord installer l'extension avec le Gestionnaire des extensions). Une fois l'atelier chargé, utilisez l'outil grille pour afficher la grille.

Afficher/masquer l'icône de l'outil de grille

Vous pouvez répéter l'action pour masquer la grille. Utilisez l'outil Légende pour afficher ou masquer la légende.

Afficher/masquer l'icône de l'outil de légende

Comme vous pouvez le voir, la légende est très petite et vide car nous n'avons pas encore défini d'étiquette de série. Dans l'atelier Plot, les séries sans étiquette ne sont pas affichées dans la légende.

Définir l'étiquette de la série

Avec l'outil Séries, vous pouvez modifier les paramètres de chaque série.

Icône de l'outil de configuration de la série

Sélectionnez la série que vous voulez modifier, nous allons commencer par la première. Décochez No label et définissez cette étiquette :

$y = \sin \left( 2 \pi t \right)$

Puisque matplotlib prend en charge LaTeX, vous pouvez définir toutes les étiquettes et tous les titres en utilisant LaTeX. Définissez l'étiquette suivante pour la deuxième série :

$y = \cos \left( 2 \pi t \right)$

Définir le style de la série

Vous pouvez définir de nombreuses propriétés de la série. Essayez de définir les propriétés montrées dans l'image d'exemple, en changeant les couleurs et le style de dessin de la deuxième série.

Définir les étiquettes des axes

Avec l'outil Etiquettes, vous pouvez définir le titre et les étiquettes des axes.

Icône de l'outil Étiquettes

Définir ces données :

  • Title = Trigonometric functions example
  • X Label = $t$
  • Y Label = $y = \mathrm{f} \left( t \right)$

Modifiez également la taille de la police du titre et de toutes les étiquettes à 20.

Sauvegarder le tracé

Avec l'outil Sauvegarde, vous pouvez enregistrer votre tracé sous forme de fichier image dans plusieurs formats.

Icône de l'outil de sauvegarde

Sélectionnez d'abord le chemin et le nom du fichier de sortie.

Définissez la taille de l'image de sortie en pouces, par exemple, utilisez 11,7x8,3 pour obtenir un format DIN A4. DPI (Dots per inch) contrôlera la résolution de l'image, par exemple, utilisez 100 dpi. En combinaison avec les dimensions données, vous obtiendrez une image de 1170x830 pixels.