Setelah menuntaskan seluruh bab dalam course ini, pertanyaan kita berikutnya biasanya berbunyi: “kalau menemui detail yang tidak dibahas di sini, ke mana harus memeriksanya?” Jawaban yang paling dapat diandalkan adalah dokumentasi resmi di numpy.org. Dokumentasi tersebut ditulis dan diperbarui langsung oleh tim pengembang NumPy, mengikuti perkembangan versi pustaka, dan gratis dibaca siapa pun.

Bab ini memetakan area-area situs numpy.org yang layak dibookmark, menunjukkan cara membaca satu halaman fungsi secara efektif, lalu menutup dengan teknik mencari jawaban langsung dari interpreter Python tanpa membuka browser.

Satu catatan sebelum kita mulai: alamat URL situs dokumentasi dapat berubah seiring waktu. Semua tautan pada bab ini telah kita verifikasi aktif saat course ini ditulis, tetapi bila sebuah tautan tidak lagi berfungsi, gunakan kolom pencarian di situs numpy.org untuk menemukan halaman penggantinya.

Peta Situs numpy.org/doc/stable #

Halaman numpy.org/doc/stable adalah pintu masuk dokumentasi versi stable, yaitu versi rilis stabil terbaru yang direkomendasikan untuk pengguna umum. Situs tersebut terbagi menjadi beberapa area besar:

AreaIsiKapan kita membukanya
User guidePenjelasan konsep dan alur kerja, dari instalasi hingga topik lanjutanIngin memahami “mengapa” dan “bagaimana”, bukan sekadar nama fungsi
API referenceHalaman rinci setiap fungsi, kelas, dan atributButuh daftar parameter, nilai kembali, atau contoh resmi
Release notesCatatan perubahan setiap versiIngin tahu apa yang berubah, misalnya saat migrasi ke NumPy 2
GlossaryDefinisi istilah teknis NumPyMenemukan istilah asing saat membaca materi lain
LearnKumpulan tautan tutorial resmi terkurasiIngin berlatih lewat materi bertahap
NewsPengumuman rilis dan perkembangan proyekIngin mengikuti versi terbaru

Membaca Satu Halaman Fungsi #

Setiap fungsi memiliki halaman tersendiri di API reference, misalnya halaman numpy.mean . Struktur halaman tersebut standar untuk hampir semua fungsi, sehingga kita cukup menguasai satu pola baca:

  1. Signature — baris teratas memuat nama fungsi beserta seluruh parameter dan nilai defaultnya.
  2. Summary — satu-dua kalimat yang menyatakan apa yang dilakukan fungsi.
  3. Parameters — daftar parameter: nama, tipe yang diterima (misalnya array_like), dan maknanya.
  4. Returns — tipe dan makna nilai yang dikembalikan.
  5. Raises — error yang mungkin dimunculkan bila pemanggilan tidak sah.
  6. See Also — fungsi-fungsi terkait; bagian ini sering menjadi jalan pintas menemukan alat yang lebih pas.
  7. Examples — kode contoh resmi yang bisa langsung kita jalankan ulang di interpreter.

Kebiasaan membaca yang efisien: mulai dari signature dan Parameters, lompat ke Examples untuk melihat pemakaian nyata, lalu baca Notes bila ada perilaku khusus yang perlu diwaspadai. Bab Referensi API membahas pola baca ini lebih dalam.

Menelusuri Perubahan Versi lewat Release Notes #

Ketika kode dari sumber lama tidak lagi berjalan, halaman release notes adalah tempat pemeriksaan pertama. Rilis NumPy 2.0 (Juni 2024) menghapus sejumlah alias dan fungsi lama; halaman catatan rilis 2.0 memuat daftar lengkap yang dihapus beserta penggantinya.

Salah satu alat lama yang hilang adalah np.lookfor, pencari docstring bawaan yang sering disebut tutorial era 1.x. Mari kita amati apa yang terjadi ketika alat tersebut dipanggil pada versi modern:

python 
import numpy as np

try:
    np.lookfor("sort")
except AttributeError as e:
    print("AttributeError:", e)

Output yang Dihasilkan:

text 
AttributeError: `np.lookfor` was removed in the NumPy 2.0 release. Search NumPy's documentation directly.

Pesan error tersebut dibaca dua arah: ia memberi tahu bahwa np.lookfor sudah dihapus, sekaligus menunjukkan penggantinya (pencarian langsung di situs dokumentasi). Pola “pesan error menyebut penggantinya” sangat membantu saat mengadaptasi kode lama — kita sudah melihat pola serupa pada bab Membaca Error NumPy.

Mencari Jawaban dari Interpreter #

Dokumentasi tidak harus dibaca lewat browser: setiap fungsi membawa docstring, dan isi docstring sama dengan isi halaman API reference versi terpasang. Helper np.info mencetak docstring tersebut ke layar. Blok berikut menangkap output-nya lalu mencetak sebagiannya saja agar ringkas:

python 
import numpy as np
import io
import contextlib

with contextlib.redirect_stdout(io.StringIO()) as buf:
    np.info(np.mean)
baris = buf.getvalue().splitlines()
print("np.info(np.mean) mencetak", len(baris), "baris")
for b in baris[:4]:
    print(b)

Output yang Dihasilkan:

text 
np.info(np.mean) mencetak 102 baris
Compute the arithmetic mean along the specified axis.

Returns the average of the array elements.  The average is taken over
the flattened array by default, otherwise over the specified axis.

Mari kita bedah baris demi baris:

  1. Baris 5 (with contextlib.redirect_stdout(...)): alat standar Python contextlib mengalihkan seluruh output print ke objek StringIO bernama buf, sehingga teks dokumentasi tidak langsung memenuhi layar.
  2. Baris 6 (np.info(np.mean)): NumPy menuliskan docstring np.mean ke dalam buf alih-alih ke terminal.
  3. Baris 7 (buf.getvalue().splitlines()): isi buf diambil sebagai satu teks, lalu dipecah menjadi list baris-baris.
  4. Baris 9-10 (baris[:4]): hanya empat baris pertama yang dicetak — ringkasan dan awal penjelasan fungsi.

Di interpreter biasa kita tidak perlu pengalihan seperti di atas; cukup tulis np.info(np.mean) atau help(np.mean), lalu tekan Enter. Keduanya mencetak dokumentasi lengkap, termasuk bagian Parameters dan Examples.