Ambiente Plot

From FreeCAD Documentation
Revision as of 02:17, 31 August 2021 by FuzzyBot (talk | contribs) (Updating to match new version of source page)
L'icona dell'ambiente Plot

Introduzione

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 typing

from freecad.plot import Plot

From FreeCAD 0.20 on plot module is already packaged within 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.

Strumenti

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:


  • Salva grafico: consente di salvare il grafico in diversi formati. È possibile selezionare il formato di output e anche la risoluzione.
  • Assi: aggiunge, rimuove o modifica gli assi del grafico.
  • Serie: modifica il titolo e lo stile della serie.
  • Griglia: mostra o nasconde la griglia.
  • Legenda: mostra o nasconde la legenda.
  • Etichette: edita le etichette.
  • Posizioni: posiziona i vari elementi, come le etichette o la legenda.

Script

Poiché il modulo Grafico è costruito su matplotlib, si è liberi di utilizzare tutti i comandi matplotlib per le istanze del grafico. Consultare la sezione esempi di script per vedere degli esempi.

Tutorial