Help dan Documentation

MATLAB inti saja sudah memuat ratusan fungsi, dan setiap toolbox menambahkan ratusan lagi. Membaca dan menghafal semuanya mustahil — dan tidak perlu, karena semua bantuan tersedia dari dalam MATLAB itu sendiri. Pengguna yang terbiasa mencari bantuan lewat help, doc, dan lookfor akan selalu lebih cepat menyelesaikan masalah daripada pengguna yang mencoba menghafal. Chapter ini membedah lapisan-lapisan bantuan tersebut.

Cakupan materi Chapter ini:

• help <fungsi> untuk ringkasan cepat di Command Window;
• doc <fungsi> untuk halaman dokumentasi lengkap;
• lookfor <kata kunci> saat nama fungsi terlupa;
• bantuan dari Editor dan dokumentasi resmi daring.

help: Bantuan Cepat di Command Window #

Aturannya: help diikuti nama fungsi menampilkan ringkasan singkat fungsi tersebut langsung di Command Window — deskripsi satu baris, bentuk pemanggilan, dan daftar fungsi terkait. Mekanismenya: help membaca teks bantuan yang terpasang pada definisi fungsi, sehingga ringkasannya selalu cocok dengan versi MATLAB yang terinstal di komputer kita. Perintah help juga mengenal operator: help plus menjelaskan operator penjumlahan, dan help paren menjelaskan tanda kurung.

Berkas contoh.m berikut (tersedia di bagian bawah halaman) memanggil bantuan untuk fungsi sin:

% contoh.m — Mengakses bantuan dari dalam MATLAB.

% help <fungsi>: ringkasan singkat langsung di Command Window.
help sin

Output yang Dihasilkan (MATLAB, versi ringkas):

>> help sin
 sin - Sine of argument in radians

    This MATLAB function returns the sine of the elements of X
    in radians.

    Y = sin(X)

    Other functions named sin

    See also asin, asind, sind, sinh.

Mari kita bedah isi output tersebut:

1. Baris pertama (sin - Sine of argument in radians): baris judul — nama fungsi dan deskripsi singkatnya. Baris inilah yang dicari lookfor.
2. Paragraf deskripsi: penjelasan fungsi dalam dua-tiga kalimat.
3. Baris Y = sin(X): bentuk pemanggilan (syntax) lengkap dengan variabel masukan dan keluaran.
4. Baris Other functions named sin: informasi bahwa nama sin juga dipakai method untuk tipe data lain.
5. Baris See also ...: fungsi-fungsi bertetangga yang layak dibaca berikutnya.

doc: Documentation Browser #

Aturannya: doc diikuti nama fungsi membuka halaman dokumentasi lengkap pada Documentation Browser — jendela bantuan terpisah dengan navigasi pohon topik dan kolom pencarian. Mekanismenya: berbeda dari help yang memuat teks ringkas, halaman doc berisi penjelasan penuh: deskripsi tiap argumen, contoh kode yang dapat dijalankan, perilaku khusus, dan keterkaitan dengan fungsi lain. Untuk fungsi sin, perintahnya doc sin.

Documentation Browser juga dapat dibuka lewat perintah helpdesk atau tombol ikon tanda tanya di sudut kanan atas ribbon. Dari sanalah kita bisa menjelajah seluruh dokumentasi secara topik, dari “Language Fundamentals” hingga “Graphics”. Berikut perbandingan dua lapisan bantuan:

lookfor: Mencari dari Kata Kunci #

Aturannya: saat kita ingat kebutuhannya tetapi lupa namanya, lookfor <kata kunci> mencari fungsi berdasarkan deskripsi, bukan nama. Mekanismenya: lookfor memindai baris judul (baris pertama teks help) seluruh fungsi yang diketahui MATLAB, lalu mencantumkan semua fungsi yang deskripsinya memuat kata kunci tersebut. Contoh nyata: kita lupa fungsi akar kuadrat, tetapi ingat kata square root:

>> lookfor square
sqrt                        - Square root.

Daftar lengkap pada komputer kita biasanya mencantumkan fungsi-fungsi lain yang deskripsinya memuat kata square, seperti sqrtm (akar kuadrat matriks), realsqrt (akar kuadrat bilangan real positif), dan magic (kotak ajaib atau magic square) — setiap hasil mengikuti format namaFungsi - deskripsi. Memadatkan kata kunci mempersempit daftar tersebut. Sebaliknya, jika kata kunci terlalu jauh dari istilah resmi, hasil kosong: lookfor akar tidak menemukan apa-apa karena dokumentasi MATLAB ditulis dalam bahasa Inggris.

Bantuan di Editor dan Dokumentasi Online #

Bantuan juga menempel langsung pada Editor. Saat kursor berada di atas sebuah nama fungsi, tekan F1 untuk membuka dokumentasi fungsi tersebut; sebelum menekan F1, Editor juga menampilkan tooltip ringkas saat kursor diarahkan ke nama fungsi. Saran pelengkap (code suggestions) yang muncul saat mengetik sekaligus menjadi lapisan bantuan kecil: saran menampilkan bentuk pemanggilan dasar fungsi tanpa membuka jendela apa pun.

Dokumentasi lengkap juga tersedia daring di mathworks.com/help/matlab. Versi daring selalu memuat rilis terbaru, dilengkapi contoh interaktif, dan dapat dicari dari peramban. Saat koneksi tersedia, halaman daring adalah rujukan tercepat; saat bekerja luring, doc pada Documentation Browser terinstal memuat isi yang sama.

Ringkasan #

help <fungsi> menyajikan ringkasan cepat di Command Window, doc <fungsi> membuka halaman dokumentasi lengkap di Documentation Browser (bisa pula lewat helpdesk), dan lookfor <kata kunci> menemukan fungsi dari deskripsinya saat nama terlupa. Editor menambah bantuan lewat tombol F1 dan tooltip, sementara dokumentasi daring di mathworks.com/help/matlab melengkapi semuanya. Dengan lapisan bantuan ini, kita tidak pernah benar-benar terjebak. Chapter berikutnya menggunakan bekal tersebut untuk menulis skrip MATLAB pertama kita.