A plot függvénynél már használtad a color és a linewidth beállítást. A további példákban újabb függvényekkel és paraméterekkel találkozol. Ezek nevét és sorrendjét nem kell mind megjegyezned: a PyneIDE a kód mellett megmutatja a hozzájuk tartozó súgót.

Ebben a fejezetben a már elkészített first_chart.py fájlt használjuk. A programot most nem kell futtatnod.

Vidd az egeret a függvény nevére

  1. Nyisd meg a first_chart.py fájlt a Pyne nézet Scripts csoportjából.
  2. Keresd meg a main() belsejében a plot(close, "Close", ...) hívást.
  3. Vidd az egérmutatót a sor elején álló plot névre, és hagyd ott egy pillanatra.

A megjelenő súgóban a függvény paraméterlistáját és leírását olvashatod. Ha hosszabb a tartalom, vidd az egeret a súgó fölé, és görgess benne. Az Esc billentyűvel bezárhatod.

A first_chart.py program plot hívása fölött nyitva van a PyneIDE súgója; a paraméterlistában a linewidth alapértéke 1.
A plot neve fölött megjelenő súgó a paraméterek típusát és alapértékét is megmutatja.

Hogyan olvasd a paraméterlistát?

A súgó több beállítást is felsorolhat, mint amennyit a példában használtunk. Elég azokat megkeresned, amelyekre éppen szükséged van.

A plot esetén például:

  • A series a kirajzolandó érték. A programunkban ezt a helyet a close foglalja el.
  • A title a rajz neve. A hívás második argumentuma, a "Close" ezt adja meg.
  • A linewidth a vonal vastagsága. A paraméterlistában látható = 1 az alapértéke; a példánkban a linewidth=2 ezt felülírja.

A paraméter egy függvény által várt adat vagy beállítás neve. Az argumentum az az érték, amelyet a hívásban átadsz neki. A linewidth tehát paraméter, a linewidth=2 hívásban megadott 2 pedig argumentum.

Ha a név mellett típust is látsz, az a várt értékről ad támpontot. Az int például egész számot jelent. A típusjelölésekkel a következő fejezetekben is találkozol; a teljes listát most nem kell megtanulnod.

A súgó leírása angolul jelenik meg, a példákban szereplő paraméterek jelentését a könyv magyarul is elmagyarázza. Új függvénynél érdemes először átfutni a leírást, majd visszakeresni benne azt a beállítást, amelyet módosítani szeretnél.

Kiegészítő lehetőség: ugrás a definícióhoz

Ha azt is meg szeretnéd nézni, hol van megírva a függvény, macOS-en tartsd lenyomva a Command, Windows vagy Linux alatt a Ctrl billentyűt, és kattints a plot nevére. A szerkesztő megnyitja a hozzá tartozó definíciót. Ugyanezt a műveletet a névre jobb gombbal kattintva, a Go to Definition menüponttal is eléred.

A megnyíló fájlban a def plot(...) sor alatt a függvény leírását és működését találod. Ez már a telepített könyvtár kódja: a gyakorlathoz elég elolvasnod, ne módosítsd. A saját programodhoz a first_chart.py fülére kattintva térhetsz vissza.

A PyneIDE a plot.py könyvtári fájlban a def plot sorra ugrott; alatta a paraméterek szöveges leírása látható.
A definícióhoz ugrás megnyitja a plot függvény könyvtári forrását. A saját program külön fülön marad.

A könyv példáinak elkészítéséhez nincs szükség a könyvtár belső működésének ismeretére. Ez a lehetőség akkor hasznos, ha később alaposabban utánanéznél egy függvénynek.

Próbáld ki önállóan

Nyisd meg a plot súgóját, és keresd meg benne a linewidth paramétert. Mi az alapértéke? Ezután nézd meg a saját hívásodat: ugyanazt az értéket használja?

A feladat megoldása

Az alapérték 1. A first_chart.py programban linewidth=2 szerepel, ezért a vonal vastagságát 2-re állítjuk. Ha ezt az argumentumot elhagyod a hívásból, a függvény az 1-es alapértéket használja.