W funkcji plot używałeś już ustawień color i linewidth. Kolejne przykłady wprowadzają nowe funkcje i parametry. Nie musisz zapamiętywać wszystkich nazw i ich kolejności: PyneIDE pokazuje pomoc bezpośrednio przy kodzie.

W tym rozdziale używamy gotowego pliku first_chart.py. Nie trzeba uruchamiać programu.

Najedź na nazwę funkcji

  1. Otwórz first_chart.py z grupy Scripts w widoku Pyne.
  2. Znajdź w main() wywołanie plot(close, "Close", ...).
  3. Najedź na plot na początku wiersza i poczekaj chwilę.

Wyświetlona pomoc zawiera listę parametrów i opis funkcji. Jeśli treść jest dłuższa, przenieś kursor nad pomoc i przewijaj. Esc zamyka okienko.

Nad wywołaniem plot w first_chart.py otwarta jest pomoc PyneIDE; lista parametrów pokazuje domyślną wartość linewidth równą 1.
Pomoc nad nazwą plot pokazuje też typy i domyślne wartości parametrów.

Jak czytać listę parametrów?

Pomoc może wymieniać więcej ustawień niż użyliśmy w przykładzie. Wystarczy znaleźć te, których teraz potrzebujesz.

Dla plot na przykład:

  • series to rysowana wartość. W naszym programie to miejsce zajmuje close.
  • title to nazwa rysowanej serii. Określa ją drugi argument "Close".
  • linewidth to grubość linii. Widoczne = 1 jest wartością domyślną; w przykładzie zastępujemy ją przez linewidth=2.

Parametr to nazwa danych lub ustawienia oczekiwanego przez funkcję. Argument to konkretna wartość przekazana w wywołaniu. linewidth jest więc parametrem, a 2 z wywołania linewidth=2 argumentem.

Jeśli obok nazwy widzisz typ, podpowiada on oczekiwaną wartość. Na przykład int oznacza liczbę całkowitą. Typy pojawią się w kolejnych rozdziałach; nie trzeba teraz uczyć się pełnej listy.

Opis pomocy jest po angielsku, a znaczenie parametrów używanych w przykładach książka wyjaśnia po polsku. Przy nowej funkcji przejrzyj najpierw opis, potem odszukaj ustawienie, które chcesz zmienić.

Dodatkowa możliwość: przejście do definicji

Jeśli chcesz zobaczyć, gdzie napisano funkcję, przytrzymaj Command w macOS albo Ctrl w Windows lub Linux i kliknij plot. Edytor otworzy definicję. Tę samą operację znajdziesz w menu prawego przycisku pod Go to Definition.

Pod wierszem def plot(...) znajdziesz opis i implementację. To kod zainstalowanej biblioteki: do ćwiczenia wystarczy go przeczytać, nie zmieniaj go. Wrócisz do własnego programu, klikając kartę first_chart.py.

PyneIDE przeszło do def plot w bibliotecznym pliku plot.py; poniżej widać opisy parametrów.
Przejście do definicji otwiera źródło bibliotecznej funkcji plot. Własny program pozostaje w osobnej karcie.

Do przykładów z książki nie musisz znać wewnętrznego działania biblioteki. Ta możliwość przyda się, gdy później zechcesz dokładniej poznać funkcję.

Spróbuj samodzielnie

Otwórz pomoc plot i znajdź linewidth. Jaka jest wartość domyślna? Następnie sprawdź własne wywołanie: czy używa tej samej wartości?

Rozwiązanie zadania

Wartość domyślna wynosi 1. W first_chart.py mamy linewidth=2, więc ustawiamy grubość na 2. Po pominięciu argumentu funkcja użyje domyślnej jedynki.