Plot Basic tutorial/pl: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Updating to match new version of source page)
 
(89 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>

{{TutorialInfo
{{TutorialInfo/pl
|Topic=Plot Workbench Basic Tutorial
|Topic=Poradnik: Podstawy środowiska pracy Wykres
|Level=Beginner
|Level=Początkujący
|Time=
|Time=
|Author=
|Author=
|FCVersion=
|FCVersion=-
|Files=
|Files=
}}
}}


W tym poradniku dowiemy się, jak wykonać podstawowy wykres przy użyciu środowiska pracy [[Plot_Workbench/pl|Wykres]] i konsoli [[Python_console/pl|Python]].
In this tutorial we will learn how to perform a basic plot using [[Plot Workbench]] and [[Python console]].


[[Image:Plot_Trigonometric_Example.png|600px|center|Basic plot example]]
[[Image:Plot_Trigonometric_Example.png|600px]]
{{Caption|Przykład prostego wykresu}}
<center><span style="font-variant:small-caps">Basic plot example.</span></center>


Na poprzednim obrazku możesz zobaczyć rezultat, jaki w przybliżeniu uzyskamy. Po tym poradniku nauczysz się:
In previous image you can see the result that we approximately will obtain. Following this tutorial you will learn:
* How to create a Plot from [[Python Console]].
* Jak utworzyć wykres w konsoli [[Python_console/pl|Python]].
* How to plot some data from [[Python Console]].
* Jak wykreślić kilka danych w konsoli [[Python_console/pl|Python]].
* How to show the [[Image:Plot_Grid.svg|24px]] [[Plot Grid|grid lines]].
* Jak wyświetlić [[Image:Plot_Grid.svg|24px]] [[Plot_Grid/pl|linie siatki]].
* How to show the [[Image:Plot_Legend.svg|24px]] [[Plot Legend|legend]].
* Jak wyświetlić [[Image:Plot_Legend.svg|24px]] [[Plot_Legend/pl|legendę]].
* How to edit [[Image:Plot_Series.svg|24px]] [[Plot Series|series labels]], introducing text in [http://www.latex-project.org LaTeX].
* Jak edytować [[Image:Plot_Series.svg|24px]] [[Plot_Series/pl|etykiety serii]], wprowadzając tekst w [http://www.latex-project.org LaTeX].
* How to edit [[Image:Plot_Labels.svg|24px]] [[Plot Labels|axes labels]], introducing text in [http://www.latex-project.org LaTeX].
* Jak edytować [[Image:Plot_Labels.svg|24px]] [[Plot_Labels/pl|etykiety osi]], wprowadzając tekst w edytorze [http://www.latex-project.org LaTeX].
* Jak edytować style serii.
* How to edit series styles.
* Jak zapisać swój wykres.
* How to save your plot.


<span id="Plotting_data"></span>
==Plotting data==
==Wykreślanie danych==
In order to plot data you don't need to create a new FreeCAD document, simply show the Python console and start sending commands, or use [[Macros|macros]].


Aby wykreślić dane nie musisz tworzyć nowego dokumentu FreeCAD, wystarczy, że uruchomisz konsolę [[Python_console/pl|Python]] i zaczniesz wysyłać komendy, lub użyjesz [[Macros/pl|makrodefinicji]].
===Creating plot document===
Plots are special documents that can be created manually in order to add data later, or allow the module creates one automatically when you start plotting data. Create your own plot documents have 2 advantages:
* You can set the document window label.
* You can control easily on which document you plot your data.


<span id="Creating_plot_document"></span>
In order to create new plot document simply launch following commands:
===Tworzenie dokumentu wykresu===

Wykresy są specjalnymi dokumentami, które można utworzyć ręcznie w celu późniejszego dodania danych, lub pozwolić, aby środowisko pracy utworzyło je automatycznie w momencie rozpoczęcia wykreślania danych. Tworzenie własnych dokumentów wykresów ma dwie 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:


{{Code|code=
{{Code|code=
try:
import Plot
from FreeCAD.Plot import Plot
except ImportError:
from freecad.plot import Plot

Plot.figure("TrigonometricTest")
Plot.figure("TrigonometricTest")
}}
}}


W wersji FreeCAD 0.19 wymagane jest zainstalowanie środowiska pracy [[Image:Workbench_Plot.svg|24px]] [[Plot_Workbench/pl|Wykres]] za pomocą [[Std_AddonMgr/pl|Menadżera dodatków]], natomiast od wersji 0.20 FreeCAD nie wymaga już zewnętrznego dodatku do wykonywania wykresów.
That will create a new tab on main windows called '''TrigonometricTest'''. The new created document already have a set of axes. Each plot document have at least one set of axes that can be removed without using fully matplotlib control.
Powyższe polecenia utworzą nową zakładkę w [[Main_view_area/pl|głównym oknie]] o nazwie '''TrigonometricTest'''. Nowo utworzony dokument posiada już zestaw osi. Każdy dokument wykresu posiada co najmniej jeden zestaw osi.


<span id="Drawing_functions"></span>
===Drawing functions===
===Funkcje rysowania===
You can start working here due to plot command will start a new document, but all plot commands that you execute will append series to created plot until you don't create a new document, so usually is better options control the opened plot documents. First thing that we need to do is create the data for sine and cosine functions that we want to plot:

Można również rozpocząć pracę od tego miejsca, ponieważ, jak już wyjaśniono, polecenie plot utworzy w razie potrzeby nowy dokument. Następną rzeczą, którą musimy zrobić, jest utworzenie danych dla funkcji sinus i cosinus, które chcemy wykreślić:


{{Code|code=
{{Code|code=
Line 52: Line 64:
}}
}}


That will create 3 arrays of data (with 101 points):
Spowoduje to utworzenie 3 tablic danych ''(ze 101 punktami)'':
* ''t'' = Time in seconds.
* ''t'' = Czas w sekundach.
* ''s'' = Sine function.
* ''s'' = Funkcja sinus.
* ''c'' = Cosine function.
* ''c'' = funkcja cosinus.


W celu wykreślenia obu funkcji wystarczy uruchomić kolejne komendy:
In order to plot both function we only need to launch next commands:


{{Code|code=
{{Code|code=
Line 64: Line 76:
}}
}}


Spowoduje to wykreślenie naszych funkcji. Polecenie '''plot''' dopuszcza jako argument etykietę serii, ale ponieważ będziemy ją później edytować za pomocą narzędzi środowiska pracy Wykres, nie przekazujemy jeszcze tych danych.
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.


<span id="Configuring_plot"></span>
==Configuring plot==
==Konfiguracja wykresu==


<span id="Showing_grid_and_legend"></span>
===Showing grid and legend===
===Wyświetlanie siatki i legendy===
Change FreeCAD workbench to [[Plot_Module|Plot module]] in View/Workbench menu. When module has been loaded use grid tool in order to show it.


Zmień środowisko pracy FreeCAD na [[Plot_Workbench/pl|Wykres]] w menu {{MenuCommand|Widok → Środowiska pracy}}. Po załadowaniu, użyj narzędzia [[Plot_Grid/pl|siatki]], aby ją wyświetlić.
[[Image:Plot_Grid.svg‎|center|Show/hide grid tool icon]]
<center><span style="font-variant:small-caps">Show/hide grid tool icon.</span></center>


[[Image:Plot_Grid.svg‎]]
You can repeat the action in order to hide it. Also you can show the legend with the tool provided.
{{Caption|Ikonka narzędzia Pokaż / ukryj siatkę}}


Możesz powtórzyć tę czynność, aby ukryć siatkę. Możesz również wyświetlić [[Plot_Legend/pl|legendę]] za pomocą dostarczonego narzędzia.
[[Image:Plot_Legend.svg‎|center|Show/hide legend tool icon]]
<center><span style="font-variant:small-caps">Show/hide legend tool icon.</span></center>


[[Image:Plot_Legend.svg]]
As you can see, legend is empty because we have not set any series label yet. In [[Plot_Module|Plot module]] series without label are not represented at legend, in order to allow you to draw auxiliary lines.
{{Caption|Ikonka narzędzia Pokaż / ukryj legendę}}


Jak widzisz, legenda jest pusta, ponieważ nie ustawiliśmy jeszcze żadnej etykiety serii. W środowisku pracy [[Plot_Workbench/pl|Wykres]] serie bez etykiety nie są wyświetlane w legendzie.
===Setting series labels===
With the series tool you can edit some series parameters.


<span id="Setting_series_label"></span>
[[Image:Plot_Series.svg‎|center|Series configuration tool icon]]
===Ustawianie etykiet serii===
<center><span style="font-variant:small-caps">Series configuration tool icon.</span></center>


Za pomocą narzędzia [[Plot_Series/pl|serii]] możesz edytować niektóre parametry serii.
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:

[[Image:Plot_Series.svg‎]]
{{Caption|Ikonka narzędzia konfiguracji serii}}

Najpierw wybierz serię, którą chcesz edytować, na przykład zaczniemy od pierwszej. Odznacz opcje {{CheckBox|Brak etykiety}} i ustaw tę etykietę:


{{Code|code=
{{Code|code=
Line 93: Line 110:
}}
}}


Since [http://matplotlib.org/ matplotlib] supports [http://www.latex-project.org LaTeX] you can set all the labels or titles that you want using it. Set the following label to second serie:
Ponieważ [http://matplotlib.org/ matplotlib] obsługuje [http://www.latex-project.org LaTeX], możesz ustawić wszystkie etykiety i tytuły, które chcesz, za jego pomocą. Ustaw następującą etykietę na drugą serię:


{{Code|code=
{{Code|code=
Line 99: Line 116:
}}
}}


<span id="Setting_series_style"></span>
===Setting series style===
===Ustawianie stylu serii===
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.


Seria pozwala na ustawienie wielu różnych właściwości. Spróbuj ustawić właściwości pokazane na przykładowym obrazku, zmieniając kolory serii i styl rysowania drugiej serii.
===Setting axes labels===
With the labels tool you can set labels associated to all created axes.


<span id="Setting_axes_labels"></span>
[[Image:Plot_Labels.svg‎|center|Labels tool icon]]
===Ustawianie etykiet osi===
<center><span style="font-variant:small-caps">Labels tool icon.</span></center>


Za pomocą narzędzia [[Plot_Labels/pl|Etykiety]] można ustawić etykiety przypisane do wszystkich utworzonych osi.
Set this data:

* Title = Trigonometric functions example
[[Image:Plot_Labels.svg‎]]
{{Caption|Ikonka narzędzia Ustaw etykiety}}

Ustaw te dane:
* Title = Przykład funkcji trygonometrycznych
* X Label = $t$
* X Label = $t$
* Y Label = $y = \mathrm{f} \left( t \right)$
* Y Label = $y = \mathrm{f} \left( t \right)$


Zmień również rozmiar czcionki w tytule i wszystkich etykietach na {{Value|20}}.
Also change the size of all of them to 20.

<span id="Saving_plot"></span>
==Zapisywanie wykresu==

Za pomocą narzędzia do [[Plot_Save/pl|zapisywania]] wykresu możesz zapisać swój wykres jako plik graficzny w kilku formatach.

[[Image:Plot_Save.svg]]
{{Caption|Ikonka narzędzia Zapisz wykres}}


Najpierw należy wybrać ścieżkę dostępu do pliku wyjściowego.
==Saving plot==
With saving plot tool you can save your plot as image file in several formats.


Możesz ustawić rozmiar obrazu wyjściowego w calach, na przykład możemy ustawić 11.7x8.3, który jest rozmiarem papieru '''DIN A4'''. DPI ''(Dots per inch)'' będzie kontrolować rozdzielczość obrazu, na przykład 100 dpi. W połączeniu z podanymi wymiarami da to obraz o wymiarach 1170x830 pikseli.
[[Image:Plot_Save.svg‎|center|Save tool icon]]
<center><span style="font-variant:small-caps">Save tool icon.</span></center>


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.


{{Plot_Tools_navi{{#translation:}}}}
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.
{{Tutorials navi{{#translation:}}}}
{{Plot Tools navi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
{{Userdocnavi{{#translation:}}}}
[[Category:External_Workbenches{{#translation:}}]]
[[Category:Addons{{#translation:}}]]

Latest revision as of 12:59, 14 April 2023

Ćwiczenie
Temat
Poradnik: Podstawy środowiska pracy Wykres
Poziom trudności
Początkujący
Czas wykonania
Autorzy
Wersja FreeCAD
-
Pliki z przykładami
Zobacz również
-

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ę:

Wykreślanie danych

Aby wykreślić dane nie musisz tworzyć nowego dokumentu FreeCAD, wystarczy, że uruchomisz konsolę Python 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 środowisko pracy utworzyło je automatycznie w momencie rozpoczęcia wykreślania danych. Tworzenie własnych dokumentów wykresów ma dwie 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:

try:
    from FreeCAD.Plot import Plot
except ImportError:
    from freecad.plot import Plot

Plot.figure("TrigonometricTest")

W wersji FreeCAD 0.19 wymagane jest zainstalowanie środowiska pracy Wykres za pomocą Menadżera dodatków, natomiast od wersji 0.20 FreeCAD nie wymaga już zewnętrznego dodatku do wykonywania wykresów. Powyższe polecenia utworzą nową zakładkę w głównym oknie o nazwie TrigonometricTest. Nowo utworzony dokument posiada już zestaw osi. Każdy dokument wykresu posiada co najmniej jeden zestaw osi.

Funkcje rysowania

Można również rozpocząć pracę od tego miejsca, ponieważ, jak już wyjaśniono, polecenie plot utworzy w razie potrzeby nowy dokument. Następną rzeczą, którą musimy zrobić, jest utworzenie danych dla funkcji sinus i cosinus, które chcemy wykreślić:

import math
t = range(0,101)
t = [tt/100.0 for tt in t]
s = [math.sin(2.0*math.pi*tt) for tt in t]
c = [math.cos(2.0*math.pi*tt) for tt in t]

Spowoduje to utworzenie 3 tablic danych (ze 101 punktami):

  • t = Czas w sekundach.
  • s = Funkcja sinus.
  • c = funkcja cosinus.

W celu wykreślenia obu funkcji wystarczy uruchomić kolejne komendy:

Plot.plot(t,s)
Plot.plot(t,c)

Spowoduje to wykreślenie naszych funkcji. Polecenie plot dopuszcza jako argument etykietę serii, ale ponieważ będziemy ją później edytować za pomocą narzędzi środowiska pracy Wykres, nie przekazujemy jeszcze tych danych.

Konfiguracja wykresu

Wyświetlanie siatki i legendy

Zmień środowisko pracy FreeCAD na Wykres w menu Widok → Środowiska pracy. Po załadowaniu, użyj narzędzia siatki, aby ją wyświetlić.

Ikonka narzędzia Pokaż / ukryj siatkę

Możesz powtórzyć tę czynność, aby ukryć siatkę. Możesz również wyświetlić legendę za pomocą dostarczonego narzędzia.

Ikonka narzędzia Pokaż / ukryj legendę

Jak widzisz, legenda jest pusta, ponieważ nie ustawiliśmy jeszcze żadnej etykiety serii. W środowisku pracy Wykres serie bez etykiety nie są wyświetlane w legendzie.

Ustawianie etykiet serii

Za pomocą narzędzia serii możesz edytować niektóre parametry serii.

Ikonka narzędzia konfiguracji serii

Najpierw wybierz serię, którą chcesz edytować, na przykład zaczniemy od pierwszej. Odznacz opcje Brak etykiety i ustaw tę etykietę:

$y = \sin \left( 2 \pi t \right)$

Ponieważ matplotlib obsługuje LaTeX, możesz ustawić wszystkie etykiety i tytuły, które chcesz, za jego pomocą. Ustaw następującą etykietę na drugą serię:

$y = \cos \left( 2 \pi t \right)$

Ustawianie stylu serii

Seria pozwala na ustawienie wielu różnych właściwości. Spróbuj ustawić właściwości pokazane na przykładowym obrazku, zmieniając kolory serii i styl rysowania drugiej serii.

Ustawianie etykiet osi

Za pomocą narzędzia Etykiety można ustawić etykiety przypisane do wszystkich utworzonych osi.

Ikonka narzędzia Ustaw etykiety

Ustaw te dane:

  • Title = Przykład funkcji trygonometrycznych
  • X Label = $t$
  • Y Label = $y = \mathrm{f} \left( t \right)$

Zmień również rozmiar czcionki w tytule i wszystkich etykietach na 20.

Zapisywanie wykresu

Za pomocą narzędzia do zapisywania wykresu możesz zapisać swój wykres jako plik graficzny w kilku formatach.

Ikonka narzędzia Zapisz wykres

Najpierw należy wybrać ścieżkę dostępu do pliku wyjściowego.

Możesz ustawić rozmiar obrazu wyjściowego w calach, na przykład możemy ustawić 11.7x8.3, który jest rozmiarem papieru DIN A4. DPI (Dots per inch) będzie kontrolować rozdzielczość obrazu, na przykład 100 dpi. W połączeniu z podanymi wymiarami da to obraz o wymiarach 1170x830 pikseli.