Plot Workbench/de: Difference between revisions

From FreeCAD Documentation
(Created page with "== Einleitung ==")
(Updating to match new version of source page)
 
(21 intermediate revisions by 2 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{Docnav/de
[[Image:Workbench_Plot.svg|thumb|128px|Druck Arbeitsbereichsymbol]]
|[[Path Workbench/de|Pfad Arbeitsbereich]]

|[[Points Workbench/de|Punkte Arbeitsbereich]]
{{TOCright}}
|IconL=Path-Workbench.svg

|IconR=PointsWorkbench.svg
== Einführung ==

FreeCAD is able to perform plots using the [https://matplotlib.org/ matplotlib] [[Python|Python]] library. A module is provided to this end, as an external add-on in version 0.19 and as a core component from version 0.20 on. Older versions of FreeCAD are not covered in this documentation.

The produced plots offer the standard [https://matplotlib.org/ matplotlib] tools to edit and save. On top of that, a [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench|Plot Workbench]] is provided as an external add-on offering more complete tools to edit the plot and save it. The add-on can be installed with the [[Std_AddonMgr|Add-on manager]].

==Modul==

The module can be invoked in a Python console or in a [[Macros|macro]]. The first thing you must do is importing the module. In FreeCAD 0.19 you must first install the [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench|Plot Workbench]] using the [[Std_AddonMgr|Add-on manager]], and then you can import Plot by typing:

{{Code|code=
from freecad.plot import Plot
}}
}}


Since FreeCAD 0.20 the plot module is already packaged with the program, so you don't need to install any add-on, but just type:
[[Image:Workbench_Plot.svg|64px]]


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


After that, you can plot a straight line from (0,0) to (1,2) just simply typing:
{{TOCright}}
The [[Plot Workbench|Plot Workbench]] allows the user to edit and save output plots created from other workbenches and tools.


{{Code|code=
With the Plot workbench you can edit the working area, the axes, labels, titles, line styles, and other elements of plots.
Plot.plot([0, 1], [0, 2])
}}


You can find more complex examples in the [[Plot_Basic_tutorial|Plot Basic tutorial]] and the [[Plot_MultiAxes_tutorial|Plot MultiAxes tutorial]].
The Plot workbench is an abstraction of the [https://matplotlib.org/ matplotlib] [[Python|Python]] library conveniently adapted for FreeCAD. To use the Plot functions, the version of {{incode|matplotlib}} installed in your system should match the Python version that FreeCAD uses, that is, if FreeCAD uses Python 2.7, you should have {{incode|matplotlib}} for the same version.


==Arbeitsbereichswerkzeuge==
==Tools==


If you decide to install the [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench|Plot Workbench]] using the [[Std_AddonMgr|Add-on manager]], you will have the following tools available to manage the plots created with the module:
* [[Image:Plot_Save.png|32px]] [[Plot_Save|Save plot]]: Saves the plot in several formats. You can select the output size and resolution too.

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


<div class="mw-translate-fuzzy">
==Scripting==
==Scripting==

Since Plot module is a layer over matplotlib, you are free to use all matplotlib commands over plot instances. See [[Scripting_examples/de|scripting examples]] section to see examples.
==Skripten==
</div>
Da der Plot Arbeitsbereich eine Schicht über der {{incode|matplotlib}} ist, kannst du jede Funktion aus dieser Bibliothek auf Plot Instanzen verwenden. Siehe [[Scripting_and_macros/de|Skripten und Makros]] für Beispiele.


==Tutorial==
==Tutorial==
* [[Plot Basic tutorial]]
* [[Plot MultiAxes tutorial]]


==Tutorium==
<div class="mw-translate-fuzzy">
* [[Plot Basic tutorial/de|Plot Basic tutorial/de]]
{{[[Docnav/de|docnav]]|[[Path Workbench/de|Path-Arbeitsbereich]]|[[Points Workbench/de|Points-Arbeitsbereich]]}}
* [[Plot MultiAxes tutorial/de|Plot MultiAxes tutorial/de]]
{{Plot Tools navi/de}}

{{Userdocnavi/de}}
[[Category:Workbenches/de]]
</div>


{{Plot_Tools_navi{{#translation:}}}}
{{Plot Tools navi}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
[[Category:Workbenches]]
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Latest revision as of 16:49, 25 June 2022

Druck Arbeitsbereichsymbol

Einführung

FreeCAD is able to perform plots using the matplotlib Python library. A module is provided to this end, as an external add-on in version 0.19 and as a core component from version 0.20 on. Older versions of FreeCAD are not covered in this documentation.

The produced plots offer the standard matplotlib tools to edit and save. On top of that, a Plot Workbench is provided as an external add-on offering more complete tools to edit the plot and save it. The add-on can be installed with the Add-on manager.

Modul

The module can be invoked in a Python console or in a macro. The first thing you must do is importing the module. In FreeCAD 0.19 you must first install the Plot Workbench using the Add-on manager, and then you can import Plot by typing:

from freecad.plot import Plot

Since FreeCAD 0.20 the plot module is already packaged with the program, so you don't need to install any add-on, but just type:

from FreeCAD.Plot import Plot

After that, you can plot a straight line from (0,0) to (1,2) just simply typing:

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

You can find more complex examples in the Plot Basic tutorial and the Plot MultiAxes tutorial.

Arbeitsbereichswerkzeuge

If you decide to install the Plot Workbench using the Add-on manager, you will have the following tools available to manage the plots created with the module:

  • Save plot: Saves the plot in several formats. You can select the output size and resolution too.
  • Axes: Add, remove or edit plot axes.
  • Series: Edit series title and styling.
  • Grid: Show/hide grid.
  • Legend: Show/hide legend.
  • Labels: Edit labels.
  • Positions: Set elements positions.

Scripting

Skripten

Da der Plot Arbeitsbereich eine Schicht über der matplotlib ist, kannst du jede Funktion aus dieser Bibliothek auf Plot Instanzen verwenden. Siehe Skripten und Makros für Beispiele.

Tutorial

Tutorium