Bei der Funktion plot hast du bereits die Einstellungen color und linewidth verwendet. In den weiteren Beispielen lernst du neue Funktionen und Parameter kennen. Du musst dir ihre Namen und Reihenfolge nicht alle merken: Die PyneIDE zeigt die zugehörige Hilfe direkt am Code.

In diesem Kapitel verwenden wir die bereits erstellte Datei first_chart.py. Du musst das Programm dafür nicht ausführen.

Bewege den Mauszeiger auf den Funktionsnamen

  1. Öffne first_chart.py über die Gruppe Scripts der Ansicht Pyne.
  2. Suche in main() den Aufruf plot(close, "Close", ...).
  3. Bewege den Mauszeiger auf den Namen plot am Zeilenanfang und lasse ihn kurz dort stehen.

Die eingeblendete Hilfe zeigt die Parameterliste und Beschreibung der Funktion. Bei längeren Inhalten kannst du den Mauszeiger auf die Hilfe bewegen und darin scrollen. Mit Esc schließt du sie.

Über dem Aufruf von plot in first_chart.py ist die PyneIDE-Hilfe geöffnet; in der Parameterliste hat linewidth den Standardwert 1.
Die Hilfe über dem Namen plot zeigt auch Typen und Standardwerte der Parameter.

Wie liest du die Parameterliste?

Die Hilfe kann mehr Einstellungen aufführen, als wir im Beispiel verwenden. Suche einfach die heraus, die du gerade brauchst.

Bei plot sind das zum Beispiel:

  • series ist der darzustellende Wert. In unserem Programm steht an dieser Stelle close.
  • title ist der Name der Darstellung. Das zweite Argument des Aufrufs, "Close", legt ihn fest.
  • linewidth ist die Linienstärke. Das in der Parameterliste angezeigte = 1 ist der Standardwert; unser linewidth=2 überschreibt ihn.

Ein Parameter ist der Name eines Werts oder einer Einstellung, die eine Funktion erwartet. Ein Argument ist der konkrete Wert, den du beim Aufruf übergibst. linewidth ist also ein Parameter; die 2 im Aufruf linewidth=2 ist ein Argument.

Steht neben dem Namen ein Typ, gibt er einen Hinweis auf den erwarteten Wert. int bedeutet zum Beispiel eine ganze Zahl. Typangaben begegnen dir auch in den nächsten Kapiteln. Du musst die vollständige Liste jetzt nicht lernen.

Die Beschreibung in der Hilfe ist auf Englisch. Die Bedeutung der Parameter aus den Beispielen erklärt das Buch auf Deutsch. Bei einer neuen Funktion lohnt es sich, zuerst die Beschreibung zu überfliegen und anschließend die Einstellung zu suchen, die du ändern möchtest.

Zusätzliche Möglichkeit: zur Definition springen

Wenn du auch sehen möchtest, wo die Funktion geschrieben ist, halte unter macOS Command, unter Windows oder Linux Ctrl gedrückt und klicke auf plot. Der Editor öffnet die zugehörige Definition. Du erreichst dieselbe Aktion auch über einen Rechtsklick auf den Namen und Go to Definition.

In der geöffneten Datei stehen unter def plot(...) die Beschreibung und Implementierung der Funktion. Das ist bereits Code der installierten Bibliothek: Für die Übung genügt es, ihn zu lesen. Verändere ihn nicht. Über den Tab first_chart.py kehrst du zu deinem Programm zurück.

Die PyneIDE ist in der Bibliotheksdatei plot.py zur Zeile def plot gesprungen; darunter stehen die Beschreibungen der Parameter.
Der Sprung zur Definition öffnet den Bibliotheksquellcode von plot. Dein eigenes Programm bleibt in einem separaten Tab geöffnet.

Für die Beispiele dieses Buchs musst du das Innenleben der Bibliothek nicht kennen. Diese Möglichkeit hilft dir, wenn du später eine Funktion genauer untersuchen möchtest.

Probiere es selbst aus

Öffne die Hilfe zu plot und suche den Parameter linewidth. Welchen Standardwert hat er? Sieh dir danach deinen Aufruf an: Verwendet er denselben Wert?

Lösung der Aufgabe

Der Standardwert ist 1. In first_chart.py steht linewidth=2, wir stellen die Linienstärke also auf 2. Lässt du dieses Argument im Aufruf weg, verwendet die Funktion den Standardwert 1.