Módulo Plot

From FreeCAD Documentation
This page is a translated version of the page Plot Workbench and the translation is 20% complete.
Outdated translations are marked like this.
Plot workbench icon

Introdução

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.

Module

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.

Ferramentas

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:

  • Salvar gráfico: Salva o gráfico em vários formatos. Você pode selecionar o tamanho de saída, assim também como a resolução.
  • Eixos: Adiciona, remove ou edita eixos do gráfico.
  • Séries: Edita o título e o estilo da série.
  • Grade: Mostra/Oculta a grade.
  • Legenda: Mostra/Oculta a legenda.
  • Rótulos: Edita rótulos.
  • Posições: Coloca as posições dos elementos.

Scripting

Scripting

Como o Plot Workbench é uma camada sobre matplotlib, você está livre para usar qualquer função desta biblioteca em instâncias de plotagem. Veja [[Scripting_and_macros/pt-br|Scripting and macros] para exemplos.

Tutorial

Tutorial