Saat menggunakan fungsi plot, kamu sudah memakai pengaturan color dan linewidth. Contoh berikutnya akan memperkenalkan fungsi dan parameter lain. Kamu tidak perlu menghafal semua nama dan urutannya: PyneIDE menampilkan bantuan langsung di samping kode.

Bab ini menggunakan file first_chart.py yang sudah dibuat. Programnya tidak perlu dijalankan.

Mengarahkan mouse ke nama fungsi

  1. Buka first_chart.py dari kelompok Scripts dalam tampilan Pyne.
  2. Temukan pemanggilan plot(close, "Close", ...) dalam main().
  3. Arahkan penunjuk mouse ke nama plot di awal baris dan diamkan sebentar.

Bantuan yang muncul menampilkan daftar parameter dan deskripsi fungsi. Jika isinya panjang, arahkan mouse ke kotak bantuan dan gulir di dalamnya. Tekan Esc untuk menutupnya.

Bantuan PyneIDE terbuka di atas pemanggilan plot dalam first_chart.py; daftar parameter menunjukkan nilai bawaan linewidth adalah 1.
Bantuan yang muncul di atas nama plot juga menampilkan tipe dan nilai bawaan parameter.

Membaca daftar parameter

Bantuan mungkin mencantumkan lebih banyak pengaturan daripada yang digunakan dalam contoh. Cukup cari yang kamu perlukan saat itu.

Untuk plot, misalnya:

  • series adalah nilai yang akan digambar. Program kita mengisi tempat ini dengan close.
  • title adalah nama gambar. Argumen kedua pemanggilan, "Close", menentukan nama tersebut.
  • linewidth adalah ketebalan garis. = 1 dalam daftar parameter menunjukkan nilai bawaannya; linewidth=2 dalam contoh menggantikan nilai tersebut.

Parameter adalah nama data atau pengaturan yang diharapkan fungsi. Argumen adalah nilai yang kamu berikan saat memanggilnya. Jadi, linewidth adalah parameter, sedangkan 2 yang diberikan melalui linewidth=2 adalah argumen.

Jika ada tipe di samping nama, tipe itu memberi petunjuk tentang nilai yang diharapkan. Misalnya, int berarti bilangan bulat. Kamu akan menemui anotasi tipe lagi dalam bab berikut; belum perlu mempelajari seluruh daftarnya sekarang.

Deskripsi bantuan muncul dalam bahasa Inggris, sementara arti parameter yang digunakan dalam contoh juga dijelaskan dalam bahasa Indonesia di buku. Saat menggunakan fungsi baru, baca sekilas deskripsinya, lalu cari pengaturan yang ingin kamu ubah.

Pilihan tambahan: menuju definisi

Jika ingin melihat tempat fungsi ditulis, tahan Command pada macOS atau Ctrl pada Windows maupun Linux, lalu klik nama plot. Editor membuka definisi yang terkait. Tindakan yang sama juga tersedia melalui klik kanan pada nama tersebut dan memilih Go to Definition.

Dalam file yang terbuka, deskripsi dan cara kerja fungsi berada di bawah baris def plot(...). Ini adalah kode pustaka yang terpasang: untuk latihan ini, cukup baca tanpa mengubahnya. Klik tab first_chart.py untuk kembali ke programmu.

PyneIDE menuju baris def plot dalam file pustaka plot.py; di bawahnya terlihat deskripsi parameter.
Menuju definisi membuka sumber fungsi plot dalam pustaka. Programmu tetap terbuka pada tab terpisah.

Kamu tidak perlu memahami cara kerja internal pustaka untuk mengerjakan contoh buku. Fitur ini berguna jika nanti ingin mempelajari suatu fungsi lebih jauh.

Coba sendiri

Buka bantuan plot dan cari parameter linewidth. Berapa nilai bawaannya? Lalu lihat pemanggilanmu sendiri: apakah nilainya sama?

Solusi latihan

Nilai bawaannya 1. Program first_chart.py menggunakan linewidth=2, sehingga ketebalan garis ditetapkan menjadi 2. Jika argumen ini dihapus dari pemanggilan, fungsi menggunakan nilai bawaan 1.