Plot Basic tutorial/pl

W tym poradniku dowiemy się, jak wykonać podstawowy wykres przy użyciu środowiska pracy Wykres i konsoli Python.

Przykład prostego wykresu.

Na poprzednim obrazku możesz zobaczyć rezultat, jaki w przybliżeniu uzyskamy. Po tym poradniku nauczysz się:
 * Jak utworzyć wykres w konsoli Python.
 * Jak wykreślić kilka danych w konsoli Python.
 * Jak wyświetlić [[Image:Plot_Grid.svg|24px]] linie siatki.
 * Jak wyświetlić [[Image:Plot_Legend.svg|24px]] legendę.
 * Jak edytować [[Image:Plot_Series.svg|24px]] etykiety serii, wprowadzając tekst w LaTeX.
 * Jak edytować [[Image:Plot_Labels.svg|24px]] etykiety osi, wprowadzając tekst w edytorze LaTeX.
 * Jak edytować style serii.
 * Jak zapisać swój wykres.

Wykreślanie danych
Aby wykreślić dane nie musisz tworzyć nowego dokumentu FreeCAD, wystarczy, że uruchomisz konsolę Pythona i zaczniesz wysyłać komendy, lub użyjesz makrodefinicji.

Tworzenie dokumentu wykresu
Wykresy są specjalnymi dokumentami, które można utworzyć ręcznie w celu późniejszego dodania danych, lub pozwolić, aby moduł utworzył je automatycznie w momencie rozpoczęcia wykreślania danych. Tworzenie własnych dokumentów wykresów ma 2 zalety:
 * Możesz ustawić etykietę okna dokumentu.
 * Możesz łatwo kontrolować, na którym dokumencie wykreślać dane.

Aby utworzyć nowy dokument działki wystarczy uruchomić następujące komendy:

Spowoduje to utworzenie nowej zakładki w głównym oknie o nazwie TrigonometricTest. Nowo utworzony dokument posiada już zestaw osi. Każdy dokument wykresu posiada co najmniej jeden zestaw osi, które mogą być usunięte bez użycia pełnej kontroli biblioteki matplotlib.

Funkcje rysowania
Możesz zacząć pracę tutaj, ponieważ polecenie plot rozpocznie nowy dokument, ale wszystkie polecenia plot, które wykonasz będą dołączać serie do utworzonego wykresu, dopóki nie utworzysz nowego dokumentu, więc zazwyczaj lepiej jest kontrolować otwarte dokumenty wykresów. Pierwszą rzeczą jaką musimy zrobić jest utworzenie danych dla funkcji sinus i cosinus, które chcemy wykreślić:

That will create 3 arrays of data (with 101 points):
 * t = Time in seconds.
 * s = Sine function.
 * c = Cosine function.

In order to plot both function we only need to launch next commands:

That will plot our functions. plot command allows the series label as argument, but since we will edit it later using Plot module tools we don't pass this data yet.

Showing grid and legend
Change FreeCAD workbench to Plot module in View/Workbench menu. When module has been loaded use grid tool in order to show it.

Show/hide grid tool icon.

You can repeat the action in order to hide it. Also you can show the legend with the tool provided.

Show/hide legend tool icon.

As you can see, legend is empty because we have not set any series label yet. In Plot module series without label are not represented at legend, in order to allow you to draw auxiliary lines.

Setting series labels
With the series tool you can edit some series parameters.

Series configuration tool icon.

First for all select the line that you want to edit, for example we will start with the first one. Uncheck No label and set this label:

Since matplotlib supports LaTeX you can set all the labels or titles that you want using it. Set the following label to second serie:

Setting series style
Series allows you to set a lot of series properties. Try to set the properties shown at the example image, changing series colors and drawing style of the second one.

Setting axes labels
With the labels tool you can set labels associated to all created axes.

Labels tool icon.

Set this data:
 * Title = Trigonometric functions example
 * X Label = $t$
 * Y Label = $y = \mathrm{f} \left( t \right)$

Also change the size of all of them to 20.

Saving plot
With saving plot tool you can save your plot as image file in several formats.

Save tool icon.

First for all select the path of the output file. You can use file selection dialog using the button at right of the path edition line.

You can set the output image size in inches, for example we can set 11.7x8.3 that is a DIN A4 paper size. DPI (Dots per inch) will control the image resolution, for example using 100 dpi you will get an image of 1170x830 pixels.