Plot Workbench/fr: Difference between revisions

From FreeCAD Documentation
(Created page with "==Outils==")
No edit summary
 
(75 intermediate revisions by 6 users not shown)
Line 1: Line 1:
<languages/>
The Plot module allows to edit and save output plots created from other modules and tools. With plot module you can edit easily the working area, the axes, labels, titles, styles, etc. Plot module is an abstraction of matplotlib conveniently addapted to FreeCAD.


[[Image:Workbench_Plot.svg|thumb|128px|Icône de l'atelier Plot]]
==Outils==


{{TOCright}}
These are tools availables.
* [[Image:Plot_Save.png]] [[Plot_Save|Save plot]]: Saves the plot in several formats. You can select the output size and resolution too.
* [[Image:Plot_Axes.png]] [[Plot_Axes|Axes]]: Add, remove or edit plot axes.
* [[Image:Plot_Series.png]] [[Plot_Series|Series]]: Edit series title and styling.
* [[Image:Plot_Grid.png]] [[Plot_Grid|Grid]]: Show/hide grid.
* [[Image:Plot_Legend.png]] [[Plot_Legend|Legend]]: Show/hide legend.
* [[Image:Plot_Labels.png]] [[Plot_Labels|Labels]]: Edit labels.
* [[Image:Plot_Positions.png]] [[Plot_Positions|Positions]]: Set elements positions.


==Scripting==
== Introduction ==
Since Plot module is a layer over matplotlib, you are free to use all matplotlib commands over plot instances. See [[Scripting_examples|scripting examples]] section to see examples.


FreeCAD est capable d'effectuer des tracés en utilisant la bibliothèque [https://matplotlib.org/ matplotlib] de [[Python/fr|Python]]. Un module est fourni à cette fin, en tant qu'extension externe dans la version 0.19 et en tant que composant principal à partir de la version 0.20. Les anciennes versions de FreeCAD ne sont pas couvertes par cette documentation.
==Tutorial==
* [[Plot Basic tutorial]]
* [[Plot MultiAxes tutorial]]


Les graphiques produits offrent les outils standard [https://matplotlib.org/ matplotlib] pour l'édition et la sauvegarde. En plus de cela, un [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench/fr|atelier Plot]] est fourni en tant qu'extension externe offrant des outils plus complets pour modifier le tracé et le sauvegarder. L'extension peut être installée avec le [[Std_AddonMgr/fr|Gestionnaire des extensions]].
{{Docnav| | }}


==Module==
[[Category:User Documentation]]


Le module peut être lancé dans une console Python ou dans une [[Macros/fr|macro]]. La première chose que vous devez faire est d'importer le module. Dans FreeCAD 0.19 vous devez d'abord installer l'[[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench/fr|atelier Plot]] à l'aide du [[Std_AddonMgr/fr|Gestionnaire des extensions]] et ensuite vous pouvez importer Plot en écrivant :
{{clear}}

<languages/>
{{Code|code=
from freecad.plot import Plot
}}

Depuis FreeCAD 0.20, le module de traçage est déjà inclus dans le programme, vous n'avez donc pas besoin d'installer de module complémentaire, mais simplement de taper :

{{Code|code=
from FreeCAD.Plot import Plot
}}

Après cela, vous pouvez tracer une ligne droite de (0,0) à (1,2) en tapant tout simplement :

{{Code|code=
Plot.plot([0, 1], [0, 2])
}}

Vous pouvez trouver des exemples plus complexes dans le [[Plot_Basic_tutorial/fr|Tutoriel de base]] et le [[Plot_MultiAxes_tutorial/fr|Tutoriel graphique à plusieurs axes]].

==Outils de l'atelier==

Si vous décidez d'installer le module [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench/fr|atelier Plot]] en utilisant le [[Std_AddonMgr/fr|Gestionnaire des extensions]], vous disposerez des outils suivants pour gérer les tracés créés avec le module :

* [[Image:Plot_Save.svg|32px]] [[Plot_Save/fr|Sauvegarde]] : Enregistrer sous plusieurs formats. Vous pouvez sélectionner la taille de sortie et la résolution.
* [[Image:Plot_Axes.svg|32px]] [[Plot_Axes/fr|Axes]] : Ajouter, effacer ou éditer les axes du graphique.
* [[Image:Plot_Series.svg|32px]] [[Plot_Series/fr|Séries]] : Editer les séries titres et style.
* [[Image:Plot_Grid.svg|32px]] [[Plot_Grid/fr|Grille]] : Afficher/Cacher la grille.
* [[Image:Plot_Legend.svg|32px]] [[Plot_Legend/fr|Légende]] : Afficher/Cacher les légendes.
* [[Image:Plot_Labels.svg|32px]] [[Plot_Labels/fr|Etiquettes]] : Éditer les étiquettes.
* [[Image:Plot_Positions.svg|32px]] [[Plot_Positions/fr|Positions]] : Ensemble des éléments de positions.

==Script==

Puisque l'atelier Plot est une couche sur {{incode|matplotlib}}, vous êtes libre d'utiliser toutes les commandes de la librairie matplotlib.
Voir [[Scripting_and_macros/fr|exemples de scripts]] pour des exemples.

==Tutoriels==

*[[Plot_Basic_tutorial/fr|Plot Tutoriel de base]]
*[[Plot_MultiAxes_tutorial/fr|Plot Tutoriel graphique à plusieurs axes]].


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

Latest revision as of 14:32, 27 November 2022

Icône de l'atelier Plot

Introduction

FreeCAD est capable d'effectuer des tracés en utilisant la bibliothèque matplotlib de Python. Un module est fourni à cette fin, en tant qu'extension externe dans la version 0.19 et en tant que composant principal à partir de la version 0.20. Les anciennes versions de FreeCAD ne sont pas couvertes par cette documentation.

Les graphiques produits offrent les outils standard matplotlib pour l'édition et la sauvegarde. En plus de cela, un atelier Plot est fourni en tant qu'extension externe offrant des outils plus complets pour modifier le tracé et le sauvegarder. L'extension peut être installée avec le Gestionnaire des extensions.

Module

Le module peut être lancé dans une console Python ou dans une macro. La première chose que vous devez faire est d'importer le module. Dans FreeCAD 0.19 vous devez d'abord installer l' atelier Plot à l'aide du Gestionnaire des extensions et ensuite vous pouvez importer Plot en écrivant :

from freecad.plot import Plot

Depuis FreeCAD 0.20, le module de traçage est déjà inclus dans le programme, vous n'avez donc pas besoin d'installer de module complémentaire, mais simplement de taper :

from FreeCAD.Plot import Plot

Après cela, vous pouvez tracer une ligne droite de (0,0) à (1,2) en tapant tout simplement :

Plot.plot([0, 1], [0, 2])

Vous pouvez trouver des exemples plus complexes dans le Tutoriel de base et le Tutoriel graphique à plusieurs axes.

Outils de l'atelier

Si vous décidez d'installer le module atelier Plot en utilisant le Gestionnaire des extensions, vous disposerez des outils suivants pour gérer les tracés créés avec le module :

  • Sauvegarde : Enregistrer sous plusieurs formats. Vous pouvez sélectionner la taille de sortie et la résolution.
  • Axes : Ajouter, effacer ou éditer les axes du graphique.
  • Séries : Editer les séries titres et style.
  • Grille : Afficher/Cacher la grille.
  • Légende : Afficher/Cacher les légendes.
  • Etiquettes : Éditer les étiquettes.
  • Positions : Ensemble des éléments de positions.

Script

Puisque l'atelier Plot est une couche sur matplotlib, vous êtes libre d'utiliser toutes les commandes de la librairie matplotlib. Voir exemples de scripts pour des exemples.

Tutoriels