Bagaimana memanfaatkan library google.colab.ai untuk tanya jawab, Text2SQL, NER, analisis sentimen, hingga penilaian jawaban — langsung dari Colab, bahkan untuk pengguna gratis.

Pendahuluan

Model bahasa generatif seperti Gemini dari Google makin mudah diakses. Jika dulu perlu menyiapkan API key, mengatur billing, dan menginstal library tambahan, sekarang Google menyediakan cara yang jauh lebih praktis: cukup buka Google Colab dan gunakan satu baris kode:

from google.colab import ai

Kabar baiknya, fitur ini bisa dinikmati oleh pengguna gratis Colab. Artinya, siapa pun yang punya akun Google bisa mencoba model Gemini tanpa ribet konfigurasi.

Tulisan ini merangkum beberapa eksperimen dengan google.colab.ai di Google Colab, mulai dari:

• Melihat daftar model Gemini yang tersedia

• Tanya jawab sederhana dan penjelasan konsep

• Text2SQL untuk skema database

• Named Entity Recognition (NER) berbasis prompt

• Question Answering dan generasi soal otomatis

• Analisis sentimen (termasuk aspect-based sentiment)

• Penilaian jawaban berbasis rubrik

Semua contoh diambil dari satu notebook praktis, dan bisa langsung diadaptasi untuk eksperimen pribadi, pembuatan konten, prototyping produk, maupun riset ringan.

Persiapan Lingkungan di Google Colab

Langkah awalnya sangat sederhana:

1. Buka Google Colab.

2. Buat notebook baru (runtime Python standar).

3. Tambahkan import berikut di salah satu sel kode:

from google.colab import ai

Tidak perlu pip install, tidak perlu API key. Selama menggunakan build Colab yang sudah mendukung google.colab.ai, kode ini akan langsung berjalan dan siap memanggil model Gemini di belakang layar.

Fungsi Dasar google.colab.ai

Bagian ini merangkum beberapa fungsi dasar yang digunakan di notebook: ai.list_models() dan ai.generate_text().

1. Melihat daftar model Gemini yang tersedia

Sebelum mulai, ada baiknya melihat dulu model apa saja yang bisa dipakai. Di notebook, hal ini dilakukan dengan kode:

from google.colab import ai
ai.list_models()

Perintah ini menampilkan daftar model seperti gemini-2.5-flash, gemini-2.5-flash-lite, dan lain-lain. Dari sini bisa dipilih:

• Model yang ringan dan cepat untuk eksperimen.

• Model yang lebih besar untuk kualitas jawaban yang lebih baik.

Daftar model ini juga membantu jika ingin mengunci eksperimen ke satu model tertentu demi konsistensi hasil.

2. Tanya jawab sederhana dengan ai.generate_text

Contoh paling dasar adalah tanya jawab. Di notebook, digunakan kode berikut:

from google.colab import ai
respons = ai.generate_text("Sebutkan 5 sila dalam Pancasila!")
print(respons)

Dengan satu prompt singkat, model mengembalikan jawaban lengkap. Pola ini bisa digunakan untuk banyak hal:

• Meminta penjelasan konsep tertentu.

• Menghasilkan contoh-contoh tambahan.

• Membuat ringkasan atau penjelasan singkat.

Cara termudah bereksperimen adalah dengan mengubah teks prompt dan mengamati bagaimana respons model berubah.

3. Memilih model tertentu: google/gemini-2.5-flash-lite

Terkadang perlu mengontrol model yang digunakan, misalnya demi kecepatan respons. Di notebook, hal ini dilakukan dengan menambahkan parameter model_name:

from google.colab import ai

respons = ai.generate_text(
    "Sebutkan rukum iman dalam agama Islam!",
    model_name="google/gemini-2.5-flash-lite"
)
print(respons)

Model flash-lite biasanya lebih hemat sumber daya dan cukup untuk tugas-tugas ringan seperti tanya jawab singkat. Untuk tugas yang membutuhkan penalaran lebih dalam, bisa mencoba model lain yang tersedia di hasil ai.list_models().

4. Menampilkan jawaban secara streaming

Untuk jawaban yang lebih panjang, google.colab.ai mendukung mode streaming sehingga teks muncul sedikit demi sedikit seperti sedang diketik. Contoh di notebook:

from google.colab import ai

stream = ai.generate_text(
    "Jelaskan secara singkat tentang Large Language Models",
    stream=True
)
for teks in stream:
  print(teks)

Mode ini terasa lebih interaktif, terutama saat mendemonstrasikan konsep atau ketika ingin melihat proses terbentuknya jawaban secara bertahap, bukan langsung satu blok teks panjang.

Use Case 1 – Text2SQL untuk Skema Database Sederhana

Bagian berikut memperlihatkan bagaimana google.colab.ai dapat menghubungkan bahasa alami dengan SQL. Ini sangat berguna untuk eksperimen dengan basis data.

Di notebook, didefinisikan skema database sederhana bernama hobimahasiswa dengan tabel mahasiswa, hobi, dan mhshobi. Lalu dibuat fungsi text2sql(question) yang menerima pertanyaan dalam bahasa Indonesia dan mengembalikannya sebagai query SQL.

from google.colab import ai

schema = """
Database: hobimahasiswa

Tabel: mahasiswa
- nim (PRIMARY KEY)
- nama

Tabel: hobi
- kode_hobi (PRIMARY KEY)
- nama_hobi

Tabel: mhshobi
- nim (FOREIGN KEY ke mahasiswa.nim)
- kode_hobi (FOREIGN KEY ke hobi.kode_hobi)
"""

def text2sql(question):
    prompt = f"""
Kamu adalah asisten pembuat SQL.

Gunakan skema berikut:
{schema}

Tugas:
- Terjemahkan pertanyaan berikut menjadi SQL query valid.
- Jangan berikan penjelasan, hanya SQL saja.

Pertanyaan:
{question}
"""
    sql = ai.generate_text(prompt)
    return sql

print(text2sql("Tampilkan nama mahasiswa yang memiliki hobi Memasak."))

Prompt memberikan konteks berupa skema database serta instruksi yang tegas: model hanya boleh mengembalikan SQL, tanpa penjelasan tambahan. Hasilnya adalah query SQL yang secara umum sudah cukup baik untuk dijalankan di sistem basis data (tetap disarankan untuk meninjau ulang sebelum digunakan di sistem produksi).

Use Case 2 – Named Entity Recognition (NER) dengan Prompt

Untuk teks panjang, kadang perlu mengekstrak entitas penting seperti nama orang, organisasi, lokasi, atau tanggal. Di sini google.colab.ai digunakan sebagai “NER on demand” tanpa perlu melatih model khusus.

Contoh di notebook menggunakan paragraf tentang seminar kecerdasan buatan di UNIKOM:

from google.colab import ai

paragraph = """
Pada tanggal 15 Januari 2023, Universitas Komputer Indonesia (UNIKOM) di Bandung
mengadakan seminar mengenai pemanfaatan kecerdasan buatan. Seminar tersebut
dihadiri oleh para dosen seperti Galih Hermawan serta beberapa perwakilan
dari Kementerian Pendidikan dan Kebudayaan. Acara ini juga bekerja sama dengan
Google Indonesia.
"""

prompt = f"""
Lakukan Named Entity Recognition (NER) pada paragraf berikut.

Tampilkan hasil dalam format JSON dengan struktur:
- person
- organization
- location
- date

Paragraf:
{paragraph}
"""

response = ai.generate_text(prompt)
print(response)

Model akan mencoba mengembalikan daftar entitas, misalnya:

• person: daftar nama orang

• organization: nama organisasi yang muncul

• location: lokasi acara

• date: tanggal kegiatan

Hasil ini bisa digunakan untuk analisis teks lebih lanjut, pembuatan ringkasan, atau sekadar eksplorasi data teks berbahasa Indonesia.

Use Case 3 – Question Answering dan Generasi Soal Otomatis

Bagian berikut berfokus pada Question Answering (QA) dan pembuatan soal otomatis dari teks konteks.

3.1 QA berdasarkan paragraf konteks

Pertama, disiapkan paragraf tentang sejarah Google, lalu diajukan pertanyaan yang jawabannya ada di dalam paragraf tersebut:

from google.colab import ai

context = """
Google didirikan pada tahun 1998 oleh Larry Page dan Sergey Brin ketika keduanya
masih menjadi mahasiswa PhD di Stanford University. Perusahaan ini berkembang
pesat seiring dengan popularitas mesin pencariannya. Saat ini, Google menjadi
bagian dari Alphabet Inc. dan berfokus pada berbagai bidang seperti kecerdasan
buatan, komputasi awan, perangkat keras, dan layanan digital.
"""

question = "Kapan Google didirikan dan siapa pendirinya?"

prompt = f"""
Jawab pertanyaan berikut berdasarkan konteks yang diberikan.

Konteks:
{context}

Pertanyaan:
{question}

Berikan jawaban yang singkat dan langsung ke inti.
"""

response = ai.generate_text(prompt)
print(response)

Model diminta secara eksplisit untuk menjawab berdasarkan konteks yang diberikan. Pola ini mirip dengan tugas reading comprehension di berbagai aplikasi QA berbasis dokumen.

3.2 Membuat pertanyaan dan jawaban otomatis dari paragraf

Selanjutnya, model diminta menyusun soal sendiri dari sebuah paragraf. Contoh di notebook menggunakan konteks tentang UNIKOM:

from google.colab import ai

context = """
UNIKOM (Universitas Komputer Indonesia) adalah salah satu perguruan tinggi
swasta terkemuka di Bandung yang berfokus pada teknologi informasi, desain,
dan bisnis. Kampus ini didirikan pada tahun 2000 dan terus berkembang sebagai
pusat pendidikan inovatif di bidang informatika.
"""

prompt = f"""
Buat satu pertanyaan dan jawabannya berdasarkan paragraf berikut.

Konteks:
{context}

Format output:
Q: <pertanyaan>
A: <jawaban>
"""

response = ai.generate_text(prompt)
print(response)

Ada pula variasi lain yang menghasilkan lima pasang pertanyaan dan jawaban dengan format bernomor, serta versi yang menghasilkan output JSON dengan struktur:

[
  {"question": "...", "answer": "..."},
  {"question": "...", "answer": "..."},
  {"question": "...", "answer": "..."}
]

Teknik seperti ini berguna untuk membuat bank soal, kuis, atau daftar pertanyaan wawancara dari satu paragraf sumber tanpa menulis semuanya secara manual. Berikut contoh kode dan luaran yang menghasilkan pertanyaan dan jawaban yang dibuat oleh model berdasarkan konteks berbeda dengan sebelumnya, yaitu tentang sejarah perjuangan bangsa Indonesia.

context = """
Selama lebih dari tiga setengah abad, bangsa Indonesia ...
"""

prompt = f"""
Buatkan 3 pertanyaan dan jawabannya berdasarkan paragraf berikut.
Hasilkan dalam format JSON seperti:

[
  {{"question": "...", "answer": "..."}},
  {{"question": "...", "answer": "..."}},
  {{"question": "...", "answer": "..."}}
]

Paragraf:
{context}
"""

print(ai.generate_text(prompt))

Use Case 4 – Analisis Sentimen

Notebook juga memuat dua jenis analisis sentimen: sentimen per kalimat dan sentimen berbasis aspek (Aspect-Based Sentiment Analysis / ABSA).

4.1 Analisis sentimen kalimat per kalimat

Contoh pertama menggunakan beberapa kalimat ulasan dalam bahasa Indonesia. Model diminta mengklasifikasikan sentimen setiap kalimat sebagai “positif”, “netral”, atau “negatif” dan mengembalikan hasilnya dalam format JSON:

from google.colab import ai

texts = [
    "Pelayanan di restoran ini sangat ramah dan makanannya enak sekali!",
    "Pengiriman barangnya terlambat dua hari dan tanpa konfirmasi. Mengecewakan.",
    "Aplikasinya cukup bagus, tapi kadang masih ada bug yang mengganggu.",
    "Saya sangat puas dengan kualitas produk ini. Recommended!",
    "Tempatnya sulit dicari, tapi suasananya nyaman."
]

prompt = f"""
Lakukan analisis sentimen pada daftar kalimat berikut.
Kelas sentimen: "positif", "netral", atau "negatif".

Berikan hasil dalam format JSON list seperti:
[
  {{"text": "...", "sentiment": "..."}},
  ...
]

Daftar kalimat:
{texts}
"""

response = ai.generate_text(prompt)
print(response)

Output JSON ini dapat diproses lebih lanjut, misalnya diubah menjadi DataFrame untuk visualisasi atau analisis statistik sederhana terhadap opini pengguna.

4.2 Aspect-Based Sentiment Analysis (ABSA)

Contoh berikutnya melangkah lebih jauh dengan melakukan analisis sentimen berbasis aspek. Setiap ulasan bisa memuat beberapa aspek sekaligus (makanan, pelayanan, harga, tampilan aplikasi, performa, lokasi, dll.). Model diminta untuk:

1. Menemukan aspek-aspek penting dalam tiap ulasan.

2. Menentukan sentimen untuk tiap aspek.

3. Mengembalikan hasil dalam format JSON.

from google.colab import ai

reviews = [
    "Makanannya enak tapi pelayanannya lambat, dan harganya agak mahal.",
    "Aplikasi ini tampilannya bagus dan mudah dipakai, tapi sering crash.",
    "Hotel nyaman dan lokasinya strategis, tapi kebersihannya kurang.",
    "Kualitas produk sangat baik, pengemasan rapi, dan harga cukup terjangkau.",
    "Tempatnya luas dan parkirnya gampang, tapi antriannya panjang sekali."
]

prompt = f"""
Lakukan Analisis Sentimen Multi-Aspek (Aspect-Based Sentiment Analysis)
 pada daftar ulasan berikut.

Instruksi:
1. Temukan aspek-aspek penting dalam tiap ulasan (misalnya: makanan, pelayanan,
   harga, kualitas, kebersihan, tampilan aplikasi, performa, lokasi, dll.)
2. Tentukan sentimen untuk tiap aspek: "positif", "netral", atau "negatif".
3. Keluarkan hasil dalam format JSON list, struktur:

[
  {{
    "text": "...",
    "aspects": [
      {{"aspect": "...", "sentiment": "..."}},
      ...
    ]
  }},
  ...
]

Daftar ulasan:
{reviews}
"""

response = ai.generate_text(prompt)
print(response)

Pendekatan ini cukup dekat dengan kebutuhan dunia nyata, misalnya untuk menganalisis ulasan restoran, hotel, aplikasi, atau produk. Hasilnya bisa dipakai untuk melihat aspek mana yang paling sering dipuji atau dikritik.

Use Case 5 – Penilaian Jawaban dengan Gemini

Bagian terakhir notebook memperlihatkan bagaimana google.colab.ai dapat membantu menilai jawaban berbentuk teks. Di sini model diposisikan sebagai evaluator yang memberikan penilaian awal dan komentar, sementara keputusan akhir tetap berada di tangan pengguna.

5.1 Penilaian multi-soal dan multi-jawaban

Di notebook, disiapkan beberapa soal tentang machine learning beserta jawaban dari beberapa orang. Prompt kemudian meminta model untuk:

• Menilai setiap jawaban berdasarkan ketepatan konsep, kejelasan, dan relevansi.

• Memberikan skor 0–100 untuk setiap soal.

• Menulis komentar singkat per soal.

• Menghasilkan ringkasan nilai akhir dalam format JSON.

Dengan cara ini, AI dapat membantu memberi gambaran awal kualitas jawaban. Output-nya bisa dipakai untuk diskusi, review, atau sekadar bahan refleksi pribadi bagi penjawab.

5.2 Penilaian dengan rubrik terstruktur (3 aspek)

Versi lanjutan di notebook menggunakan rubrik yang lebih jelas: Ketepatan Konsep, Kejelasan Penjelasan, dan Relevansi. Model diminta untuk:

• Memberikan nilai 0–100 untuk setiap aspek.

• Menghitung skor per soal sebagai rata-rata dari tiga aspek.

• Menghitung skor total sebagai rata-rata seluruh soal.

• Menyertakan komentar singkat untuk setiap jawaban.

Luarannya berupa JSON yang cukup informatif, sehingga mudah dibaca maupun diproses lebih lanjut (misalnya untuk membuat laporan atau visualisasi). Pendekatan ini menunjukkan bagaimana AI dapat membantu menerapkan rubrik penilaian dengan cara yang konsisten dan terstruktur.

Tips Praktis Menggunakan google.colab.ai

Beberapa tips praktis saat bereksperimen dengan google.colab.ai di Google Colab:

• Mulai dari contoh yang dekat dengan konteks sehari-hari. Misalnya Pancasila, sejarah Indonesia, atau kasus di sekitar lingkungan sendiri.

• Eksperimen dengan berbagai prompt. Ubah instruksi, gaya bahasa, atau format luaran, lalu lihat bagaimana hasilnya berubah.

• Selalu lakukan pengecekan kritis. Luaran model bisa keliru, bias, atau terlalu percaya diri. Anggap sebagai asisten yang membantu, bukan sumber kebenaran mutlak.

• Manfaatkan format terstruktur. Saat memungkinkan, minta luaran dalam bentuk terstruktur, misal JSON, agar mudah diolah lebih lanjut di Python atau aplikasi lain.

Kesimpulan

Library google.colab.ai membuka peluang besar untuk memanfaatkan model Gemini langsung dari Google Colab, bahkan bagi pengguna gratis. Dengan satu baris import, berbagai skenario dapat dicoba, antara lain:

• Tanya jawab dan penjelasan konsep

• Konversi bahasa alami ke SQL (Text2SQL)

• Named Entity Recognition dan Question Answering berbasis konteks

• Analisis sentimen dan aspect-based sentiment

• Penilaian jawaban teks dengan rubrik terstruktur

Notebook contoh yang menjadi dasar tulisan ini dapat dikembangkan menjadi berbagai eksperimen lain: integrasi dengan aplikasi web, analisis data teks, pembuatan konten otomatis, dan banyak lagi. Dengan pendekatan ini, AI bukan hanya topik yang dibicarakan, tetapi juga alat praktis yang membantu menyelesaikan pekerjaan sehari-hari.

Fail notebook dapat diakses dan dijalankan di tautan berikut:

https://colab.research.google.com/drive/1qA-b1gRhVereJAmWbOmKlHrPqytLg9ND?usp=sharing

Repository:

https://github.com/Galih-Hermawan-Unikom/google-colab-ai

1. Pendahuluan

Apa itu Google Gemini?

Google Gemini adalah model AI terbaru dari Google yang dirancang untuk mempermudah pengembangan interaksi berbasis teks dan multimedia di berbagai aplikasi. Dengan Gemini API, yang terintegrasi dalam layanan Vertex AI, Anda dapat membuat aplikasi canggih yang mendukung dialog interaktif, seperti percakapan berlanjut serta kemampuan menerima masukan dalam berbagai format, mulai dari teks, gambar, hingga audio, dan menghasilkan luaran yang relevan [1][5].

Keunggulan API Google Gemini untuk Dialog Interaktif.

1. Percakapan yang Lebih Alami: Gemini API memungkinkan pembuatan percakapan yang terasa lebih alami dan dinamis dengan mengelola status percakapan secara otomatis. Pengembang tidak perlu lagi repot menyimpan riwayat percakapan secara manual, sehingga lebih efisien [2][5].

2. Dukungan Multimodal: Dengan kemampuan untuk menerima masukan dalam berbagai format, Gemini API memungkinkan pengguna berinteraksi melalui teks, gambar, atau fail multimedia lainnya. Hal ini membuat pengalaman interaksi menjadi lebih kaya dan variatif [3][5][7].

3. Integrasi yang Mudah: Gemini API dilengkapi dengan SDK untuk berbagai platform seperti Android, iOS, dan web, memudahkan pengembang untuk mengintegrasikan fungsionalitas canggih ini ke dalam aplikasi mereka. Juga mendukung panggilan fungsi untuk menghubungkan model AI dengan sistem eksternal lainnya [2][5][8].

4. Kemampuan Penyesuaian yang Fleksibel: Pengembang dapat menyesuaikan berbagai pengaturan model, seperti temperatur dan batas token luaran, serta mengatur opsi keamanan untuk memastikan respons yang lebih sesuai dengan kebutuhan aplikasi [2][5].

Manfaat bagi Pembelajar Pemula.

1. Akses ke Teknologi Terkini: Dengan mempelajari Google Gemini, pemula mendapatkan kesempatan untuk mengenal dan memanfaatkan teknologi AI generatif terbaru yang sangat relevan dengan perkembangan industri saat ini [1][6].

2. Pengembangan Keterampilan Praktis: Menggunakan API ini, pemula bisa belajar cara membuat aplikasi interaktif yang menarik, sekaligus meningkatkan keterampilan pemrograman mereka lewat proyek nyata yang dapat langsung diterapkan [3][6].

3. Dukungan Komunitas dan Sumber Daya: Google menyediakan dokumentasi yang lengkap dan contoh kode yang jelas, sehingga memudahkan pemula untuk mulai belajar dan mendapatkan bantuan jika diperlukan [4][5].

4. Peluang Karier: Menguasai teknologi seperti Gemini API bisa membuka berbagai peluang karier di dunia pengembangan perangkat lunak, terutama di bidang aplikasi berbasis AI dan pembelajaran mesin [6].

2. Persiapan Awal

Sebelum mulai menggunakan Google Gemini API, ada beberapa langkah persiapan yang perlu Anda lakukan:

1. Membuat Akun Google Cloud Platform (GCP).

   • Kunjungi situs Google Cloud.

   • Daftar atau masuk dengan akun Google Anda.

     

   • Jika belum memiliki akun GCP, Anda akan diminta untuk memasukkan informasi pembayaran. Google memberikan kredit gratis untuk pemula, yang bisa digunakan untuk mencoba layanan mereka.

   • Setelah masuk, buka Google Cloud Console.

     

     Di sini saya menggunakan akun alter Gmail (Iron Man) untuk memulai dari awal, dikarenakan akun utama sudah terdaftar dan punya proyek di GCP.

2. Membuat Proyek Baru

   1. Di halaman Google Cloud Console, klik menu dropdown Select a Project di bagian atas.

   2. Pilih New Project.

      

   3. Isi nama proyek sesuai kebutuhan Anda (misalnya, "Proyek Gemini API").

      

   4. Klik Create untuk membuat proyek baru. Tunggu beberapa saat hingga proyek selesai dibuat, lalu pastikan proyek tersebut terpilih di dropdown proyek.

      

3. Mengaktifkan API Google Gemini.

   • Pastikan proyek baru Anda sudah dipilih di Google Cloud Console.

   • Di menu sebelah kiri, buka API & Services, lalu klik Library.

     

   • Ketik "Google Gemini API" di kolom pencarian dan tekan Enter.

     

   • Pilih Google Gemini API dari hasil pencarian, lalu klik tombol Enable untuk mengaktifkan API.

     

4. Menyiapkan Kredensial API (API Key).

   • Setelah API diaktifkan, buka menu "API & Services" dan pilih "Credentials".

     

   • Klik tombol "Create Credentials" dan pilih "API Key".

     

   • Salin API Key yang dihasilkan dan simpan dengan aman, karena Anda akan menggunakannya untuk mengakses API Google Gemini dalam aplikasi Anda.

     

Dengan langkah-langkah ini selesai, Anda sudah siap untuk mulai mengintegrasikan Google Gemini API ke dalam proyek Anda.

3. Dasar Pemrograman API Google Gemini

1. Instalasi Perangkat Lunak yang Diperlukan.

   • Python: Pastikan Python versi terbaru (minimal versi 3.8) telah terinstal di sistem Anda. Jika belum, Anda dapat mengunduhnya dari python.org.

   • Pustaka google-generativeai:
     Pustaka ini dirancang khusus untuk berinteraksi dengan layanan model generatif seperti Google Gemini. Instal pustaka ini dengan perintah berikut di terminal:

       pip install -q -U google-generativeai
     

   • Perintah pip install -q -U google-generativeai digunakan untuk menginstal atau memperbarui paket Python bernama google-generativeai ke versi terbaru. Opsi -q membuat proses instalasi berjalan dengan luaran minimal, sementara -U memastikan paket diperbarui jika versi yang lebih baru tersedia.

2. Kode Dasar untuk Koneksi.

   • Berikut adalah contoh sederhana membuat koneksi ke Gemini API dan mengirim permintaan untuk menghasilkan teks:

       import google.generativeai as genai  
     
       # Token API ditulis langsung di sini untuk kemudahan (tidak disarankan untuk produksi)  
       API_KEY = "API_KEY_ANDA"  
     
       # Konfigurasikan API Key Anda
       genai.configure(api_key=API_KEY)
     
       # Inisialisasi model
       model = genai.GenerativeModel('gemini-1.5-flash')
     
       # Pertanyaan atau instruksi
       prompt = "Jelaskan tentang kecerdasan buatan secara singkat!"
     
       # Mendapatkan respons
       respons = model.generate_content(prompt)
     
       # Menampilkan hasilnya
       print("Prompt:", prompt)
       print("\nJawaban:", respons.text)
     

   • Berikut contoh luaran dari kode di atas:

     

3. Saran Keamanan

• Menyertakan API Key secara langsung dalam kode adalah metode yang praktis untuk belajar, tetapi kurang aman jika proyek ini dipublikasikan, misalnya ke GitHub.
  Untuk praktik yang lebih baik, pertimbangkan menyimpan API Key di tempat aman seperti:

  • File konfigurasi yang tidak diunggah ke repositori (misalnya .env).

  • Parameter lingkungan (environment variables).

  • Layanan penyimpanan rahasia, seperti Google Secret Manager atau AWS Secrets Manager.

• Dengan cara ini, API Key Anda akan terlindungi dari risiko akses yang tidak diinginkan.

4. Kemampuan Gemini AI Lainnya.

• Membuat teks dari masukan berupa teks dan gambar.

  Mengacu ke halaman Gemini Api Docs, disebutkan bahwa Gemini API mendukung data masukan multimodal yang menggabungkan teks dengan fail media.

• Pertama-tama, Instal modul pillow untuk keperluan pengolahan citra.

pip install pillow

• Siapkan gambar dalam sebuah folder, misal: folder gambar, di dalamnya ada fail kabah.jpg.

  

  Sumber gambar: https://unsplash.com/photos/kaaba-praying-ground-JFirQekVo3U

• Berikut ini contoh kodenya:

•     import google.generativeai as genai  
      import PIL.Image
  
      # Token API ditulis langsung di sini untuk kemudahan (tidak disarankan untuk produksi)  
      API_KEY = "API_KEY_ANDA"  
  
      # Konfigurasikan API Key Anda
      genai.configure(api_key=API_KEY)
  
      # Inisialisasi model
      model = genai.GenerativeModel('gemini-1.5-flash')
  
      # Tentukan alamat dan nama fail gambar (Perhatikan penulisan alamat relatif atau absolut).
      # Fungsi PIL di sini digunakan untuk membuka gambar dari file.
      gambar = PIL.Image.open("./gambar/kabah.jpg")
  
      # Fungsi ini digunakan untuk menghasilkan konten berdasarkan input yang diberikan.
      response = model.generate_content(["Buatlah deskripsi mengenai gambar ini!", gambar])
  
      print(response.text)
  

• Dan ini adalah luaran yang dihasilkan:

  

  Catatan: Fitur ini mengandalkan kemampuan model untuk menggabungkan pengolahan bahasa alami dan pengenalan gambar, meskipun di dokumentasi resmi Google Gemini lebih fokus pada generasi teks dan bukan pengolahan gambar langsung (sehingga penanganan gambar secara eksplisit mungkin memerlukan langkah-langkah tambahan).

• Dialog Interaktif.

  Dialog interaktif memanfaatkan kemampuan Gemini AI untuk mempertahankan konteks percakapan, memungkinkan pengembang membuat aplikasi yang dapat berkomunikasi secara berkesinambungan dengan memori dialog yang dinamis.

• Contoh kode:

    import google.generativeai as genai
  
    # Token API ditulis langsung di sini untuk kemudahan (tidak disarankan untuk produksi)  
    API_KEY = "API_KEY_ANDA"  
  
    # Konfigurasikan API Key Anda
    genai.configure(api_key=API_KEY)
  
    # Inisialisasi model
    model = genai.GenerativeModel('gemini-1.5-pro')
  
    # Memulai chat dengan history kosong
    chat = model.start_chat(history=[])
  
    def lakukan_dialog():
        print("Mulai dialog dengan Gemini AI (ketik 'keluar' untuk mengakhiri)")
  
        while True:
            # Input pengguna
            pertanyaan = input("\nAnda: ")
  
            # Cek apakah ingin keluar
            if pertanyaan.lower() == 'keluar':
                print("Dialog berakhir.")
                break
  
            # Kirim pertanyaan dan dapatkan respons
            respons = chat.send_message(pertanyaan)
  
            # Tampilkan respons
            print("\nGemini:", respons.text)
  
    # Jalankan dialog
    if __name__ == "__main__":
        lakukan_dialog()
  

• Berikut ini contoh luaran kode dan sedikit dialog yang saya lakukan.

  

  Catatan Penting: Kode-kode sebelumnya sengaja dibuat sederhana dan belum mencakup praktik terbaik seperti penanganan kesalahan (error handling), validasi input, atau konfigurasi lanjutan. Dalam pengembangan aplikasi nyata, Anda perlu menambahkan mekanisme:

  • Penanganan exception.

  • Validasi API key.

  • Pembatasan token.

  • Penanganan timeout.

  • Logging kesalahan.

8. Kesimpulan dan Langkah Lanjutan

• Google Gemini API membuka pintu lebar bagi pengembang untuk memanfaatkan kecerdasan buatan mutakhir dalam berbagai aplikasi. Dari dialog interaktif hingga pengolahan kompleks, API ini menawarkan fleksibilitas dan kemampuan yang luar biasa. Dengan terus berkembangnya teknologi AI, Gemini API memberikan fondasi kuat bagi inovasi di bidang pemrosesan bahasan, analisis, dan interaksi cerdas. Pengembang disarankan untuk terus mengeksplorasi kemampuan API, mengikuti perkembangan terbaru, dan secara kreatif menerapkannya dalam berbagai solusi teknologi.

• Kesimpulan ini mencakup beberapa poin penting:

  • Potensi luas Google Gemini API

  • Fleksibilitas teknologi

  • Anjuran untuk eksplorasi berkelanjutan

  • Perspektif optimistis tentang masa depan teknologi AI.

9. Lampiran

• Kode sumber lengkap proyek.

  https://github.com/galihboy/Proyek_Gemini_Api

• Referensi.

  [1] https://cloud.google.com/vertex-ai/generative-ai/docs/samples/generativeaionvertexai-gemini-multiturn-chat?hl=id

  [2] https://firebase.google.com/docs/vertex-ai/chat?hl=id

  [3] https://codelabs.developers.google.com/codelabs/gemini-workspace?hl=id

  [4] https://developers.google.com/idx/support/release-notes?hl=id

  [5] https://firebase.google.com/docs/vertex-ai/gemini-api?hl=id

  [6] https://ai.google.dev/competition/projects/slovo-ai?hl=id

  [7] https://developers.google.com/workspace/chat/tutorial-contact-app?hl=id

  [8] https://cloud.google.com/vertex-ai/generative-ai/docs/samples/generativeaionvertexai-gemini-function-calling-chat?hl=id

JSON adalah singkatan dari JavaScript Object Notation. JSON adalah format data yang populer untuk pertukaran data antar aplikasi. JSON adalah format data yang ringan dan mudah dibaca oleh manusia, dan dapat dengan mudah dikonversi ke format data lain seperti XML atau CSV.

Keuntungan menggunakan JSON sebagai media penyimpanan

Ada beberapa keuntungan menggunakan JSON sebagai media penyimpanan, antara lain:

• Ringkas dan mudah dibaca

• Terstruktur

• Lebih mudah diakses oleh aplikasi

• Dapat dikonversi ke format data lain

Contoh penggunaan JSON sebagai media penyimpanan

JSON dapat digunakan untuk menyimpan berbagai jenis data, seperti:

• Data pengguna

• Data barang

• Data transaksi

• Data konfigurasi

• Data log

Kelemahan menggunakan JSON sebagai media penyimpanan

Ada beberapa kelemahan menggunakan JSON sebagai media penyimpanan, antara lain:

• Tidak dapat menyimpan data biner

• Tidak dapat menyimpan data yang sangat kompleks

Secara keseluruhan, JSON adalah format data yang baik untuk digunakan sebagai media penyimpanan. JSON adalah format data yang ringkas, mudah dibaca, dan terstruktur. JSON juga lebih mudah diakses oleh aplikasi dan dapat dikonversi ke format data lain.

Contoh Data JSON

Berikut adalah contoh data format JSON yang sederhana:

{
  "nama": "Fulan Fulanah",
  "usia": 20,
  "alamat": "Jl. Jendral Sudirman No. 1, Bandung"
}

Data JSON ini menggambarkan informasi pribadi seseorang. Data ini terdiri dari tiga properti:

• nama adalah properti string yang menyimpan nama seseorang.

• usia adalah properti integer yang menyimpan usia seseorang.

• alamat adalah properti string yang menyimpan alamat seseorang.

Berikut adalah contoh lain dari data format JSON yang sederhana dan mudah dipahami:

[
  {
    "kode": 1,
    "nama": "Pensil",
    "harga": 2000
  },
  {
    "kode": 2,
    "nama": "Penghapus",
    "harga": 1000
  },
  {
    "kode": 3,
    "nama": "Penggaris",
    "harga": 1500
  },
  {
    "kode": 4,
    "nama": "Ballpoint",
    "harga": 5000
  }
]

Data JSON ini menggambarkan daftar barang. Data ini terdiri dari array (larik) yang berisi empat objek JSON. Setiap objek JSON memiliki tiga properti:

• kode adalah properti integer yang menyimpan kode barang.

• nama adalah properti string yang menyimpan nama barang.

• harga adalah properti integer yang menyimpan harga barang.

Untuk selanjutnya kita anggap data ini disimpan dalam sebuah fail bernama barang.json.

Berikut contoh data JSON terkait informasi pribadi yang sedikit lebih rumit.

[
  {
    "nama": "Fulan Fulanah",
    "usia": 30,
    "alamat": {
      "jalan": "Jl. Jendral Sudirman No. 1",
      "kota": "Bandung",
      "provinsi": "Jawa Barat"
    },
    "hobi": ["Membaca", "Menulis", "Bermain Gitar"]
  },
  {
    "nama": "Asep",
    "usia": 25,
    "alamat": {
      "jalan": "Jl. Medan Merdeka Barat No. 1",
      "kota": "Jakarta",
      "provinsi": "DKI Jakarta"
    },
    "hobi": ["Olahraga", "Memasak", "Wisata"]
  }
]

Dalam contoh di atas, saya menyimpan data untuk dua orang dalam bentuk larik (array). Setiap objek dalam array mewakili satu orang dengan properti "nama", "usia", "alamat", dan "hobi" yang sesuai.

Dalam struktur JSON yang diberikan, "jalan", "kota", dan "provinsi" adalah bagian dari properti "alamat". Item-item ini merupakan kunci atau nama properti yang mewakili informasi tentang alamat seseorang.

Untuk selanjutnya kita anggap data ini disimpan dalam sebuah fail bernama orang.json.

Secara umum, data JSON ini mudah dipahami karena strukturnya sederhana dan mudah dibaca. Data JSON ini juga mudah diakses oleh aplikasi karena menggunakan format data yang standar.

Pemrograman: Mengakses Data

Baiklah, berikut adalah kode Python secara bertahap untuk membaca data fail JSON:

Tahap 1: Mengimpor modul JSON

Pertama-tama, kita perlu mengimpor modul JSON ke dalam kode kita. Modul JSON menyediakan fungsi-fungsi untuk membaca dan menulis data JSON.

import json

Tahap 2: Membuka fail JSON

Selanjutnya, kita perlu membuka fail JSON yang ingin kita baca. Kita dapat menggunakan fungsi open() untuk membuka fail JSON.

with open("barang.json", "r") as f:

Argumen pertama dari fungsi open() adalah nama fail JSON yang ingin kita buka. Argumen kedua adalah mode r yang berarti kita akan membuka fail JSON dalam mode baca.

Tahap 3: Membaca data JSON

Setelah fail JSON dibuka, kita dapat membaca data JSON menggunakan fungsi json.load(). Fungsi json.load() mengembalikan objek Python yang berisi data JSON.

barang = json.load(f)

Tahap 4: Mencetak data JSON

Setelah data JSON dibaca, kita dapat mencetak data JSON menggunakan fungsi print().

print(barang)

Output dari kode Python tersebut adalah sebagai berikut:

[{'kode': 1, 'nama': 'Pensil', 'harga': 2000}, {'kode': 2, 'nama': 'Penghapus', 'harga': 1000}, {'kode': 3, 'nama': 'Penggaris', 'harga': 1500}, {'kode': 4, 'nama': 'Ballpoint', 'harga': 5000}]

Jika ingin menampilkan data dengan format lebih rapi, bisa dicoba dengan memberikan indentasi dari setiap objek dan itemnya. Contohnya seperti ini.

print(json.dumps(barang, indent=4))

Baris kode tersebut akan mencetak data JSON dalam format yang lebih mudah dibaca. Fungsi json.dumps() digunakan untuk mengkonversi data Python ke format JSON. Argumen pertama dari fungsi json.dumps() adalah data Python yang ingin dikonversi. Argumen kedua adalah opsi indent, yang menentukan jumlah spasi yang digunakan untuk indentasi data JSON.

Dalam kasus ini, kita menggunakan opsi indent=4 untuk membuat indentasi dengan empat spasi.

Luarannya seperti ini.

[
    {
        "kode": 1,
        "nama": "Pensil",
        "harga": 2000
    },
    {
        "kode": 2,
        "nama": "Penghapus",
        "harga": 1000
    },
    {
        "kode": 3,
        "nama": "Penggaris",
        "harga": 1500
    },
    {
        "kode": 4,
        "nama": "Ballpoint",
        "harga": 5000
    }
]

Tahap 5: Menyaring barang dengan harga di atas 2000

Kita dapat menggunakan kode Python berikut untuk menyaring barang dengan harga lebih besar atau sama dengan 2000:

# Cari semua barang dengan harga lebih besar atau sama dengan 2000
barang_mahal = []
for item in barang:
    if item["harga"] >= 2000:
        barang_mahal.append(item)

# Cetak daftar barang mahal
print(barang_mahal)

Luaran dari kode Python tersebut adalah sebagai berikut:

[
    {
        "kode": 1,
        "nama": "Pensil",
        "harga": 2000
    },
    {
        "kode": 4,
        "nama": "Ballpoint",
        "harga": 5000
    }
]

Kode Python ini menggunakan perulangan for untuk iterasi melalui semua objek JSON dalam daftar barang. Untuk setiap objek JSON, kode ini memeriksa properti harga. Jika nilai properti harga lebih besar atau sama dengan 2000, maka kode ini menambahkan objek JSON tersebut ke dalam daftar barang_mahal.

Kode Python lengkap

Berikut adalah kode Python lengkap untuk membaca data fail JSON:

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Tampilan standar
print(barang)

# Tampilan yang lebih rapi/cantik dengan indentasi 4
print(json.dumps(barang, indent=4))

# Cari semua barang dengan harga di atas 2000
barang_mahal = []
for item in barang:
    if item["harga"] >= 2000:
        barang_mahal.append(item)

# Cetak daftar barang mahal
#print(barang_mahal)
print(json.dumps(barang_mahal, indent=4))

Kode Python ini adalah gabungan dari semua tahap yang telah kita bahas sebelumnya.

Pemrograman: Menambah Data

Untuk melakukan penambahan data, pertama-tama kita siapkan sebuah contoh data (objek) sebagai berikut.

{
    "kode": 5,
    "nama": "Buku",
    "harga": 10000
}

Kode Python untuk menambah data secara lengkap adalah sebagai berikut.

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Tambahkan data barang baru
barang.append({
    "kode": 5,
    "nama": "Buku",
    "harga": 10000
})

# Simpan data barang yang telah diubah
with open("barang.json", "w") as f:
    json.dump(barang, f)

Kode Python ini akan menambah data barang baru ke fail JSON barang.json. Data barang baru memiliki kode 5, nama "Buku", dan harga 10000.

Beberapa kode yang perlu dijelaskan selain yang pernah dibahas sebelumnya adalah:

• barang.append({}): digunakan untuk menambahkan data barang baru ke daftar barang.

• { "kode": 5, "nama": "Buku", "harga": 10000 } adalah data barang baru yang akan ditambahkan.

• with open("barang.json", "w") as f: digunakan untuk membuka fail JSON barang.json dalam mode tulis.

• json.dump(barang, f): digunakan untuk menulis data JSON dari variabel barang ke fail barang.json.

Jika fail json dibaca dan ditampilkan secara keseluruhan akan memunculkan lima objek, dengan tambahan barang terbaru yang baru saja ditambahkan.

Pemrograman: Mencari Data

Dalam bagian akan menambahkan contoh pencarian data barang berdasarkan kode dan nama. Untuk pencarian harga sudah dicontohkan dalam bagian akhir Membaca Data.

Berikut adalah contoh kode untuk mencari data barang berdasarkan kode:

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Cari barang dengan kode 1
for item in barang:
    if item["kode"] == 1:
        print(item)

Adapun untuk mencari barang berdasarkan nama, potongan kodenya adalah sebagai berikut.

# Cari barang dengan nama "Pensil"
for item in barang:
    if item["nama"] == "Pensil":
        print(item)

Untuk membuat pencarian nama barang lebih dinamis, potongan kodenya adalah sebagai berikut.

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Cari barang yang namanya mengandung huruf/kata "peng" (tanpa memperhatikan huruf besar atau kecil)
barang_cari = []
kataCari = "peng"

for item in barang:
    if kataCari.lower() in item["nama"].lower():
        barang_cari.append(item)

# Cetak daftar barang pensil
print(barang_cari)

Sedikit penjelasan beberapa bagian dari kode tersebut adalah:

• barang_cari = []: digunakan untuk membuat daftar barang yang namanya mengandung huruf atau kata "peng".

• kataCari = "peng": digunakan untuk menentukan huruf atau kata yang akan dicari.

• for item in barang: digunakan untuk iterasi melalui semua data barang dalam variabel barang.

• kataCari.lower() in item["nama"].lower() digunakan untuk memeriksa apakah huruf atau kata "peng" terdapat di dalam nama barang, dengan huruf kecil.

• barang_cari.append(item): digunakan untuk menambahkan data barang tersebut ke dalam daftar barang_cari.

• print(barang_cari): digunakan untuk mencetak daftar barang yang namanya mengandung huruf atau kata "peng".

Contoh luaran dari kode tersebut di atas adalah:

[
    {
        "kode": 2,
        "nama": "Penghapus",
        "harga": 1000
    },
    {
        "kode": 3,
        "nama": "Penggaris",
        "harga": 1500
    }
]

Pemrograman: Mengubah Data

Untuk mencontohkan pengubahan atau pembaruan data, kita buat contoh mengubah data barang yang kodenya 5, nama "Buku", harga 10000 menjadi nama baru "Buku Tulis", harga baru 15000.

Kodenya adalah sebagai berikut.

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Cari data barang dengan kode 5
for item in barang:
    if item["kode"] == 5:
        # Ubah nama dan harga
        item["nama"] = "Buku Tulis"
        item["harga"] = 15000

# Simpan data barang yang telah diubah
with open("barang.json", "w") as f:
    json.dump(barang, f)

# Cetak daftar barang
print(barang)

Beberapa penjelasan hanya di bagian penting:

• for item in barang: digunakan untuk iterasi melalui semua data barang dalam variabel barang.

• if item["kode"] == 5: digunakan untuk memeriksa apakah kode barang yang sedang diproses sama dengan 5.

• item["nama"] = "Buku Tulis" digunakan untuk mengubah nama barang.

• item["harga"] = 15000 digunakan untuk mengubah harga barang.

• with open("barang.json", "w") as f: digunakan untuk membuka file barang.json dalam mode penulisan.

• json.dump(barang, f) digunakan untuk menyimpan data barang ke file barang.json.

• print(barang): digunakan untuk mencetak daftar barang.

Kode alternatif untuk mengubah data barang adalah sebagai berikut.

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Cari data barang dengan kode 5
data_barang = barang[barang.index({"kode": 5})]

# Ubah nama dan harga
data_barang["nama"] = "Buku Tulis"
data_barang["harga"] = 15000

# Ganti data barang yang telah diubah
barang[barang.index({"kode": 5})] = data_barang

# Simpan data barang yang telah diubah
with open("barang.json", "w") as f:
    json.dump(barang, f)

# Cetak daftar barang
print(barang)

Kode ini akan melakukan langkah-langkah yang sama dengan kode sebelumnya, tetapi dengan cara yang lebih singkat.

Berikut adalah penjelasan lebih rinci tentang kode tersebut:

• barang[barang.index({"kode": 5})] digunakan untuk mengambil data barang dengan kode 5.

• data_barang["nama"] = "Buku Tulis" digunakan untuk mengubah nama barang.

• data_barang["harga"] = 15000 digunakan untuk mengubah harga barang.

• barang[barang.index({"kode": 5})] = data_barang digunakan untuk mengganti data barang yang telah diubah.

Output dari kode tersebut adalah sebagai berikut:

[{'kode': 1, 'nama': 'Pensil', 'harga': 2000}, {'kode': 2, 'nama': 'Penggaris', 'harga': 5000}, {'kode': 3, 'nama': 'Rautan', 'harga': 1000}, {'kode': 4, 'nama': 'Ballpoint', 'harga': 5000}, {'kode': 5, 'nama': 'Buku Tulis', 'harga': 15000}]

Pemrograman: Menghapus Data

Untuk menghapus data, mekanismenya mirip dengan mengubah data. Bedanya, data barang yang dicari akan dihapus dari fail JSON.

Berikut contoh kode untuk menghapus data barang dengan kode 5.

import json

with open("barang.json", "r") as f:
    barang = json.load(f)

# Cari data barang dengan kode 5
for item in barang:
    if item["kode"] == 5:
        # Hapus data barang
        barang.remove(item)

# Simpan data barang yang telah dihapus
with open("barang.json", "w") as f:
    json.dump(barang, f)

# Cetak daftar barang
print(barang)

Poin penting menghapus data adalah pada kode ini.

• barang.remove(item): digunakan untuk menghapus data barang dari daftar.

Alternatif lainnya seperti pada kode mengubah data sebelumnya adalah:

# Cari data barang dengan kode 5
data_barang = barang[barang.index({"kode": 5})]

# Hapus data barang
barang.remove(data_barang)

Penutup

Selamat, Anda telah menyelesaikan tutorial tentang membaca, mencari, menambah, mengubah, dan menghapus data di file JSON menggunakan Python. Sekarang, Anda dapat menggunakan keterampilan ini untuk mengembangkan berbagai aplikasi yang membutuhkan penyimpanan dan pengelolaan data dalam format JSON.

Berikut adalah beberapa tips untuk mengembangkan aplikasi berbasis JSON:

• Gunakan struktur JSON yang sesuai dengan kebutuhan aplikasi Anda.

• Gunakan metode JSON yang tepat untuk membaca dan menulis data JSON.

• Validasi data JSON sebelum menggunakannya.

• Gunakan library JSON pihak ketiga untuk memudahkan pengembangan aplikasi Anda.

Berikutnya akan saya tuliskan tutorial mengemas aplikasi pengelolaan fail JSON dalam format online atau versi website.

Repositori kode dalam tutorial ini ada di:
https://github.com/galihboy/json_crud

Semoga tutorial ini bermanfaat bagi Anda. Tetap semangat belajar dan mengembangkan aplikasi yang bermanfaat!

Ada banyak paket (modul) populer untuk bekerja dengan gambar dalam Python, seperti scikit-image, OpenCV, NumPy, Pillow (PIL), dan lain sebagainya. Dalam artikel ini akan disajikan tutorial pendahuluan dalam menggunakan modul Pillow sering disebut PIL, yang kepanjangan dari Python Imaging LIbrary. Panduan lengkap penggunaan PIL dapat Anda temukan di laman web Pillow ReadTheDocs.

1. Instalasi

Jika Anda belum memasang modul PIL di lingkungan pengembangan Python, maka Anda dapat melakukan pemasangan terlebih dahulu. Berikut ini perintahnya.

python3 -m pip install --upgrade pip
python3 -m pip install --upgrade Pillow

Saat artikel ini ditulis, saya menggunakan Python 3.9 dan Pillow 8.4.0.

2. Menampilkan Gambar

Dalam bagian ini akan saya demokan cara menampilkan gambar dengan 3 cara berbeda. Terdapat 3 urutan utama yang yang harus dilakukan, yaitu (1) impor metode atau fungsi Image pada modul PIL, (2) memuatkan fail gambar pada sebuah variabel, dan (3) menampilkan isi variabel (data gambar) ke layar.

Gambar yang saya gunakan diambil dari Unsplash@sharonp.

from PIL import Image
gambar = Image.open('sharon-pittaway-iMdsjoiftZo-unsplash.jpg')

Anda juga dapat meletakkan nama fail gambar dalam sebuah variabel.

from PIL import Image
nama_fail = 'sharon-pittaway-iMdsjoiftZo-unsplash.jpg'
gambar = Image.open(nama_fail)

Penulisan nama fail yang disertai alamat jalur (path) lengkap sebaiknya disertai karakter "r" yang berarti "raw string". Hal ini umum digunakan untuk menghindari pembacaan karakter tertentu yang dianggap sebagai bagian dari kode (perintah) dalam Python. Contoh penggunaannya adalah sebagai berikut.

gambar = Image.open(r'D:\PythonKu\computer_vision\pil_tuts\sharon-pittaway-iMdsjoiftZo-unsplash.jpg')

Berikutnya adalah cara menampilkan isi variabel ke layar.

a) Menggunakan perintah show.

gambar.show()

Perintah ini akan membuka gambar pada perangkat lunak penampil gambar bawaan (default) di sistem operasi Anda. Kode ini memiliki perilaku yang sama ketika dijalankan di PyCharm, Visual Studio, dan Jupyter Notebook. Khusus untuk PyCharm, di bagian console ternyata menampilkan pesan kesalahan seperti pada gambar ini.

Untuk menanganinya adalah dengan menambahkan perintah import pylab di bagian atas.

b) Menampikan via modul matplotlib.

Jika Anda sudah memasang modul matplotlib, caranya adalah sebagai berikut.

from matplotlib import pyplot as plt
# . . .
plt.imshow(gambar)
plt.show()

Luaran gambar adalah sebagai berikut.

Jika Anda ingin menghilangkan tampilan sumbu horizontal dan vertikalnya, tambahkan perintah plt.axis(False) sebelum menampilkan gambar.

c) Menggunakan perintah Display. Perintah display dapat digunakan khusus dalam Jupyter Notebook. Gambar akan ditampilkan di bagian bawah sel kode.

display(gambar)

3. Menampilkan Informasi Gambar

Beberapa informasi gambar yang dapat Anda lihat adalah ukuran (lebar dan tinggi), mode, format, dan lain-lain. Berikut ini contohnya.

ukuran = gambar.size
print(f'Ukuran gambar: {ukuran}')
lebar, tinggi = ukuran
print(f'Lebar: {lebar}, Panjang: {tinggi}')
print(f'Mode: {gambar.mode}')
print(f'Nama fail: {gambar.filename}')
print(f'Format: {gambar.format}')
print(f'Deskripsi format: {gambar.format_description}')

Contoh luarannya adalah:

Ukuran gambar: (640, 640)
Lebar: 640, Panjang: 640
Mode: RGB
Nama fail: sharon-pittaway-iMdsjoiftZo-unsplash.jpg
Format: JPEG
Deskripsi format: JPEG (ISO 10918)

4. Membaca Nilai Warna (Piksel)

Dalam mode RGB (Red, Green, Blue), setiap piksel akan mengandung 3 buah nilai warna merah (red), hijau (green), dan biru (blue). Sebagai pengingat, bawah kombinasi nilai (0, 0, 0) adalah warna hitam, nilai (255, 255, 255) adalah warna putih, nilai (255, 0, 0) warna merah, nilai (0, 255, 0) warna hijau, nilai (0, 0, 255) warna biru, dan seterusnya.

Perintah utama untuk membaca nilai warna (piksel) pada gambar adalah dengan menggunakan perintah getpixel((i, j)), di mana variabel i menunjukkan baris, dan j adalah kolom.

Jadi, yang kita lakukan berikutnya adalah membaca piksel untuk setiap baris dan kolom dari gambar. Dikarenakan ukuran gambar adalah 640x640, di mana terdapat 640 baris dan 640 kolom, maka akan mengeluarkan 25.600 nilai RGB. Berikut adalah contoh kodenya.

from PIL import Image

gambar = Image.open('sharon-pittaway-iMdsjoiftZo-unsplash.jpg')
lebar, tinggi = gambar.size
for i in range(lebar):
    for j in range(tinggi):
        nilai_piksel = gambar.getpixel((i, j))
        print(nilai_piksel)

Contoh sebagian isi piksel ada pada gambar berikut.

5. Modifikasi Nilai Piksel

Setelah berhasil membaca nilai warna setiap piksel pada gambar, berikutnya kita dapat melakukan manipulasi atau modifikasi nilai sesuai keinginan. Berikut ini akan saya contohkan mengubah nilai warna yang tadinya berwarna (RGB) menjadi warna abu-abu.

Rumus untuk mendapatkan warna abu-abu adalah sebagai berikut.

nilai_abu = (0.299 x red) + (0.587 x green) + (0.114 x blue)

Jadi, nilai warna abu-abu hasil penghitungan rumus di atas akan disimpan di tiga kolom RGB, yang berarti:

nilai_baru = ( int(nilai_abu), int(nilai_abu), int(nilai_abu) )

Fungsi int digunakan untuk memastikan nilai_abu tetap dalam format bilangan genap atau integer. Berikut ini adalah kodenya.

from PIL import Image

gambar = Image.open('sharon-pittaway-iMdsjoiftZo-unsplash.jpg')
lebar, tinggi = gambar.size

# masukkan isi piksel ke dalam daftar_piksel_gambar - format baris x kolom - tuple RGB
daftar_piksel_gambar = gambar.load()

for i in range(lebar):
    for j in range(tinggi):
        # baca piksel dalam format RGB
        r, g, b = gambar.getpixel((i, j))
        # setiap nilai di kolom RGB diubah ke warna keabuan sesuai rumus
        nilai_abu = (0.299*r + 0.587*g + 0.114*g)
        # masukkan warna baru keabuan dalam tuple
        daftar_piksel_gambar[i, j] = (int(nilai_abu), int(nilai_abu), int(nilai_abu))

fail_abu = "gambar_abu-abu.jpg"
# simpan gambar abu-abu ke fail baru
gambar.save(fail_abu)
# tampilkan gambar abu-abu
gambar_abu = Image.open(rf'{fail_abu}')
display(gambar_abu)
# gambar_abu.show()

Contoh luarannya adalah:

Jika Anda tidak menggunakan Jupyter Notebook, gunakan cara penampilan gambar (a) atau (b) pada bahasan nomor 1 sebelumnya.

Cara cepat atau instan adalah dengan mengonversi gambar dari mode 'RGB' ke 'L' (luminance), yang berarti hanya terdiri dari 1 kanal warna saja. Rumus untuk mendapat nilai dalam mode L adalah sebagai berikut [laman web Pillow].

L = R 299/1000 + G 587/1000 + B * 114/1000

6. Mengonversi Gambar ke Hitam Putih

Melanjutkan penjelasan konversi gambar berwarna ke format abu-abu cara instan sebelumnya, yaitu dengan cara menyesuaikan kanal 3 warna (RGB) menjadi 1 warna (L). Kodenya adalah sebagai berikut.

from PIL import Image

gambar = Image.open('sharon-pittaway-iMdsjoiftZo-unsplash.jpg')
gambar_abu = gambar.convert('L')
# gambar_abu.show()
display(gambar_abu)

Hasil dari kode tersebut di atas sama dengan cara manipulasi nilai piksel secara manual pada penjelasan di nomor 5 sebelumnya. Hanya saja, nilai piksel hanya berupa satu nilai mulai dari 0 (menunjukkan warna hitam) s/d 255 (menunjukkan warna putih).

Berikutnya, kita akan membuat gambar yang benar-benar hanya berisi warna hitam atau putih, yaitu 0 atau 255. Kita buat dulu batas ambangnya adalah setengah nilai dari 255, misalnya 128. Jika ada nilai piksel yang di bawah 128, maka kita anggap berwarna hitam (nilai 0). Sebaliknya, jika nilainya lebih besar atau sama dengan 128, maka kita anggap putih (nilai 255). Kodenya adalah sebagai berikut.

from PIL import Image

gambar = Image.open('sharon-pittaway-iMdsjoiftZo-unsplash.jpg')
gambar_abu = gambar.convert('L')
daftar_piksel_gambar = gambar_abu.load()
batas = 128

for i in range(gambar_abu.size[0]):
    for j in range(gambar_abu.size[1]):
        if gambar_abu.getpixel((i, j)) < 128:
            nilai_baru = 0
        else:
            nilai_baru = 255
        daftar_piksel_gambar[i, j] = nilai_baru

fail_hp = "gambar_hitam_putih.jpg"
gambar_abu.save(fail_hp)
gambar_hp = Image.open(fail_hp)
display(gambar_hp)
# gambar_hp.show()

Setelah dilakukan pengubahan nilai piksel, dari daftar piksel gambar selanjutnya disimpan dalam sebuah fail gambar baru yang disimpan dalam variabel fail_hp. Luarannya adalah sebagai berikut.

Cara lain yang sedikit lebih pendek adalah sebagai berikut.

gambar_hitam_putih = gambar_abu.point(lambda x: 0 if x<128 else 255, '1')
gambar_hitam_putih.save("gambar_hitam_putih.jpg")
display(gambar_hitam_putih)

Penentuan nilai piksel dapat dilakukan melalui fungsi .poin di mana di dalamnya disertai fungsi lambda yang bertugas menyeleksi jika suatu nilai di bawah atau di atas batas ambang yang ditentukan, dalam hal ini nilai 128. Langkah berikutnya sama dengan kode sebelumnya, yaitu menyimpan data piksel ke dalam gambar baru.

Selanjutnya, Anda dapat bereksperimen dengan penentuan batas ambang yang berbeda untuk mendapatkan porsi warna hitam dan putih yang lebih sesuai.

Kode sumber dalam format Jupyter Notebook tersedia di repositori.

Untuk sementara sampai di sini pembahasan pengenalan modul PIL dalam Python. Di artikel berikutnya akan kita bahas lebih banyak lagi hal-hal yang bisa kita lakukan untuk pengolahan citra dan contoh nyatanya.

Semoga bermanfaat.

Jangan seperti zaman kita sekarang ini, hanya bermodalkan pengetahuan tentang beberapa lafaz bahasa Arab, bahkan yang lebih parah lagi hanya sekadar melihat terjemahan Al Quran, seseorang berani berpendapat mengenai Al Quran.

Para ulama berkata, "Dalam menafsirkan Al Quran diperlukan keahlian dalam lima belas bidang ilmu." Saya akan meringkas kelima belas bidang ilmu tersebut semata-mata agar orang mengetahui bahwa tidak setiap orang dapat memahami makna batin Al Quran ini.

1. Ilmu Lughat, (ilmu untuk mengetahui makna setiap kata dalam bahasa Arab). Syaikh Mujahid Rahmatullah 'alaih berkata, "Barang siapa beriman kepada Allah Subhaanahu wata'ala dan hari akhir, ia tidak layak berkomentar tentang ayat-ayat Al Quran tanpa mengetahui ilmu lughat. Sedikit pengetahuan tentang ilmu lughat tidaklah cukup. Karena kadang kala satu lafaz mengandung beberapa makna, sedangkan jika seseorang hanya mengetahui satu atau dua makna saja, padahal kenyataannya, yang dimaksud adalah makna yang lain, maka tentu dia akan salah memahaminya.

2. Ilmu Nahwu (yaitu ilmu untuk mengetahui makna dan bentuk susunan kalimat dalam bahasa Arab). Amat penting mengetahui ilmu Nahwu, karena sedikit saja i'rab (bacaan akhir kata) berubah, akan mengubah arti kata tersebut. Sedangkan pengetahuan tentang i'rab hanya didapat dalam ilmu Nahwu.

3. Ilmu Sharaf (ilmu untuk mengetahui perubahan suatu kata dalam bahasa Arab dan keadaannya sebelum tersusun). Mengetahui ilmu sharaf penting sekali, sebab perubahan sedikit bentuk suatu kata akan mengubah maknanya. Syaikh lbnu Faris Rahmatullah 'alaih berkata, "Jika seseorang tidak mendapatkan ilmu Sharaf, berarti ia telah kehilangan banyak sekali." Dalam Kitab Ujubatut Tafsir, Syaikh Zamakhsyari Rahmatullah 'alaih menulis bahwa ada seseorang yang menerjemahkan ayat Al Quran yang berbunyi:

"(Ingatlah), pada hari (ketika) Kami panggil setiap umat dengan pemimpinnya." (Q.S. Al-Isra': 71)

Karena ketidaktahuannya dalam ilmu Sharaf, ia mengartikan ayat tersebut seperti ini: "Pada hari ketika manusia dipanggil dengan ibu-ibu mereka." Kata imam' (pemimpin) adalah bentuk mufrad (tunggal), tetapi orang tersebut mengira bahwa kata "imam' merupakan bentuk jamak dari kata 'umm' (ibu). Jika ia memahami ilmu Sharaf, ia tidak akan memahami bahwa bentuk jamak 'umm' adalah 'imam'.

4. Ilmu Isytiqaq (yaitu ilmu tentang asal usul kata). Mengetahui ilmu Isytiqaq sangat penting. Dengan ilmu tersebut dapat diketahui asal-usul kata. Ada beberapa kata yang berasal dari dua kata yang berbeda, sehingga berbeda maknanya. Seperti kata 'masiih' berasal dari kata 'mash' yang artinya mengusapkan tangan yang basah ke atas sesuatu. Bisa juga kata masih berasal dari kata 'misaahah' yang berarti ukuran.

5. Ilmu Ma'ani (ilmu tentang susunan kalimat dari segi maknanya). lImu Ma'ani amat penting diketahui. Dengan ilmu ini susunan kalimat dapat dipahami maknanya.

6. Ilmu Bayaan, yaitu ilmu yang mempelajari makna kata yang zhahir dan tersembunyi. Ilmu ini juga mempelajari kiasan dan pemisalan kata.

7. Ilmu Badi, yaitu ilmu yang mempelajari keindahan bahasa. Ketiga bidang ilmu di atas (Ilmu Ma'ani, Bayaan, dan Badi) disebut juga sebagai cabang ilmu Balaghah. Ilmu ini sangat penting dikuasai oleh para ahli tafsir karena Al Quran adalah mukjizat yang agung. Dengan ilmu-ilmu di atas, kemukjizatan Al Quran dapat dipahami.

8. Ilmu Qira'at (ilmu yang mempelajari tentang macam-macam bacaan Al Quran). Ilmu ini sangat penting dipelajari, karena perbedaan bacaan dapat mengubah makna ayat. Ilmu ini membantu menentukan makna yang paling tepat di antara makna-makna suatu kata.

9. Ilmu Aqa'id, yaitu ilmu yang mempelajari dasar-dasar keimanan. Mempelajari ilmu ini sangat penting karena kadang kala ada satu ayat Al Quran yang arti zhahirnya tidak layak diperuntukkan bagi Allah Subhaanahu wata'ala. Untuk memahaminya, diperlukan takwil ayat tersebut, seperti ayat:

"Tangan Allah di atas tangan mereka." (Q.S AL-Fath: 10)

Takwilnya, orang yang berjanji kepada Baginda Rasulullah Shallallahu 'alaihi wasallam, sama juga dengan berjanji kepada Allah Subhaanahu wata'ala.

10. Ilmu Ushul Fiqih (ilmu yang mempelajari cara pengambilan hukum dalil-dalil syariat secara garis besar). Mempelajari ilmu Ushul Fiqih sangat penting. Dengan ilmu ini dapat diambil kesimpulan hukum dari suatu ayat.

11. Ilmu Asbabun Nuzul, yaitu ilmu untuk mengetahui sebab-sebab turunnya ayat Al Quran. Dengan mengetahui sebab-sebabnya, maksud suatu ayat menjadi lebih jelas.

12. Ilmu Nasikh Mansukh (ilmu untuk mengetahui hukum-hukum yang telah dihapus dan hukum-hukum yang berlaku). Dengan ilmu ini dapat dipelajari suatu hukum yang sudah dihapus dan hukum yang masih tetap berlaku.

13. Ilmu Fiqih (ilmu yang mempelajari hukum-hukum dalam syariat). Ilmu ini penting sekali dipelajari. Karena dengan mengetahui hukum-hukum Fiqih secara rinci, akan mudah dipahami kaidah-kaidah umum yang ada dalam Al Quran yang menjadi dasar hukum tersebut.

14. Ilmu Hadits. Ilmu sangat penting dipelajari untuk mengetahui hadis-hadis yang menafsirkan ayat-ayat Al Quran.

15. Ilmu Wahbi, yaitu ilmu khusus yang diberikan Allah Subhaanahu wata'ala kepada hamba-Nya yang istimewa, sebagaimana sabda Baginda Nabi Shallallahu 'alaihi wasallam:

“Barang siapa mengamalkan apa yang ia ketahu, maka Allah Subhaanahu wata'ala akan memberikan kepadanya ilmu yang tidak ia ketahu.”

Sebagaimana dalam satu riwayat, ketika Sayyidina Ali Radhiyallahu 'anhu ditanya oleh seseorang, "Apakah Baginda Rasulullah Shallallahu 'alaihi wasallam telah memberimu suatu ilmu atau nasihat khusus yang tidak diberikan kepada orang lain?" Ia berkata, "Demi Allah, demi Yang menciptakan surga dan jiwa. Aku tidak memiliki sesuatu yang khusus kecuali pemahaman Al Quran yang Allah Subhaanahu wata'ala berikan kepada hamba-Nya." Syaikh lbnu Abi Dunya Rahmatullah 'alaih berkata, "Ilmu Al Quran dan pengetahuan yang didapat darinya seperti lautan yang tak bertepi."

Cabang-cabang ilmu di atas adalah sebagai alat dan syarat-syarat yang penting bagi seorang penafsir. Penafsiran dari seseorang yang tidak benar-benar mahir dengan cabang-cabang ilmu ini dan hanya berdasarkan pendapatnya sendiri harus dicegah. Para sahabat Radhiyallahu 'anhum memperoleh ilmu bahasa Arab secara kebetulan karena merupakan bahasa ibu mereka, sedangkan ilmu lainnya mereka mempelajarinya secara mendalam melalui Rasulullah Shallallahu 'alaihi wasallam.

Allamah Suyuti Rahmatullah 'alaih berkata, "Orang-orang yang mengatakan bahwa untuk mendapatkan ilmu Wahbi adalah di luar kemampuan manusia, pendapat itu tidak benar. Karena cara untuk mendapatkan pengetahuan langsung dari Allah tanpa belajar telah ditunjukkan oleh Allah sendiri, yaitu dengan mengamalkan ilmu yang telah diperolehnya dan tidak mencintai keduniaan.

Seperti ditulis dalam Kitab Kimiya Sa'adat, ''Tiga golongan orang berikut ini tidak akan berhasil menafsirkan Al Quran, yaitu: (1) seorang yang tidak mahir dalam bahasa Arab, (2) orang yang selalu membuat dosa-dosa besar atau orang yang membuat bid'ah karena perbuatan ini dapat menggelapkan hatinya dan menghalanginya dari memahami Al Quran, dan (3) seorang yang menggunakan alasan-alasan rasional (pikiran) semata walaupun dalam hal keimanan, ia merasa tidak suka apabila ia membaca satu ayat Al Quran yang tidak sesuai dengan akal pikirannya. Orang-orang seperti ini tidak akan mampu memahami Al Quran dengan benar.

"Ya Allah peliharalah kami dari perbuatan yang demikian."

Sumber.

Zakariyya Al Kandahlawi, M. (2011) ‘Fadhilah Al Quran’, in Fadhilah Amal. Bandung: Pustaka Ramadhan. pp. 609–6012

Dalam artikel ini akan dibahas bagaimana cara mendapatkan faktorisasi atau penguraian bilangan prima dari sebuah bilangan.

1. Pendahuluan

Faktor adalah pembagi suatu bilangan yang dapat membagi habis bilangan tersebut. Kalau saya punya sebuah angka 6, maka faktor bilangannya adalah: 1, 2, 3, 6. Yaitu hasil perkalian dari:

1 x 6
2 x 3

Berikutnya, kita membahas pengertian faktorisasi dan faktorisasi prima.

Faktorisasi dalam matematika adalah dekomposisi suatu objek (misalnya, suatu bilangan, polinomial, atau matriks) menjadi suatu produk objek lain, atau faktor, yang ketika dikalikan bersama menghasilkan bilangan asalnya. Contohnya, bilangan 15 difaktorkan menjadi bilangan prima sebagai 3 × 5, dan polinomial x2 − 4 difaktorkan menjadi (x − 2)(x + 2). Dalam segala kasus, diperoleh suatu produk dari objek yang lebih sederhana - Wikipedia .

Faktorisasi prima adalah pecahan bilangan komposit yang terdiri dari bilangan-bilangan pembagi yang lebih kecil, dan hasil perkalian dari bilangan-bilangan tersebut sama dengan bilangan komposit yang disebutkan. Contohnya, faktorisasi prima bilangan 84 adalah 2x2x3x7, di mana bilangan 2, 3 dan 7 adalah bilangan prima dan bilangan pembagi 84 - Wikipedia.

2. Pembahasan

Dalam bagian pembahasan ini akan saya jabarkan langkah per langkah cara membangkitkan faktor bilangan menggunakan bahasa pemrograman Python.

a. Faktor bilangan

Pertama-tama, kita akan tampilkan sisa hasil pembagian dari sebuah bilangan dengan angka 1 s/d bilangan itu sendiri.

angka = 6
for i in range(1, angka + 1):
    print(f"{angka} % {i} = {angka%i}")

Luaran dari kode tersebut di atas adalah:

6 % 1 = 0
6 % 2 = 0
6 % 3 = 0
6 % 4 = 2
6 % 5 = 1
6 % 6 = 0

Dari sini kita dapat modifikasi kode untuk dapat menampilkan bilangan yang sisa hasil baginya nol saja.

angka = 6
for i in range(1, angka + 1):
    if angka % i == 0:
        print(i, end=" ")

# luaran = 1 2 3 6

Bahkan dapat kita kompres lagi kodenya dan memasukkan datanya ke dalam sebuah list.

faktor = [i for i in range(1,angka+1) if angka%i==0]
print(faktor)

# luaran = [1, 2, 3, 6]

b. Hasil perkalian

Berikutnya, kita akan mencoba menampilkan detail hasil perkalian dari faktor bilangan yang diperoleh. Hasil perkalian dalam faktor bilangan melibatkan minimal 2 angka. Sebelum membahas lebih lanjut ke menampilkan hasil perkalian, berikut ini contoh faktor bilangan pada beberapa angka.

6 = [1, 2, 3, 6] ➡️ 4 angka
20 = [1, 2, 4, 5, 10, 20] ➡️ 6 angka
100 = [1, 2, 4, 5, 10, 20, 25, 50, 100] ➡️ 9 angka

Cara menemukan hasil perkalian yang paling mudah dapat dilihat pada ilustrasi berikut.

Kodenya adalah sebagai berikut.

angka = 6
listOutput = []
faktor = [i for i in range(1,angka+1) if angka%i==0]
jml = len(faktor)//2 + len(faktor)%2
for i, data in enumerate(faktor):
    if i==jml: break
    listOutput.append((faktor[i], faktor[-1-i]))

print(listOutput)

Kalau variabel angka diisi dengan angka 6 dan 100 secara bergantian, maka luarannya adalah:

# angka = 6
[(1, 6), (2, 3)]

# angka = 100
[(1, 100), (2, 50), (4, 25), (5, 20), (10, 10)]

Untuk kemudahan pemanfaatan fungsional pembangkitan faktor bilangan dan menampilkan hasil perkalian, kode di atas dapat kita buat dalam bentuk fungsi.

def faktor_bilangan(angka):
    listOutput = []
    faktor = [i for i in range(1,angka+1) if angka%i==0]
    jml = len(faktor)//2 + len(faktor)%2
    for i, data in enumerate(faktor):
        if i==jml: break
        listOutput.append((faktor[i], faktor[-1-i]))
    return faktor, listOutput

angka = 100
bilFaktor, hasilKali =  faktor_bilangan(angka)
print(f"Bilangan faktor dari {angka} adalah {bilFaktor}")
print(f"Hasil perkalian = {hasilKali}")

Contoh luarannya adalah:

Bilangan faktor dari 100 adalah [1, 2, 4, 5, 10, 20, 25, 50, 100]
Hasil perkalian = [(1, 100), (2, 50), (4, 25), (5, 20), (10, 10)]

c. Pemeriksaan akar kuadrat

Untuk membantu mempercepat penemuan faktor bilangan prima, kita harus memeriksa apakah bilangan yang ada dalam list faktor bilangan memilik akar kuadrat atau tidak.

Misalkan kita punya angka 100, memiliki faktor bilangan 1, 2, 4, 5, 10, 20, 25, 50, 100. Dari daftar faktor bilangan tersebut, kita dapat memeriksa apakah bilangan di dalamnya ada yang memiliki akar kuadrat atau tidak. Berikut ini kodenya.

import math
def punya_akar_kuadrat(angka):
    akar = math.sqrt(angka)
    kuadrat = (int(akar+0.5) ** 2 == angka)
    return kuadrat

angka = 9
print(punya_akar_kuadrat(angka))
# angka 9 -> luaran = True
# angka 10 -> luaran = False

Untuk keperluan faktorisasi prima, fungsi akar kuadrat dimodifikasi sedemikian rupa agar dapat menampilkan nilai akarnya jika bilangan tersebut memiliki akar kuadrat. Sebaliknya, akan mengembalikan nilai None. Kode adalah sebagai berikut.

def akar_kuadrat(angka):
    akar = math.sqrt(angka)
    if int(akar+0.5) ** 2 == angka:
        return int(akar)
    else:
        return None

d. Faktorisasi prima

Alur proses dari faktorisasi prima adalah sebagai berikut.

• Masukkan angka ke list penampung, tetapkan list indeks ke nol sebagai angka masukan;
• Cari akar kuadrat dari angka masukan jika ditemukan, kemudian dua akar diletakkan dalam sebuah list penampung. Misal angka masukan adalah 9, maka isi list penampung adalah [3, 3]. Kemudian, hapus data angka masukan yang pertama tadi dari list penampung. Jika tidak ditemukan akar kuadratnya, menuju langkah berikutnya;
• Bangkitkan faktor bilangan dari angka masukan, periksa jumlah bilangan yang ada di dalamnya. Jika jumlah bilangan ada 2, berarti angka tersebut merupakan bilangan prima. Misalnya, angka 2 memiliki faktor bilangan [1, 2], angka 3 memiliki faktor bilangan [1, 3], dan seterusnya sesuai definisi bilangan prima. Angka tersebut selanjutnya ditambahkan ke list luaran akhir.
• Jika jumlah bilangan lebih dari 2 -- yang tidak termasuk dalam bilangan prima -- maka, list faktor bilangan sepenuhnya ditambahkan ke list penampung dan hapus data angka masukan dari list penampung.
• Langkah-langkah ini diulangi terus hingga list penampung kosong.
• Luaran akhir akan berisi daftar hasil faktorisasi bilangan prima.

Berikut ini kodenya.

def faktorisasi_prima(angka):
    lstFaktorisasiPrima = []
    lstTemp = [angka]

    while True:
        angka = lstTemp[0]
        akar = akar_kuadrat(angka)
        if akar:
            lstTemp.remove(angka)
            lstTemp.extend([akar, akar])
        else:
            _, lstFaktor = faktor_bilangan(angka)
            if len(lstFaktor)>1:
                lstTemp.remove(angka)
                lstTemp.extend(lstFaktor[1])
            else: # prima
                lstTemp.remove(angka)
                lstFaktorisasiPrima.append(angka)

        if not lstTemp: break
    return lstFaktorisasiPrima

Berikut ini contoh hasil faktorisasi bilangan prima dengan angka masukan yang berbeda-beda.

6 ➡️ [2, 3]
50 ➡️ [2, 5, 5]
84 ➡️ [2, 2, 3, 7]
100 ➡️ [2, 5, 2, 5]
1224 ➡️ [2, 2, 2, 3, 3, 17]

e. Penyederhanaan hasil faktorisasi prima

Inti dari faktorisasi prima sebenarnya sudah selesai, tinggal menyederhanakan tampilan dengan menggunakan tanda pangkat pada bilangan yang sama berulang lebih dari satu kali. Misalnya, angka masukan 1224, yang memiliki bilangan faktor prima [2, 2, 2, 3, 3, 17]; bentuk sederhananya adalah 2^3 x 3^2 x 17^1 atau 2³ x 3² x 17¹. Kodenya adalah sebagai berikut.

def kamus_penyederhanaan(listFaktorPrima):
    kamus = Counter(listFaktorPrima)
    lst = []
    for i in kamus:
        lst.append(f"{i}^{kamus[i]}")
    return lst

Dari hasil penggabungan fungsi-fungsi yang sudah dibuat sebelumnya, kode pemanggilannya adalah sebagai berikut.

angka = 100
hasil = faktorisasi_prima(angka) 

print(f"Hasil faktorisasi prima dari angka {angka} adalah {hasil}")

strSederhana = " x ".join(kamus_penyederhanaan(hasil))
print(f"Bentuk sederhana: {strSederhana}")

Contoh luarannya adalah:

Hasil faktorisasi prima dari angka 100 adalah [2, 5, 2, 5]
Bentuk sederhana: 2^2 x 5^2

f. Versi penelusuran pohon faktor - rekursif

Untuk menentukan faktorisasi prima dari suatu bilangan, kita juga dapat menggunakan sebuah alat bantu bernama pohon faktor. Mekanismenya adalah dengan membagi bilangan tersebut berturut-turut dengan bilangan prima dari yang paling kecil terlebih dahulu. Ilustrasi penelusuran pencarian faktor bilangan prima dari angka 100 dapat dilihat pada gambar berikut.

Alur prosesnya adalah:

• Cari bilangan faktor terkecil dari angka masukan.
• Temukan pengalinya, yang mana pengali adalah hasil pembagian antara angka masukan dan bilangan faktor pembagi.
• Langkah-langkah ini diulang terus menerus hingga ditemukan pengali yang termasuk dalam bilangan prima. Hal ini berarti faktor bilangan terkecilnya adalah dirinya sendiri.

Urutan proses penguraiannya adalah sebagai berikut.

🟢MULAI 🟢
✅angka = 100
➜ faktor bilangan terkecil = 2
➜ pengali = 50
✅angka = 50
➜ faktor bilangan terkecil = 2
➜ pengali = 25
✅angka = 25
➜ faktor bilangan terkecil = 5
➜ pengali = 5
🔴STOP🔴
➜ Kumpulkan semua bilangan terkecil sebelumnya ditambah pengali paling akhir.
☑️Luaran = [2, 2, 5, 5]

Fungsi rekursif diterapkan pada tahapan pencarian faktor bilangan prima terkecil. Kode lengkapnya adalah sebagai berikut.

def faktor_prima_rekursif(angka, lst=[]):
    # jika list kosong
    if not lst:
        if angka == 1:
            return [angka]
        elif angka < 1:
            return None

    # pembagi adalah faktor bilangan terkecil di atas angka 1
    pembagi = next(i for i in range(2, angka+1) if angka % i == 0)

    if angka == pembagi:
        lst.append(angka)
        return lst

    pengali = angka // pembagi
    print(f"Perkalian tingkat {len(lst) + 1} = {pembagi} x {pengali}")

    if pembagi != pengali:
        lst.append(pembagi)
        return faktor_prima_rekursif(pengali)
    else:
        lst.extend([pembagi, pengali])
        return lst

Contoh luarannya (dengan ditambah pemrosesan ke bentuk sederhana seperti di bagian sebelumnya) adalah:

Perkalian tingkat 1 = 2 x 50
Perkalian tingkat 2 = 2 x 25
Perkalian tingkat 3 = 5 x 5
Hasil: [2, 2, 5, 5]
Bentuk sederhana: 2^2 x 5^2

3. Penutup

Dalam bidang ilmu Matematika, bilangan prima erat kaitannya dengan tingkat pembelajaran yang lebih tinggi, seperti mencari faktor persekutuan terbesar (FPB), menyederhanakan pecahan, dan lain-lain. Bilangan prima juga digunakan dalam ilmu kriptografi untuk melakukan enkripsi atau penyamaran data. Penerapan konsep ini memegang peranan penting dalam keamanan data, misalnya keamanan akun untuk login sistem, keamanan jaringan komputer, sistem keamanan bidang perbankan, dan lain sebagainya.

Semoga bermanfaat.

Terima kasih.

Cek repositori di tautan berikut atau cek demo secara daring .

Catatan revisi tulisan.

✏️[2-12-2021]
Penambahan tulisan metode penelusuran pohon faktor - rekursif.

✏️[1-12-2021]
Metode alternatif yang sebelumnya ditulis ternyata mengandung bugs. Hal ini menyebabkan kesalahan hitungan pada angka masukan berukuran besar. Sementara saya hapus dahulu.

Pada suatu waktu, saya melihat contoh soal pelajaran Matematika di internet seperti ini:

Di dalam sebuah ruangan terdapat 46 orang yang mengadakan sebuah kegiatan, selesai kegiatan mereka saling berjabat tangan. Berapa kalikah terjadi jabat tangan atau bersalaman di antara keduanya tanpa pernah bersalaman 2 kali pada orang yang sama?

Model soal seperti ini sering dibahas penyelesaiannya menggunakan teori penyelesaian barisan bilangan (barisan aritmetika) dan kombinasi. Merupakan bagian dari pelajaran Matematika di kelas 7-8 (SMP) dan/atau di tingkat SMA untuk tingkat lanjut.

Dalam artikel ini akan saya bahas penyelesaiannya menggunakan bahasa pemrograman Python melalui 5 metode berbeda, yaitu (1) iterative, (2) recursive, (3) barisan aritmetika, (4) deret aritmetika, dan (5) kombinasi.

1. Pendahuluan Jabat Tangan

Jabat tangan dapat terjadi minimal oleh 2 orang, serta cukup dilakukan 1 kali saja. Jika dimisalkan terdapat dua orang A dan B, maka jabat tangan dapat disimbolkan dengan A-B. Dan tidak perlu disimbolkan sebaliknya, seperti B-A, karena hal ini sudah diwakili oleh A-B. Dan jika terdapat 3 orang A,B, dan C (disingkat ABC), maka jabat tangan yang terjadi sebanyak 3 kali, yaitu A-B (A dengan B), A-C (A dengan C), dan B-C (B dengan C). Bagaimana kalau 4 orang? Maka, jabat tangan yang terjadi adalah A-B, A-C, A-D, B-C, B-D, dan C-D; dengan total sebanyak 6 kali.

Jadi, kalau kita ringkas jumlah orang dan jabat tangan yang terjadi adalah sebagai berikut.

Penerapan dalam pemrograman mengikuti simulasi pada gambar berikut.

Dalam gambar tersebut di atas menyimulasikan relasi terjadinya jabat tangan dalam 2, 3, dan 4 orang. Kode utamanya adalah seperti ini.

jml_orang = 4
jml_salaman = 0
for i in range(1, jml_orang):
    for j in range(i + 1, jml_orang + 1):
        jml_salaman += 1
        print(i,j)
print(jml_salaman)

Pasangan jabat tangan adalah 1 2, 1 3, 1 4, 2 3, 2 4, 3 4 dan isi jumlah salaman adalah 6. Adapun dalam kode berikut dimodifikasi sedemikian rupa agar tampilan jabat tangan sesuai dengan rencana awal, yaitu simbol huruf abjad A, B, C, dan seterusnya.

# inisialisasi jumlah orang
jml_orang = 4
# inisialisasi simbol orang
simbol_A = 65  # karakter ASCII A:65, Z:91
simbol_akhir = simbol_A+jml_orang-1
# jumlah orang harus lebih dari 1 dan kurang dari 27 (simbol A-Z)
assert 1 < jml_orang < 27
# penampung jumlah salaman, inisialisasi 0
jml_salaman = 0
for i in range(simbol_A, simbol_akhir):
    for j in range(i + 1, simbol_akhir + 1):
        jml_salaman += 1
        print(f"{chr(i)}-{chr(j)}")

print(f"\nJumlah salaman yang terjadi dalam {jml_orang} orang = {jml_salaman} kali")

Luarannya adalah:

A-B
A-C
A-D
B-C
B-D
C-D

Jumlah salaman yang terjadi dalam 4 orang = 6 kali

Berikutnya kita coba bahas penyelesaian persoalan jumlah jabat tangan (salaman) ini melalui metode yang berbeda-beda.

2. Metode Penyelesaian

Terdapat 5 metode yang akan dibahas dalam hal ini, meliputi: (1) iterative, (2) recursive, (3) barisan aritmetika, (4) deret aritmetika, dan (5) kombinasi. Beberapa metode akan disampaikan teori dasar yang digunakan, dan kemudian ditambahkan contoh kode yang dapat digunakan.

a. Iterative

Metode iterative ini sebenarnya hanya memanfaatkan perulangan (atau iterasi) seperti biasa. Skema perulangan mengacu pada mekanisme penjumlahan data seperti terlihat pada tabel berikut.

Kodenya adalah sebagai berikut.

def Hitung_Jumlah_Salaman(jml_orang):
    total = 0
    for i in range(1, jml_orang):
        total += i
    return total

Kode tersebut dapat diringkas lagi dengan meniadakan perulangan, yaitu memanfaatkan fungsi bawaan sum untuk menghitung total nilai dari sekumpulan data nilai. Sehingga, hasil akhirnya cukup total = sum(range(1, jml_orang)) dengan menghilangkan inisiasi peubah total dan perulangan.

b. Recursive

Dalam metode recursive atau rekursif ini, kita dapat membuat fungsi yang dapat memanggil dirinya sendiri. Hal ini dapat menyederhanakan kode, walaupun akan memakan memori lebih besar untuk pemrosesan data yang besar ¹ .

Mari kita anggap bahwa terdapat sebuah fungsi F(x) yang menerima data (parameter) masukan berupa x, yaitu jumlah orang. Jika jumlah orang diisi dengan angka 2 atau F(2), maka luaran jumlah jabat tangan adalah 1. Jika diisi 3 atau F(3), luarannya 3, dan seterusnya. Selanjutnya, mari kita periksa pola penghitungannya dalam tabel berikut.

Dari pola tersebut, kita mengetahui bahwa dengan jumlah orang sebanyak x , maka rumusnya adalah F(x) = F(x-1) + (x-1). Berikut ini kodenya.

def Rekursif_Jumlah_Salaman(jml_orang):
    if jml_orang == 2:
        return 1
    else:
        return Rekursif_Jumlah_Salaman(jml_orang - 1) + (jml_orang - 1)

Mekanisme kerjanya dapat dilihat pada gambar berikut.

Hal pengulangan fungsi yang terus-menerus inilah yang dapat menyebabkan membengkaknya kebutuhan memori seiring dengan jumlah data (dalam hal ini jumlah orang) yang harus diproses.

c. Barisan Aritmetika

Barisan aritmetika merupakan barisan bilangan yang mempunyai beda (selisih) yang tetap di antara suku-sukunya yang saling berdekatan, sedangkan deret aritmetika merupakan jumlah suku ke- n pertama pada barisan aritmetika ².

Jika melihat pada permasalahan menghitung jumlah jabat tangan ini, maka pendekatan yang lebih sesuai adalah pola barisan bilangan bertingkat, yaitu tingkat 2. Rumusnya adalah sebagai berikut.

Un = an² + bn + c

Jadi, kalau diuraikan hingga tuntas, pola barisan yang diperoleh adalah sebagai berikut. Detail teori cara penurunan (atau penguraian) rumus sila merujuk ke laman web ini .

Setelah dilakukan substitusi, diperoleh nilai a=0.5, b=0.5, c=0. Sehingga, kalau dikembalikan ke rumus Un sebelumnya, dapat kita buat kodenya sebagai berikut.

def Barisan_Aritmetika_Tingkat_2(jml_orang):
    n = jml_orang - 1
    a, b, c = 0.5, 0.5, 0
    Un = a*(n**2) + (b*n) + c
    return Un

Nilai a, b, dan c harus selalu dihitung dan disesuaikan dengan pola baris soal yang kita miliki.

d. Deret Aritmetika

Untuk metode deret aritmetika ini mirip dengan penyelesaian pada metode rekursif, yaitu melihat pola penjumlahan yang menghasilkan jumlah jabat tangan.

2 orang = 1
3 orang = 3 = (1 + 2)
4 orang = 6 = (1 + 2 + 3)
5 orang =10 = (1 + 2 + 3 + 4)
...
n orang = (1 + 2 + 3 + … + (n – 1))

Dalam hal ini kita menggunakan rumus untuk menentukan jumlah bilangan pada suku ke- n.

Sn = n/2 . (a + Un)
di mana:

• n = Un = n-1

• a = suku pertama = 1

Sehingga, dapat dituliskan kodenya adalah sebagai berikut.

def Deret_Aritmetika(jml_orang):
    n = jml_orang-1
    return (n / 2) * (1 + n)

Rumus lain yang menghasilkan nilai yang sama adalah (jml_orang**2-jml_orang)/2.

e. Kombinasi

Topik permutasi dan kombinasi dipelajari untuk menghitung peluang, dan sudah diajarkan untuk siswa kelas menengah atas. Teori lengkap dapat dibaca di laman web ini. Untuk menyelesaikan kasus menghitung jumlah jabat tangan, dikarenakan tidak diperlukan memperhatikan urutan siapa yang melakukan jabat tangan terlebih dahulu, maka kita akan selesaikan menggunakan metode kombinasi.

Rumus kombinasi:

C(n, r) = n!/(r! (n – r)!)
dimana:

• C(n, r) : permutasi r objek dari n objek yang ada

• n : banyaknya objek keseluruhan

• r : banyaknya objek yang diamati/diberi perlakuan

Dalam kasus jabat tangan, n adalah jumlah orang, dan r adalah jumlah orang minimal terjadinya jabat tangan, yaitu 2 orang. Sehingga, untuk menghitung jumlah jabat tangan yang terjadi dalam 5 orang, persamaannya dapat kita tulis sebagai berikut.

C(5,2) = 5! / (5!x3!) = 10

Jika kita tuliskan ke bentuk kode:

from math import factorial
def Kombinasi_Salaman(jml_orang):
    return factorial(jml_orang) / (factorial(jml_orang - 2) * factorial(2))

Fungsi factorial diimpor dari paket modul math bawaan Python, lebih efektif dibanding membuat fungsi faktorial sendiri walaupun memungkinkan.

3. Penutup

Dari kelima metode ini, setelah diterapkan dalam bahasa pemrograman Python, penggunaan metode jenis penerapan rumus seperti baris dan deret aritmetika dipastikan lebih cepat dibandingkan metode lain. Hal ini disebabkan pemrosesan dilakukan hanya menghitung parameter masukan pada rumus yang diacu. Hanya saja, penentuan rumus harus dicari terlebih dahulu sebelum dapat diterapkan pada kode. Sedangkan metode selainnya, di dalamnya terdapat berbagai macam komputasi yang sering kali dilakukan perulangan lebih dari satu kali.

Namun dengan adanya perangkat modern saat ini, perbedaan waktu komputasi belum terlalu signifikan, hanya dalam satuan mikrodetik. Berikut ini contoh hasil pengujian waktu komputasi dengan nilai jumlah orang 2000, jumlah pengujian masing-masing metode 10 kali, yang menghasilkan jumlah jabat tangan: 1999000.

Metode 1 - Iterative
Waktu: [176.5 162.4 155.3 207.9 141.8 158.1 161. 160.5 158.7 160.3] mikrodetik
Max: 207.9, Min: 141.8, Avg: 164.25

Metode 2 - Rekursif
Waktu: [1885.1 651.5 613.2 609.7 826.7 623. 610.9 605.8 607.5 587.1] mikrodetik
Max: 1885.1, Min: 587.1, Avg: 762.05

Metode 3 - Barisan Aritmetika Bertingkat Dua
Waktu: [4.7 1.3 1.1 0.9 0.9 0.9 0.8 0.8 0.9 0.9] mikrodetik
Max: 4.7, Min: 0.8, Avg: 1.32

Metode 4 - Deret Aritmetika (Jumlah Suku)
Waktu: [2.1 1. 0.7 0.7 0.7 0.8 0.7 0.7 0.7 0.8] mikrodetik
Max: 2.1, Min: 0.7, Avg: 0.89

Metode 5 - Kombinasi (Faktorial)
Waktu: [518.1 495.1 488.5 489.5 485.8 487.5 487.7 488.4 447.2 356.8] mikrodetik
Max: 518.1, Min: 356.8, Avg: 474.46000000000004

Waktu tercepat: 0.700 mikrodetik, Metode: Deret Aritmetika.
Waktu tercepat rata-rata: 0.890 mikrodetik, Metode: Deret Aritmetika.

Dan grafiknya adalah sebagai berikut.

Demikian tutorial menyelesaikan kasus menghitung jumlah jabat tangan dari sejumlah orang menggunakan 5 metode berbeda dalam Python. Semoga bermanfaat.

Terima Kasih.

Kode sumber lengkap tersedia di repo github.

Demo online.

Kuliah daring saat ini sudah banyak ditemukan di dunia maya, baik itu yang gratis maupun yang berbayar. Salah satu penyedia layanan kuliah daring yang terkenal adalah Coursera.org (untuk selanjutnya ditulis Coursera.)

Mata kuliah Machine Learning adalah salah satu mata kuliah yang disediakan secara gratis oleh Coursera. Kuliah yang dipandu langsung oleh Assoc. Prof. Andrew Ng ini telah diikuti oleh 4 juta lebih siswa, dengan skor kuliah 4,9 dari 5, serta nilai silabus kuliah 97%.

Bahasan yang akan saya sampaikan di artikel ini adalah sebagai berikut.

• Pendahuluan Coursera
• Pengenalan Mata Kuliah Machine Learning di Coursera
• Pengajar
• Silabus
• Struktur Laman Web
• Metode Pembelajaran

1. Pendahuluan Coursera

Coursera bermitra dengan lebih dari 200 universitas dan perusahaan terkemuka untuk menghadirkan pembelajaran daring yang fleksibel, terjangkau, dan relevan dengan pekerjaan kepada individu maupun organisasi di seluruh dunia. Coursera menawarkan berbagai kesempatan belajar—dari proyek dan kursus langsung hingga sertifikat siap kerja dan program gelar ¹ . Hingga saat ini terdapat sekira 82 juta siswa dari seluruh dunia yang pernah mengikuti kuliah daring di Coursera.

a) Jenis Kuliah

Terdapat 6 jenis kuliah dengan target, waktu, dan biaya yang berbeda-beda ² .

b) Coursera Plus

Coursera juga menawarkan akses tak terbatas ke 3.000+ kursus kelas dunia, proyek langsung, dan program sertifikat siap kerja, dengan satu harga berlangganan yang sudah termasuk semua ³ .

c) Kuliah di Tingkatan Organisasi

2. Pengenalan Mata Kuliah Machine Learning di Coursera

Machine Learning atau pembelajaran mesin adalah ilmu untuk membuat komputer bertindak tanpa diprogram secara eksplisit. Dalam dekade terakhir, pembelajaran mesin telah memberi kita mobil self-driving, pengenalan ucapan praktis, pencarian web yang efektif, dan pemahaman yang jauh lebih baik tentang genom manusia. Pembelajaran mesin begitu meresap hari ini sehingga kita mungkin menggunakannya puluhan kali sehari tanpa menyadarinya. Banyak peneliti juga berpikir ini adalah cara terbaik untuk membuat kemajuan menuju kecerdasan buatan setingkat manusia.

Di kelas ini, siswa akan belajar tentang teknik pembelajaran mesin yang paling efektif, dan berlatih menerapkannya dan membuatnya bekerja untuk kepentingan siswa itu sendiri. Lebih penting lagi, siswa akan belajar tentang tidak hanya dasar-dasar teoritis pembelajaran, tetapi juga mendapatkan pengetahuan praktis yang diperlukan untuk menerapkan teknik ini dengan cepat dan kuat pada masalah baru. Terakhir, siswa akan belajar tentang beberapa praktik terbaik di Silicon Valley dalam inovasi yang berkaitan dengan pembelajaran mesin dan kecerdasan buatan.

Kursus yang ditawarkan oleh Universitas Stanford di Amerika Serikat ini memberikan pengantar yang luas untuk pembelajaran mesin, penggalian data (data mining), dan pengenalan pola (pattern recognition) statistik. Topik yang diajarkan meliputi:

1. Supervised Learning atau pembelajaran yang diawasi, seperti: algoritma parametrik / non-parametrik, mesin vektor pendukung (support vector machine), kernel, jaringan saraf tiruan (artificial neural networks).
2. Unsupervised Learning atau pembelajaran tanpa pengawasan, seperti: pengelompokan (clustering), pengurangan dimensi (dimensionality reduction), sistem rekomendasi, pembelajaran mendalam (deep learning).
3. Praktik terbaik dalam pembelajaran mesin (teori bias/varians; proses inovasi dalam pembelajaran mesin dan kecerdasan buatan). Kursus ini juga akan diambil dari berbagai studi kasus dan aplikasi, sehingga siswa juga akan belajar bagaimana menerapkan algoritma pembelajaran untuk membangun robot pintar (persepsi, kontrol), pemahaman teks (pencarian web, anti-spam), visi komputer, informatika medis , audio, penambangan basis data, dan area lainnya.

Dalam video terdapat fitur pengaturan teks subtitle, seperti bahasa Inggris, Indonesia (sebagian), Arab, dan lain-lain.

3. Pengajar

Dipandu langsung oleh Adjunct Professor dari Universitas Stanford.

4. Silabus

Silabus lengkap ada di laman web . Garis besarnya adalah sebagai berikut.

5. Struktur Laman Web

Setelah memasuki laman web perkuliahan, di bagian sebelah kiri halaman ada menu seperti pada gambar berikut.

• Overview, menampilkan daftar perkembangan belajar di tiap pekan. Termasuk pencatatan menonton video, membaca (atau unduh bacaan), kuis, dan (jika ada) tugas pemrograman. Terdapat juga informasi batas waktu pengerjaan kuis dan tugas pemrograman, serta nilai (grade) yang diperoleh jika sudah mengerjakan. Catatan: kuis dapat diulang sebanyak 3x setiap 8 jam dengan syarat lulus dapat nilai minimal 80%, tugas pemrograman dapat diunggah ulang untuk revisi (nilai diambil dari tugas dengan nilai tertinggi), dan batas waktu pengumpulan tugas biasanya setiap hari Senin, 13.59 WIB.
• Grades, menyimpan data nilai dan status kelulusan di setiap materi yang ada di tiap pekannya. Nilai diambil dari kuis dan tugas pemrograman yang masing-masing punya bobot tertentu. Serta ada juga informasi batas waktu pengumpulan atau pengerjaan tugasnya. Jika karena sesuatu hal tidak mampu mengerjakan (atau mengumpulkan) tugas tepat pada waktunya, sebaiknya batas waktu pengumpulan di-reset atau disetel ulang.

• Notes, menyimpan data catatan atau coretan kita ketika menonton video tertentu pada waktu tertentu. Hal ini dapat dilakukan ketika kita menemukan materi dalam video dan kita ingin menandainya dengan catatan yang kita anggap penting.
• Discussion Forums, merupakan wadah diskusi atau tanya jawab terkait kegiatan perkuliahan. Misalnya, bertanya materi tertentu yang butuh penjelasan lebih lanjut, menanyakan soal dalam kuis/tugas yang masih belum dimengerti, gagal dalam unggah tugas, dan lain-lain. Bagusnya membaca dulu diskusi-diskusi sebelumnya sebelum melontarkan pertanyaan baru. Biasanya permasalahan yang dihadapi siswa sudah pernah terjadi dan sudah ada jawabannya di situ. Contoh diskusi.
• Messages, merupakan arsip pesan masuk dari Coursera ke siswa.
• Resources, menampung informasi beraneka ragam, seperti: tips dan trik pengerjaan tugas, catatan tambahan materi pekanan, revisi materi, tutorial pemrograman, dll.
• Course Info, berisi informasi dasar terkait kursus yang diberikan, pertanyaan dan jawaban (FAQs) terkait kuliah dan pengerjaan (atau pengumpulan) tugas.

6. Metode Pembelajaran

Dalam setiap pekannya, siswa akan mendapat materi video, bacaan (fail presentasi), kuis, dan/atau tugas pemrograman sesuai dengan materi tertentu yang diajarkan. Jika video sudah ditonton, fail presentasi sudah diunduh (dan dibaca); maka, status perkembangan belajar menjadi "Done." Dan untuk kuis dan/atau tugas pemrograman yang mendapat nilai minimal 80% akan mendapat tanda centang hijau yang berarti lulus dan dapat melanjutkan ke materi (pekan) berikutnya.

• Video belajar.

  Selain menonton video, siswa dapat menyetel ukuran kualitas video, kecepatan pemutaran, subtitle, melihat transkrip, unduh video (dan subtitle), maupun membuat catatan. Catatan: tidak setiap materi tersedia subtitle bahasa Indonesia; munculnya subtitle sering kali memotong (makan tempat) video tutorial bagian bawah, sehingga tulisan/coretan presenter jadi tertutupi.

• Kuis kecil.

  Di setiap video selalu ada kuis kecil di tengah-tengah atau menjelang akhir tutorial. Yaitu berupa pilihan ganda yang muncul 1 atau 2 kali, tergantung materi. Tidak berpengaruh ke nilai akhir, dan dapat diperbaiki terus menerus jika jawaban salah; atau bahkan dilewati (skip). Baiknya dijawab saja sampai betul dan dimengerti jawabannya.

• Kuis pekanan.

  Setiap pekan selalu disertai 1 atau 2 kali kuis, tergantung banyaknya materi yang diajarkan. Tipe kuis berupa (a) pilihan ganda (pilih satu jawaban benar/salah); (b) multiple checkbox (banyak pilihan); (c) isian sederhana berupa (textbox) yang hanya bisa diisi angka, misalnya jumlah item, jumlah hidden layer, dan sejenisnya. Kuis dapat dilakukan ulang jika belum memenuhi syarat lulus atau sekadar ingin memperbaiki nilai. Dan jangan lupa baca feedback-nya dulu sebelum mengulang kuis.

• Tugas pemrograman.

  Tugas yang diberikan adalah berupa kode sumber (dan data set untuk materi tertentu) dalam format file .m yang dapat dieksekusi dalam aplikasi Octave atau Matlab . Octave adalah aplikasi yang menyerupai Matlab tapi versi gratis. Unduh dulu failnya di tautan yang diberikan. Soal ditulis di fail .pdf, dalam hal ini contohnya adalah: ex6.pdf. Berikut ini contoh potongan isi file .pdf tersebut. Fail yang bertanda [*] itulah yang harus dimodifikasi kode sumber di dalamnya, dilengkapi sesuai petunjuk soal, dan dikumpulkan. Jika merasa sudah lengkap, jalankan perintah submit (yakni mengeksekusi fail submit.m), nanti otomatis akan ditanya email dan tokennya. Token dapat dibuat di halaman instruksi tugas pemrograman sebelumnya. Kalau sudah melakukan submission, coba cek di halaman tugas pemrograman pada menu tab My submissions, apakah unggahannya sudah lengkap atau belum. Begitu juga skor perolehan dan status lulus atau tidaknya.

Status tugas pemrograman lengkapnya dapat dilihat pada gambar berikut.

Demikian metode pembelajaran yang ditemui di kuliah Machine Learning, Coursera.

Di seri 2 nanti akan saya tuliskan tips dan trik menyelesaikan kuliah dan mengerjakan tugas dengan sukses, serta bagaimana cara mendapatkan bantuan keuangan (financial aid) untuk mendapatkan sertifikat kelulusan secara gratis.

Terima kasih.

Akhirnya saya memutuskan memindahkan dari Medium ke Hashnode dengan berbagai macam pertimbangan, sebagaimana yang sudah saya tulis di tulisan awal.

Untuk memindahkan tulisan dari platform Medium ke Hashnode sudah disediakan alatnya oleh pihak Hashnode. Garis besarnya adalah:

1. Ekspor data tulisan di Medium
2. Impor data tulisan di Hashnode

1. Ekspor data

• Login di Medium.

• Pergi ke bagian Settings.

• Klik submenu Account di bagian kiri halaman atau digeser ke bawah hingga menemukan informasi Download your information. Tekan tombol Download .zip. Nanti akan dikirimkan failnya ke email kita.

• Ini contoh data yang dikirim ke email.

• Unduh dan simpan failnya, tidak perlu diekstrak.

  medium-export-2de80ec2c...zip
  

2. Impor data

• Login ke Hashnode
• Masuk ke Blog Dashboard

• Pilih menu Import

• Pilih menu Medium Importer dan unggah fail .zip yang sudah diunduh sebelumnya.

  • Berdasarkan info di laman web ini, kalau berhasil akan muncul tampilan seperti berikut.

• Punya saya gagal, sehingga memunculkan gambar seperti ini.

3. Impor via RSS

• Di halaman Import, pilih menu RSS Importer.

• Siapkan alamat feed (RSS) di blog Medium yang lama. Berdasarkan informasi di laman web ini, blog medium kita juga punya RSS.

Kalau punya saya ada di sini https://masgalih.medium.com/feed.

• Alamat RSS itu yang digunakan untuk impor data.

• Dan akhirnya tulisan saya di Medium berhasil dibaca. Pilih Publish to Blog kalau ingin langsung diterbitkan di blog Hashnode kita, atau pilih Import as Drafts jika disimpan dulu sebagai draf tulisan yang nantinya dapat diubah lagi sebelum diterbitkan.

• Saya mencontohkan pilih yang Import as Drafts. Hasilnya seperti pada gambar berikut.

• Selanjutnya dapat dicek setiap tulisan tersebut sebagai draf.

Video tutorial dapat dilihat di sini.

Demikian cerita pengalaman memindahkan data tulisan dari Medium ke Hashnode.

Semoga Bermanfaat!

Terima kasih.

Setelah melakukan pengaturan custom domain pada tutorial sebelumnya, kita dapat langsung mendaftarkan blog kita ke perangkat Webmaster kepunyaan Google yang sering disebut dengan Webmaster Tools. Salah satu fitur yang disediakan adalah Google Search Console, yang berkaitan dengan pengindeksan alamat tautan artikel yang ada dalam sebuah website.

Google Search Console adalah layanan gratis yang ditawarkan oleh Google untuk membantu Anda memantau, mempertahankan, dan memecahkan masalah kehadiran situs Anda di hasil Google Penelusuran. Anda tidak harus mendaftar ke Search Console agar situs Anda dicantumkan di hasil Google Penelusuran, namun Search Console dapat membantu Anda memahami dan meningkatkan cara Google melihat situs Anda.

Search Console menawarkan fitur dan laporan untuk tindakan berikut:

• Memastikan bahwa Google dapat menemukan dan meng-crawl situs Anda.
• Memperbaiki masalah pengindeksan dan meminta pengindeksan ulang untuk konten baru atau yang diperbarui.
• Melihat data traffic Google Penelusuran untuk situs Anda: seberapa sering situs Anda muncul di Google Penelusuran, kueri penelusuran mana yang memunculkan situs Anda, seberapa sering penelusur mengklik untuk kueri tersebut, dan banyak lagi.
• Menerima pemberitahuan saat Google menemukan masalah pengindeksan, spam, atau masalah lainnya di situs Anda.
• Menampilkan situs mana saja yang menaut ke situs Anda.
• Memecahkan masalah terkait AMP, kegunaan seluler, dan fitur Penelusuran lainnya.

Berikut ini langkah-langkah pendaftaran laman web ke Google Search Console.

• Buka laman web Google Search Console dan silakan login menggunakan akun Google yang sudah dimiliki.

• Di bagian kiri atas halaman dapat diklik untuk mendaftarkan alamat web baru, dengan mengklik tautan + Tambahkan properti.

• Berikutnya, akan muncul form pengisian jenis properti. Kalau Anda ingin mendaftarkan semua subdomain dari domain utama, pilih form Domain (baru) yang ada di sebelah kiri. Sedangkan jika hanya ingin mendaftarkan sebuah subdomain saja, maka pilih form sebelah kanan. Untuk kasus yang saya miliki lebih sesuai memilih form yang kanan, yaitu Awalan URL. Selanjutnya, saya tuliskan nama tautan lengkap yang saya inginkan, yaitu https://blog.galih.eu/. Klik tombol Terus.

• Setelah itu, akan muncul halaman tata cara melakukan verifikasi. Terdapat 6 cara melakukan verifikasi yang dapat dilakukan. Pada umumnya yang paling mudah adalah cara nomor 1 dan 2. Sedangkan untuk model hosting blog di Hashnode, yang lebih sesuai adalah cara nomor 6. Daftar cara verifikasi secara lengkap berdasarkan laman dukungan Google dapat dilihat pada tabel berikut.

• Verifikasi kepemilikan yang akan saya lakukan adalah mengikuti cara nomor 6, yaitu Penyedia nama domain. Berikut ini informasi yang tersedia. Jangan dahulu tekan tombol verifikasi. Lakukan langkah selanjutnya terlebih dahulu.

• Selanjutnya, saya lakukan penambahan rekaman DNS tipe TXT melalui laman web Cloudflare.com.

• Langkah berikutnya adalah kembali ke halaman verifikasi kepemilikan di Google, kemudian tekan tombol VERIFIKASI. Jika sukses akan muncul tampilan seperti pada gambar berikut.

• Berikutnya, kita akan mendaftarkan peta situs ke Google Search Console. Pertama-tama, buka halaman dashboard di Hashnode, pilih menu SEO. Salin alamat peta situs (sitemap) tersebut.

• Buka lagi halaman Google Search Console, klik pada menu Peta Situs yang ada di bagian kiri halaman. Masukkan alamat tautan yang tadi disalin (bagian fail .XML) di kotak teks Tambahkan peta situs baru. Dan tekan tombol Kirim.

• Selanjutnya, akan muncul tampilan seperti pada gambar berikut. Menunjukkan peta situs berhasil dibaca dan sudah terdaftar.

• Dan terakhir, kalau kita klik tautan fail tersebut, akan muncul informasi seperti pada gambar berikut.

Seluruh tahap pendaftaran laman web di Google Search Console sudah selesai. Selanjutnya, di masa mendatang Anda dapat memeriksa laman ini untuk memeriksa kinerja penelusuran pada web yang dimiliki.

Semoga bermanfaat.

Terima kasih.

Web Utama · Blog · Github Pages · Medium

Pembuatan blog di Hashnode secara default memungkinkan pengguna memiliki halaman web dengan nama sub domain yang menempel di TLD (top level domain) Hashnode.dev, misalnya: namaBlog.hashnode.dev. Bagaimana kalau kita ingin memberikan atau mengganti alamat web tersebut dengan domain TLD yang kita miliki, seperti: galih.eu atau menjadi sebuah sub domain di halaman web utama yang sudah kita miliki, misalnya: blog.galih.eu ? Hal ini dapat dilakukan melalui sebuah pengaturan bernama Custom Domain yang merupakan salah satu fitur gratis yang disediakan oleh Hashnode.

Jadi, materi tutorial yang akan dibahas dalam artikel ini mencakup:

1. Pengaturan custom domain di Hashnode,
2. Pengaturan penambahan rekaman DNS di Cloudflare,
3. Pemeriksaan propagasi DNS melalui Whatsmydns.net, dan
4. Uji coba buka blog baru.

1. Pengaturan custom domain di Hashnode.

• Pertama-tama lakukan login di halaman web Hashnode.com

• Jika sudah masuk, klik foto profil di bagian bawah kiri halaman, nanti akan memunculkan sebuah menu. Pilih menu Blog Dashboard.

• Di bagian kiri halaman halaman, agak bawah klik menu Domain.

• Tampilan awal berupa pengaturan nama sub domain kita sebelumnya, dan selanjutnya klik tab menu Custom Domain.

• Kemudian tuliskan nama lengkap blog baru kita (baik itu merupakan domain TLD atau sub domain). Dalam hal ini saya contohkan sebuah sub domain blog.galih.eu. Selanjutnya klik tombol Update.

• Kondisi awal adalah ketiga indikator yang meliputi DNS config, SSL, dan Status masih tidak aktif.

Ketiga indikator akan aktif setelah pengaturan DNS (domain name system) di Cloudflare berhasil.

2. Pengaturan penambahan rekaman DNS di Cloudflare.

• Login ke website Cloudflare.com, kemudian pilih domain yang sudah ditaruh di sana.

• Setelah masuk ke halaman pengaturan domain bersangkutan, di bagian kiri halaman ada beberapa menu, pilih menu DNS.

• Berikutnya akan muncul halaman pengaturan DNS, dimana contoh kondisi rekaman dalam DNS management dari domain galih.eu yang saya miliki adalah sebagai berikut.

• Klik tombol Add record, dan isikan data berikut:
  a. pilih CNAME dalam pilihan Type,
  b. isi nama sub domain blog,
  c. isi target dengan hashnode.network,
  d. klik tombol di Proxy status untuk menonaktifkan status Proxied menjadi DNS only,
  e. isi TTL (time to live) dibiarkan auto saja, dan terakhir
  f. tekan tombol Save.

• Hasil akhir konfigurasi di DNS management adalah sebagai berikut.

Konfigurasi di Cloudflare selesai.

3. Pemeriksaan propagasi.

Berikutnya, kita cek status domain di halaman pengaturan Domain di Hashnode.

DNS Config sudah aktif, namun untuk SSL dan Status masih belum aktif.

Jika kita mencoba membuka halaman web blog baru kita, maka akan muncul kesalahan seperti pada gambar berikut. Hal ini dikarenakan propagasi belum sukses 100%.

Propagasi adalah tahap pembaruan nameserver di internet yang menunjukkan pengubahan rekaman DNS dari domain bersangkutan. Waktu propagasi selambat-lambatnya dapat mencapai 24 jam, namun sering kali lebih cepat.

Kita dapat memeriksa propagasi DNS melalui website Whatsmydns.net.

• Buka halaman web whatmydns.net,
• Masukkan alamat web yang kita ingin periksa, misalnya blog.galih.eu, dan pilih jenis rekaman DNS CNAME. Kemudian tekan tombol Search.
• Deteksi dilakukan melalui berbagai server yang berada di berbagai negara. Tanda centang warna hijau berarti berhasil terdeteksi, dan tanda x warna merah menunjukkan belum terdeteksi.

Jika mayoritas server di berbagai negara sudah berhasil mendeteksi pembaruan DNS domain kita, berarti sudah aman.

4. Uji coba nama blog baru.

Setelah menunggu masa propagasi beberapa saat, kalau kita periksa lagi di halaman domain Hashnode, semua indikator status akan berwarna hijau atau aktif.

Hal ini menunjukkan blog dengan nama alamat baru sudah dapat diakses. Contohnya adalah sebagai berikut.

Dan kalau diklik pada salah satu artikel, alamat tautan artikel pun sudah menyesuaikan.

Hal ini menunjukkan bahwa pengaturan Custom Domain sudah berhasil.

Tutorial ini juga tersedia di kanal Youtube saya.

Semoga bermanfaat. Terima kasih.

Web Utama · Blog · Github Pages · Medium

Apakah Anda memiliki repositori di Github? Ingin tahu data statistik dari setiap repositori yang Anda miliki? Yuk, ikuti tutorial berikut ini.

1. Pendahuluan

GitHub adalah platform khusus developer yang dibuat karena terinspirasi dari cara bekerja para programmer. Dari open source ke bisnis, kita bisa meng-host dan meninjau sebuah kode, mengelola proyek, dan membangun perangkat lunak bersama 56 juta lebih pengguna di seluruh dunia.

Gampangnya, GitHub merupakan manajemen proyek, sistem versioning code, sekaligus platform jaringan sosial bagi para developer seluruh dunia. Banyak sekali fungsi yang bisa digunakan oleh para developer, sehingga melalui platform ini memudahkan developer dalam mengembangkan sebuah karya - Dicoding.com .

Untuk melihat data statistik di sebuah repositori dalam Github - setelah login - kita dapat memilih salah satu repositori dari daftar repositori yang kita miliki. Cara paling mudah adalah dengan membukanya melalui menu Repositories.

Setelah halaman repositori terbuka, pilih menu Insights.

Di bagian kiri halaman ada daftar submenu, pilih menu Traffic.

Datanya akan terlihat di bagian kanan halaman, contohnya seperti terlihat pada gambar berikut.

Dan sayangnya belum ada fasilitas bawaan untuk melihat data statistik dari seluruh repositori sekaligus. Nah, dalam artikel ini akan disajikan bagaimana cara mengakses data statistik dari keseluruhan repositori yang sudah kita miliki di Github.

2. Instalasi PyGithub

Untuk mengakses data statistik repositori dalam Github dapat dilakukan melalui REST API (application programming interface) yang sudah disediakan.

API, atau antarmuka pemrograman aplikasi, adalah seperangkat aturan yang menentukan bagaimana aplikasi atau perangkat dapat terhubung dan berkomunikasi satu sama lain. REST API adalah API yang sesuai dengan prinsip desain REST (representational state transfer), atau gaya arsitektur transfer status representasional. Untuk alasan ini, REST API terkadang dirujuk ke RESTful API - IBM.com.

Dokumen terkait REST API dapat ditemukan di halaman web Github Docs. Adapun kali ini, kita akan menggunakan paket library PyGithub untuk memudahkan pengaksesan REST API yang tersedia.

Kode sumber PyGithub ada di sini , dan panduan lengkap penggunaannya ada di sini.

• Instalasi paket.

$ pip install PyGithub

• Uji coba pertama adalah menampilkan semua nama repositori yang sudah dimiliki dengan menggunakan template kode berikut.

from github import Github

# First create a Github instance:

# using an access token
g = Github("access_token")

# Github Enterprise with custom hostname
g = Github(base_url="https://{hostname}/api/v3", login_or_token="access_token")

# Then play with your Github objects:
for repo in g.get_user().get_repos():
    print(repo.name)

3. Membuat Token Akses

Untuk dapat mengakses REST API diperlukan semacam token akses yang dapat kita buat melalui pengaturan dalam Github.

• Klik foto profil di bagian kanan atas, dan pilih Settings.

• Berikutnya adalah memilih submenu Developer Settings.

• Pilih submenu Personal access tokens.

• Tekan tombol Generate new token untuk membuat token akses baru.

• Berikutnya adalah isi note (keterangan), masa kadaluwarsa token, dan pilihan scope (jangkauan) hak akses. Dan tekan tombol Generate token. Dalam hal ini saya contohkan isi masa kadaluwarsanya 30 hari, dan scope-nya cukup dipilih yang repo saja.

• Jika berhasil, akan memunculkan semacam kode yang merupakan token akses yang baru saja dibuat. Simpan baik-baik kode tersebut, karena halaman yang memunculkan token ini tidak akan dapat dilihat lagi.

• Jika kembali ke halaman Personal access tokens, maka akan memunculkan isi halaman yang contohnya seperti terdapat pada potongan gambar berikut.

• Kita juga dapat membangkitkan token akses baru lagi jika token sebelumnya terlupakan. Yaitu dengan cara klik tautan nama token tersebut. Anda juga dapat mengubah spesifikasi lainnya dan selanjutnya klik tombol Regenerate token.

4. Uji Coba PyGithub

Dalam tutorial kali ini saya akan mendemokan 5 tugas untuk mengakses data statistik repositori dalam Github, yaitu:

• Melihat daftar nama repositori.
• Memeriksa tipe repositori, yaitu antara tipe Private dan Public.
• Melihat data jumlah cloning (salinan) repositori secara mentah.
• Melihat data pekanan jumlah salinan dan jumlah view (tampilan) dari masing-masing repositori dengan data yang sudah agak dirapikan.
• Melihat data statistik repositori harian agak lengkap, mencakup: nama, tipe, jumlah bintang, data clone, data view, data konten (path) populer, dan data referrer (perujuk).

a. Melihat daftar nama repositori.
Sintaks utamanya adalah pada kode berikut.

# import library
from github import Github
# masukkan token akses
g = Github("token")
# telusuri setiap repositori
for repo in g.get_user().get_repos():
    print(repo.name)

Contoh luarannya adalah:

Baca_Tulis_Bilangan
Cari_Buku
...
vb6-pencari-file
VB6_MySQL

b. Memeriksa tipe repositori.
Kode utamanya adalah:

# inisialisasi jml repo berdasarkan tipe (private atau public)
jmlRepoPrivate = 0
jmlRepoPublic = 0

# akses repository
aksesRepo = g.get_user().get_repos()

# menelusuri semua repo
for no, repo in enumerate(aksesRepo):
    if repo.private:
        jmlRepoPrivate += 1
        tipe = "Private"
    else:
        jmlRepoPublic += 1
        tipe = "Public"

    print(f"Repository ke-{no+1}: {repo.name}, tipe: {tipe}")

print(f"\nJumlah repository tipe Private: {jmlRepoPrivate}, "
      f"Public: {jmlRepoPublic}, "
      f"total: {aksesRepo.totalCount}")

Contoh luarannya adalah:

Repository ke-1: Baca_Tulis_Bilangan, tipe: Public
Repository ke-2: Cari_Buku, tipe: Public
...
Repository ke-14: vb6-pencari-file, tipe: Public
Repository ke-15: VB6_MySQL, tipe: Public

Jumlah repository tipe Private: 3, Public: 12, total: 15

c. Melihat data jumlah clone pekanan.
Kode utamanya adalah:

for no, repo in enumerate(aksesRepo):
    print(f"\nRepository ke-{no + 1}: {repo.name}")
    data_clone = repo.get_clones_traffic(per="week")
    print(data_clone)

Contoh luarannya:

...
Repository ke-13: vb6-mini-projects
{'count': 0, 'uniques': 0, 'clones': []}

Repository ke-14: vb6-pencari-file
{'count': 1, 'uniques': 1, 'clones': [Clones(uniques=1, timestamp=2021-11-08 00:00:00, count=1)]}

Repository ke-15: VB6_MySQL
{'count': 6, 'uniques': 4, 'clones': [Clones(uniques=3, timestamp=2021-11-01 00:00:00, count=3), Clones(uniques=2, timestamp=2021-11-08 00:00:00, count=3)]}

d. Melihat data pekanan jumlah clone dan view.
Kode utamanya (untuk view):

for no, repo in enumerate(aksesRepo):
    data_view = repo.get_views_traffic(per="week")
    print("Data View.")
    print(f"  Jumlah view total: {data_view['count']}")
    print(f"  Jumlah view unik: {data_view['uniques']}")
    if data_view:
        for i, data in enumerate(data_view['views']):
            print(f"    View ke-{i + 1} = tanggal: {data.timestamp}, total: {data.count}, jumlah unik: {data.uniques}")

Contoh luarannya (clone dan view):

...
Repository ke-11: python_list
Data Clone.
  Jumlah clone total: 13
  Jumlah clone unik: 10
    Clone ke-1 = tanggal: 2021-10-25 00:00:00, total: 12, jumlah unik: 9
    Clone ke-2 = tanggal: 2021-11-01 00:00:00, total: 1, jumlah unik: 1
Data View.
  Jumlah view total: 52
  Jumlah view unik: 6
    View ke-1 = tanggal: 2021-10-25 00:00:00, total: 45, jumlah unik: 5
    View ke-2 = tanggal: 2021-11-01 00:00:00, total: 4, jumlah unik: 2
    View ke-3 = tanggal: 2021-11-08 00:00:00, total: 3, jumlah unik: 1
...

e. Melihat data statistik harian agak lengkap.
Kode utamanya:

# jumlah bintang
print(f"  Jumlah bintang: {repo.stargazers_count}")
# sumber data clone harian
data_clone = repo.get_clones_traffic(per="day")
# sumber data view harian
data_view = repo.get_views_traffic(per="day")
# data populer
data_populer = repo.get_top_paths()
# top data referrer
data_referrer = repo.get_top_referrers()

Contoh luarannya.

Demikian tutorial mengakses data statistik repositori di Github menggunakan PyGithub. Selanjutnya dapat dikembangkan dalam bentuk antarmuka yang lebih user friendly dan enak dipandang.

Kode sumber selengkapnya dapat di cek di repositori Github saya.

Semoga bermanfaat. Terima kasih.

Web Utama · Blog · Github Pages · Medium

Kegiatan menyunting teks dengan menggunakan bahasa baku yang sesuai kaidah itu membutuhkan tambahan tenaga dan waktu. Sering kali kita juga bingung dalam memilih mana kata yang dianggap baku dan mana yang sudah tidak dianggap baku lagi, seperti: kuintal atau kwintal, analisis atau analisa, dan sejenisnya.

Penulisan kata-kata yang baku pada kalimat dengan struktur yang benar diperlukan dalam menulis karya ilmiah, laporan penelitian, berita (formal), dan lain sebagainya. Untungnya saat ini untuk mencari kata-kata baku sudah tersedia di situs web KBBI. Dan yang terbaru yang patut diapresiasi adalah diluncurkannya aplikasi Sipebi (Aplikasi Penyuntingan Ejaan Bahasa Indonesia).

Merupakan aplikasi yang berfungsi untuk melakukan perbaikan/penyuntingan teks bahasa Indonesia secara otomatis. Aplikasi ini menggunakan pangkalan data KBBI termutakhir (keluaran April 2021) dan masukan para ahli bahasa sebagai basis datanya.

Badan Bahasa berkomitmen untuk senantiasa mengembangkan dan memutakhirkan Sipebi agar makin banyak jenis kesalahan penulisan teks dalam bahasa Indonesia yang dapat diperbaiki secara otomatis oleh Sipebi.

✔️ Instalasi Sipebi

Sebelum melakukan instalasi, unduh dulu aplikasi Sipebi di website KBBI.

Kemudian klik tautan pada tulisan setelah Sipebi, nanti akan diarahkan ke halaman web khusus unduh aplikasi.

Jika merasa belum memiliki .NET Framework 4.6.2 di sistem operasinya, bisa langsung unduh di halaman web ini.

Pilih fail instalasi yang offline untuk runtime saja.

Berikutnya install .NET Framework 4.6.2 dan kemudian ekstrak unduhan fail Sipebi di folder yang diinginkan.

✔️ Eksperimen Aplikasi

🎖a. Buka aplikasi Sipebi, nanti akan muncul tampilan seperti ini.

🎖b. Klik tombol Masuk untuk menuju tampilan utama.

Keterangan menu dan ikon tertera pada gambar.

🎖c. Buka fail teks contoh dan tekan tombol di menu untuk sunting teks.

Teks asli ada di sebelah kiri, dan hasil penyuntingan ada di sebelah kanan. Dan akan memunculkan laporan hasil penyuntingan seperti pada gambar berikut.

🎖d. Tekan tombol menu buka hasil analisis teks, nanti akan muncul detail informasi hasil analisis.

🎖e. Terakhir, kita coba buka menu Pengaturan, kemudian pada bagian tulisan yang ada kata "ambigu" pilih "Gunakan", kemudian simpang pengaturan.

Kembali lagi ke ruang kerja dan coba tes manual memasukkan kalimat ambigu di dalamnya yang saya ambil dari halaman web dosen pendidikan . Dan hasilnya seperti ini.

Tadinya saya kira fitur ini untuk mendeteksi kata/kalimat ambigu, tapi kok tidak muncul hasil analisisnya. Atau mungkin saya salah paham terhadap fitur ini. Mungkin pengembangnya dapat memberikan buku petunjuk penggunaan yang lebih lengkap.

Btw, aplikasi ini sangat membantu buat saya dan Anda jika ingin menyunting teks menggunakan bahasa baku sesuai kaidah yang berlaku.

Terima kasih pada tim pengembang aplikasi di Badan Pengembangan dan Pembinaan Bahasa, Kementerian Pendidikan, Kebudayaan, Riset, dan Teknologi Republik Indonesia 💙🇮🇩.

Semoga bermanfaat! 🙏☕️

Web Utama · Github Pages · Medium · Hashnode

Setelah kurang lebih satu bulan saya memuat tulisan di blog Medium , dan mencoba menelusuri penyedia layanan blog sejenis, akhirnya ketemu Hashnode. Untuk menulis konten di sini menggunakan markdown sebagaimana biasa saya lakukan ketika membuat isian fail README.md di repository Github.

Markdown adalah perangkat konversi teks ke HTML untuk penulis konten web. Markdown memungkinkan Anda menulis format teks yang mudah dibaca dan ditulis, kemudian mengonversinya ke bentuk XHTML (atau HTML) yang secara terstruktur valid - Daringfireball.

Dalam tulisan di sini diterangkan perbandingan antara Hashnode dan Medium, yang beberapa di antaranya adalah sebagai berikut.

Saya pertama kali tertarik dengan Medium karena format tulisan, jenis font, gaya CSS-nya membuat nyaman mata untuk melihat dan membaca teks panjang. Tapi karena ada batasan paywall bagi pembaca untuk dapat membaca keseluruhan artikel jadi membuat saya mulai mencari platform alternatif sejenis.

Sementara ini mungkin saya akan mencoba menulis di kedua platform ini sambil beradaptasi dulu dengan lingkungan penulisannya. Apalagi di Hashnode ini menawarkan untuk bisa mengimpor tulisan yang ada di Medium.

If you’re already on Medium, we’ve made it easy for you to switch.

Hashnode's Medium Importer enables you to migrate your entire back catalog over to our platform in a matter of minutes.

Btw, saya menulis markdown ini sambil melihat cheatsheet di sini yang cukup membantu saya untuk adaptasi dalam format penulisan artikel 😃.

Penulisan kode dengan sorotan sintak bawaan juga cukup memudahkan, seperti contoh berikut.

class Prima():
  def __init__(self):
    pass

  def CekPrima(self, angka):
    if angka < 1: return False
    else:
      for i in range(2, angka):
        if angka % i == 0: return False
      else: return True

  def DeretPrima(self, min, maks):
      lstPrima = []
      for i in range(min, maks+1):
          if self.CekPrima(i):
              lstPrima.append(i)
              #print(i)
      return lstPrima

o = Prima()
min = 2
maks = 50000

mulai = time.perf_counter()
print(o.DeretPrima(min, maks))
akhir = time.perf_counter()-mulai
print(f"Waktu: {akhir} detik")

Potongan kode tersebut di atas untuk menampilkan deret prima di antara dua bilangan. Hasil eksekusinya seperti terlihat pada gambar berikut.

Untuk meletakkan gambar juga sama dengan yang ada di Medium, yaitu tinggal copy/paste dari hasil screenshot atau unggah fail gambar.

Sementara ini dulu artikel perdana di Hashnode, semoga betah dan rajin menulis 😉.

Semoga berkenan 💝.

Web Utama · Blog · Github Pages · Medium

Artikel ini dibuat sekadar untuk mengenang bagaimana dahulu Visual Basic 6 (VB6) merupakan salah satu pemrograman berbasis Graphical User Interface (GUI) yang cukup populer dan andal di masa jayanya. Visual Basic (juga disebut sebagai Classic Visual Basic) adalah bahasa pemrograman event-driven (berbasis kejadian) generasi ketiga dari Microsoft yang dikenal dengan model pemrograman Component Object Model (COM) yang pertama kali dirilis pada tahun 1991 dan dinyatakan sebagai warisan pada tahun 2008 ¹). Walaupun VB6 sudah dijadikan warisan oleh Microsoft, namun masih dapat digunakan di sistem operasi Windows 11 ².

Untuk mengakses aplikasi database di luar pemrograman VB6, biasanya melalui suatu penghubung yang disebut Open Database Connectivity (ODBC). Namun, dalam tutorial kali ini saya tidak akan menggunakan ODBC sebagai penghubung, melainkan VBMySQLDirect yang saya rasa lebih mudah penggunaannya. VBMySQLDirect adalah sebuah pembungkus MySQL C API yang ditulis oleh seorang kontributor dalam proyek VB-MySQL bernama Robert Rowe pada tahun 2001.

VBMySQLDirect adalah cabang dari MyVbQl API dan tersedia untuk pengembang Visual Basic dan semua pengembang Windows yang memiliki akses ke objek COM. VBMySQLDirect menawarkan peningkatan kinerja melalui ODBC, dan juga menawarkan peningkatan dari API MyVbQl sebelumnya dalam hal manajemen memori yang lebih baik, dukungan BLOB, dan kompatibilitas ADO yang lebih baik. VBMySQLDirect menggunakan API MySQL yang lebih baru sebagai basisnya juga dan karenanya mendukung fungsionalitas yang lebih baru daripada MyVbQl ³.

Dalam artikel ini akan dibagi dalam beberapa tahap, yaitu:

1. Instalasi fail library VBMySQLDirect
2. Penerapan pemanggilan API di VB6
3. Contoh penerapan uji koneksi dalam GUI versi kustom
4. Contoh aplikasi membaca data

Dalam pembuatan artikel ini beberapa hal penting yang harus disiapkan adalah:

• VB6 sudah dipasang. Saat ini saya menggunakan VB6 versi SP6. Yang ingin melakukan instalasi di Windows 10 (atau Windows 11) ikuti tutorial di sini.
• MySQL atau MariaDB sudah dipasang dengan benar di sistem operasi Windows (saat ini saya menggunakan Windows 11). Dapat juga menggunakan aplikasi versi terintegrasi seperti WAMP.

1. Instalasi fail library VBMySQLDirect

Fail library VBMySQLDirect berupa fail .dll yang harus diregistrasikan terlebih dahulu ke sistem operasi Windows sebelum dapat dipakai. DLL adalah singkatan dari Dynamic-Link Library. DLL adalah fail library dalam sistem operasi Windows yang berisi “arahan” untuk program lain dalam melakukan suatu pekerjaan. Fail ini bernama VBMySQLDirect.dll yang dapat diunduh di repository github saya. Langkah selanjutnya adalah sebagai berikut.

• Letakkan fail VBMySQLDirect.dll di sebuah direktori,
• Buka command prompt (jalankan sebagai Administrator),
• Eksekusi perintah registrasi berikut hingga muncul notifikasi sukses.

regsvr32 "nama_dan_alamat_fail_dll"

Berikut ini contoh potongan gambar hasil registrasi yang sudah berhasil.

2. Penerapan pemanggilan API di VB6

Application Programming Interface (API) atau antarmuka pemrograman aplikasi adalah sekumpulan definisi dan protokol untuk membangun dan mengintegrasikan perangkat lunak aplikasi. API memungkinkan sebuah produk atau layanan dapat berkomunikasi dengan produk dan layanan lain tanpa harus mengetahui bagaimana cara penerapannya.

Sebelum menggunakan API VBMySQLDirect ini, yang harus dilakukan pertama kali adalah memuatkan referensi ke fail library bersangkutan. Caranya adalah:

a. Buka IDE VB6, pilih Standard Exe, dan tekan tombol Open.
b. Simpan project (dan form baru) di folder yang dikehendaki.

tambahkan fail libmySQL.dll di setiap folder project yang dimiliki.

Jika mengalami error terkait belum terdeteksinya fail libmySQL.dll, silakan project-nya ditutup dahulu, dan dibuka lagi.

c. Dalam menu tab Project, pilih submenu References.

d. Geser ke bawah hingga menemukan VB MySQL Direct v1.0, dan centang. Kemudian, klik tombol OK.

Untuk mengetahui ada API apa saja di library VBMySQLDirect dapat membuka menu View > Object Browser.

Untuk membuat koneksi baru dapat menggunakan class _MYSQL_CONNECTION_ sekaligus dilakukan inisialisasi variable baru.

Dim koneksi As MYSQL_CONNECTION  
Set koneksi = New MYSQL_CONNECTION

Parameter koneksi dapat dilihat pada fungsi OpenConnection sebagai berikut.

Function OpenConnection([sHostName As String], [sUserName As String], [sPassword As String], [sDbName As String], [lPortNum As Long = 3306]) As MYSQL_CONNECTION_STATE

Contoh pengunaannya adalah sebagai berikut.

Const host = "localhost"  
Const user = "root"  
Const passw = ""  
Const port = 3306

' parameter setelah _passw_ dan sebelum _port_ adalah nama database  
' dapat dikosongkan  
koneksi.OpenConnection host, user, passw, , port

Hasil koneksi adalah status _MY_CONN_OPEN_ jika tersambung atau _MY_CONN_CLOSED_ jika tertutup. Dan jika koneksi tidak berhasil dilakukan akan otomatis membangkitkan pesan kesalahan yang sesuai dengan jenis kesalahan yang sudah terinventarisasi di class _MYSQL_ERR_.

Eksekusi perintah (query) dapat dilakukan melalui fungsi Execute. Misalnya dalam perintah berikut:

Dim status  
Dim isi  
Set status = koneksi.Execute("SELECT version()")  
isi = status.GetString(, "")

Variable status menyimpan hasil eksekusi query “SELECT version()” yang digunakan untuk mengetahui versi database (MySQL/MariaDB) yang digunakan. Dan variable isi melalui fungsi GetString mengambil hasil eksekusi berupa data string.

Dan terakhir untuk menghapus object koneksi dari memori adalah dengan menyetel “Set koneksi = Nothing”.

d. Sebelum memasukkan kode di form code, di mode Design disiapkan dahulu satu buah tombol dengan nama default Command1, caption misalnya “Tes Koneksi”.

e. Lakukan klik ganda pada area form atau tombol, dan lengkapi kodenya.

Kode sumber lengkapnya adalah sebagai berikut.

Hasil eksekusi dengan mengubah port 3306 (MySQL) dan 3307 (MariaDB) adalah sebagai berikut.

Berikut contoh tampilan kalau password diisi “abc” (data salah) dimana seharusnya kosong.

Jika Anda lupa port number dari MySQL atau MariaDB, silakan buka mysql/mariadb console (command line client) dan setelah berhasil login, ketikkan perintah “status”. Berikut contoh tampilannya.

3. Contoh penerapan uji koneksi dalam GUI versi kustom

Dalam antarmuka yang akan dibuat ini terdapat empat fungsional utama, yaitu (1) tes koneksi, (2) menampilkan database, (3) menampilkan tabel dari database yang dipilih, dan (4) menampilkan atribut dari tabel yang dipilih.

Kode untuk fungsional tes koneksi menyerupai kode sebelumnya, hanya saja data masukan parameter diambil dari textbox yang menerima masukan dari pengguna. Untuk fungsional menampilkan database, dengan membangkitkan kode untuk list database dari server yang sedang terhubung. Data berupa list yang disimpan dalam listbox. Untuk fungsional menampilkan data tabel dipengaruhi oleh data database yang dipilih dalam listbox database. Dan terakhir untuk fungsional menampilkan tabel, dipengaruhi oleh data tabel yang dipilih pengguna dalam listbox tabel. Desain antarmukan adalah sebagai berikut.

Potongan kode utama untuk menampilkan database adalah:

Dim MyRS As MYSQL_RS  
Dim theTemp As String, tempArray() As String  
Set MyRS = New MYSQL_RS  
Set MyRS = koneksi.Show(MY_SHOW_DATABASES)

If Not MyRS.EOF Then  
    theTemp = Trim$(MyRS.GetString(, ""))  
    If theTemp <> "" Then  
        Dim i As Integer  
        tempArray = Split(theTemp, vbCrLf)  
        For i = LBound(tempArray) To UBound(tempArray) - 1  
            lstDatabase.AddItem tempArray(i)  
        Next  
    End If  
End If

Potongan kode utama untuk menampilkan tabel dari suatu database adalah:

Dim MyRS As MYSQL_RS  
Dim theTemp As String, tempArray() As String  

Set MyRS = New MYSQL_RS  
Set MyRS = koneksi.Show(MY_SHOW_TABLES)

If Not MyRS.EOF Then  
    theTemp = Trim$(MyRS.GetString(, ""))  
    If theTemp <> "" Then  
        Dim i As Integer  
        tempArray = Split(theTemp, vbCrLf)  
        For i = LBound(tempArray) To UBound(tempArray) - 1  
            lstTabel.AddItem tempArray(i)  
        Next  
    End If  
End If

Dan potongan kode utama untuk menampilkan atribut dari suatu tabel adalah:

Set MyRS = koneksi.Execute("SELECT * FROM " & namaTabel)  
If Not MyRS.EOF Then  
    Dim i As Integer  
    For i = 0 To MyRS.FieldCount - 1  
        lstAtribut.AddItem MyRS.Fields(i).Name  
    Next i  
End If

Hasil akhir setelah eksekusi program adalah sebagai berikut.

4. Contoh aplikasi membaca data

Pada bagian ini akan membahas cara membaca data dari suatu tabel disertai fitur pencarian data. Dimana pencarian data akan dilakukan pembandingan antara nilai masukan (data yang dicari) dengan semua atribut dalam tabel yang dipilih. Jadi jika diumpamakan terdapat parameter masukan dengan nilai “abc”. Maka string SQL secara keseluruhan adalah:

SELECT atribut1, atribut2, dst  
FROM namaTabel  
WHERE atribut1 LIKE "%abc%" OR atribut2 LIKE "%abc%" OR dst...

Hasil pencarian sementara ini hanya disimpan dalam sebuah komponen textbox dimana data yang ditemukan akan disusun secara vertikal. Untuk tutorial lanjutan akan disertakan penyajian data dalam bentuk tabel menggunakan komponen listview.

Berikut ini contoh hasil eksekusi program disertai pencarian data.

Untuk selanjutnya akan dibuatkan tutorial penerapan aplikasi CRUD.

Semoga Bermanfaat.

Terima kasih.

Kode sumber dapat diperoleh di github.

Website · Github Pages · Demo Mini Projects

List merupakan tipe bawaan (built-in) dalam bahasa pemrograman Python yang dapat digunakan untuk menampung lebih dari satu buah data dengan tipe yang berbeda-beda. Data dalam list memiliki nomor urut (indeks) dari 0 dan seterusnya hingga sebanyak jumlah data seluruhnya dalam list tersebut.

Struktur data berupa rangkaian data atau larik (array) yang mirip dengan list adalah tuple. Kalau list isinya dapat diubah, sedangkan data dalam tuple tidak dapat diubah (immutable).

Panduan penggunaan tipe data list dapat ditelusuri di website Python. Dalam artikel ini saya akan berbagi beberapa tips dan trik penggunaan list yang dapat membantu mempercepat atau memudahkan dalam pemrosesan data lebih lanjut. Penggunaan dasar terkait list lebih lengkap dapat dicek di website lain yang akan saya cantumkan di bagian bawah artikel.

1. Membuat sebuah teks (string) dari isi list.

Isi list digabung menggunakan fungsi join string, dimana separator (pemisah) antar nilai adalah menggunakan spasi.

daftar = ['aku', 'cinta', 'indonesia']  
teks = " ".join(daftar)  
print(teks)

#output: "aku cinta indonesia"

2. Pemeriksaan list kosong atau tidak.

Untuk memeriksa sebuah list ada isinya atau tidak, biasanya dilakukan dengan cara memeriksa jumlah data dalam list.

len(daftar) == 0

Pernyataan di atas mengeluarkan nilai True, jika panjang atau jumlah data dalam list daftar kosong (atau tidak ada isinya). Sebaliknya, bernilai False jika ada isinya (minimal satu buah data).

Dalam python, sebuah list yang ada isinya, akan mengeluarkan nilai True jika dilakukan pembandingan dalam sebuah kondisi.

# jika ingin memeriksa apakah list daftar ada isinya  
if daftar:  
   ...

# jika ingin memeriksa apakah list daftar tidak ada isinya  
if not daftar:  
   ...

Contoh penggunaannya adalah sebagai berikut.

keranjang1 = ["jeruk", "anggur", "manggis"]  
keranjang2 = []

if keranjang1:   
    print("Keranjang 1 ada isinya")  
else:  
    print("Keranjang 1 kosong")

if not keranjang2:   
    print("Keranjang 2 kosong")  
else:  
    print("Keranjang 2 ada isinya")

# output:  
# Keranjang 1 ada isinya  
# Keranjang 2 kosong

3. Menggabung isi list

Ada dua konsep dalam menggabung isi list, yaitu (1) menggabung dengan model ditumpuk,

listBenda = ["Daun", "Rambut", "Langit"]  
listWarna = ["Hijau", "Hitam", "Biru"]

listGabungan = listBenda + listWarna

print(listGabungan)  
#output = ['Daun', 'Rambut', 'Langit', 'Hijau', 'Hitam', 'Biru']

dan cara (2) adalah dengan menggabungkan setiap data di list A dan B secara berdampingan (per item).

Sebelum menerapkan cara kedua, yang perlu diketahui adalah terdapat fungsi bawaan bernama zip yang dapat digunakan untuk menggabung dua list secara berdampingan (per item), hanya saja bentuknya bukan list murni, melainkan object.

# hasil gabungan berupa _object_  
listGabungan2 = zip(listBenda, listWarna)

# cara akses  
for benda, warna in listGabungan2:  
    print(benda,warna)

# output:  
# Daun Hijau  
# Rambut Hitam  
# Langit Biru

Atau dengan mengkonversi object tersebut ke bentuk list.

listGabungan3 = list(zip(listBenda, listWarna))  
print(listGabungan3)

# output: [('Daun', 'Hijau'), ('Rambut', 'Hitam'), ('Langit', 'Biru')]

Biasanya untuk penggabungan model seperti ini lebih sesuai dikonversi ke bentuk kamus (dictionary).

kamus = dict(zip(listBenda, listWarna))  
print(kamus)

# output: {'Daun': 'Hijau', 'Rambut': 'Hitam', 'Langit': 'Biru'}

Adapun kalau ingin dibentuk dalam format list seperti biasanya, dapat memanfaatkan list extend. Fungsi list.extend ini digunakan untuk menambah (atau menggabung) isi list dari list lain.

listGabungan4 = []  
for benda, warna in zip(listBenda, listWarna):  
    listGabungan4.extend((benda, warna))  

print(listGabungan4)

# output: ['Daun', 'Hijau', 'Rambut', 'Hitam', 'Langit', 'Biru']

4. Mengembalikan nomor indeks dari nilai yang dicari dalam list

Dalam contoh ini kita ingin mencari sebuah nilai dalam sebuah list, serta ingin mengetahui posisi indeks dari nilai tersebut jika memang ditemukan. Untuk mengembalikan nilai indeks dari suatu nilai dalam list sebenarnya sudah ada fungsinya, yaitu list index. Fungsi ini akan mengembalikan pesan kesalahan ValueError jika nilai yang dicari tidak ditemukan.

angkaAcak = [2,3,4,6,4,5,2,7,9,7,2]  
angkaCari = 2

print(angkaAcak.index(angkaCari)) # output = 0  
print(angkaAcak.index(10)) # output = ValueError: 10 is not in list

# mencari angka 2 mulai dari indeks ke-1  
print(angkaAcak.index(angkaCari,1)) # output = 6

# mencari angka 2 mulai dari indeks ke-7  
print(angkaAcak.index(angkaCari,7)) # output = 10

Solusi alternatif untuk menghindari ValueError adalah dengan melakukan pencarian secara manual melalui perulangan.

for idx,angka in enumerate(angkaAcak):  
    if angka == angkaCari:  
        print(idx)

# output:   
# 0   
# 6   
# 10

Adapun solusi yang lebih pendek, dimana sering disebut dengan istilah list comprehension adalah sebagai berikut.

lstCari = [idx for idx,angka in enumerate(angkaAcak) if angka == angkaCari]  
print(lstCari)

# output: [0, 6, 10]

5. Menghitung jumlah kemunculan dari suatu nilai

Untuk menghitung kemunculan sebuah nilai dalam sebuah list yang paling sederhana adalah dengan menggunakan fungsi list count.

angkaAcak = [2,3,4,6,4,5,2,7,9,7,2]  
angkaCari = 2

jml = angkaAcak.count(angkaCari)  
print(f"Angka {angkaCari} ditemukan sejumlah {jml} kali")

# output: Angka 2 ditemukan sejumlah 3 kali

Bagaimana jika pencarian nilai berdasarkan kondisi tertentu? Misal mencari nilai ganjil atau menghitung kemunculan angka ganjil. Caranya dapat menggunakan kombinasi list comprehension pada tips 4 sebelumnya.

angkaGanjil = [angka for angka in angkaAcak if angka % 2 == 1]  
print(angkaGanjil) # output: [3, 5, 7, 9, 7]  
print(f"Jumlah: {len(angkaGanjil)}") # output: "Jumlah: 5"

6. Menampilkan data secara unik

Dalam sebuah list dapat saja ditemukan sebuah nilai yang muncul lebih dari satu kali atau nilai kembar. Kadang-kadang kita membutuhkan nilai yang benar-benar unik, yaitu dengan cara mengeliminasi data kembarannya tersebut. Salah satu solusinya adalah dengan mengkonversi data list ke data set. Tipe data set hanya menerima sekumpulan nilai yang bersifat unik, sehingga jika ada yang kembar akan otomatis dihilangkan.

angkaAcak = [2,3,4,6,4,5,2,7,9,7,2]  
angkaUnik = set(angkaAcak)

# luaran berupa tipe data set 
print(angkaUnik) # output: {2, 3, 4, 5, 6, 7, 9}

# luaran hasil konversi tipe data set ke list
print(list(angkaUnik)) # output: [2, 3, 4, 5, 6, 7, 9]

7. Menampilkan isi list yang ada pada list lain

Kadang kita ingin mengetahui apakah ada isi dari sebuah list yang juga terdapat pada isi list lainnya atau istilahnya beririsan. Dalam hal ini kita manfaatkan lagi list comprehension dengan cara membandingkan isi dari masing-masing (kedua list) dalam sebuah perulangan.

barang1 = ['buku', 'pensil', 'penggaris']  
barang2 = ['penghapus', 'kertas', 'buku']

barangSama = [b for b in barang1 for b2 in barang2 if b==b2]  
print(barangSama) #output: ['buku']

8. Menampilkan isi dari dua list yang tidak beririsan

Tips ini kebalikan dari tips no. 7 sebelumnya. Yaitu menemukan data dalam kedua list yang tidak saling beririsan. Solusinya adalah dengan memanfaatkan fungsi symmetric difference pada tipe data set, yang berfungsi untuk mencari perbedaan nilai dari dua set yang dibandingkan.

barang1 = ['buku', 'pensil', 'penggaris']  
barang2 = ['penghapus', 'kertas', 'buku']

set_barang1 = set(barang1)  
set_barang2 = set(barang2)

listBarang = list(set_barang1.symmetric_difference(set_barang2))  
print(listBarang) 

# output: ['kertas', 'penghapus', 'penggaris', 'pensil']

9. Mengurutkan data

Pengurutan data dapat dilakukan secara ascending maupun descending. Fungsi bawaan yang tersedia adalah sorted.

angkaAcak = [2,3,4,6,4,5,2,7,9,7,2]

dataUrutAsc = sorted(angkaAcak)  
dataUrutDesc = sorted(angkaAcak,reverse=True)

print(dataUrutAsc) # output: [2, 2, 2, 3, 4, 4, 5, 6, 7, 7, 9]  
print(dataUrutDesc) # output: [9, 7, 7, 6, 5, 4, 4, 3, 2, 2, 2]  
print(angkaAcak) # output: [2, 3, 4, 6, 4, 5, 2, 7, 9, 7, 2]

Perhatikan bahwa fungsi sorted tidak memodifikasi isi dari list yang diurutkan, sehingga isi list angkaAcak tidak berubah. Jika ingin sekaligus mengubah isi list yang dituju, maka dapat menggunakan fungsi list sort.

angkaAcak.sort()  
print(angkaAcak) # output: [2, 2, 2, 3, 4, 4, 5, 6, 7, 7, 9]

Sekedar mengingatkan, konversi data list ke tipe data set selain berguna untuk mengeliminasi data kembar juga secara otomatis mengurutkan data di dalamnya.

angkaAcakDua = [2,3,4,6,4,5,2,7,9,7,2]  
dataUrutUnik = list(set(angkaAcakDua))  
print(dataUrutUnik) # output: [2, 3, 4, 5, 6, 7, 9]

10. Membongkar elemen list dengan *

Dalam tips ke-1 di atas, data list yang bisa diubah ke bentuk gabungan dalam sebuah string adalah isi list yang juga berupa string. Jika isi list berupa bilangan, misalnya integer, akan menyebabkan kesalahan.

angkaAcak = [2,3,4,6,4,5,2,7,9,7,2]

strAngka = " ".join(angkaAcak)  
print(angkaAcak)

# TypeError: sequence item 0: expected str instance, int found

Solusinya adalah dengan menempatkan karakter * yang diletakkan sebelum list, yang digunakan untuk membongkar elemen list.

print(angkaAcak) # output: "2 3 4 6 4 5 2 7 9 7 2"

print(set(angkaAcak)) # output: "2 3 4 5 6 7 9"

Kegunaan lain tanda * dalam sebuah variable adalah menampung data list “sisa” atau dikenal dengan istilah partial assignments.

buah = ['jeruk', 'mangga', 'nanas', 'apel', 'manggis']  
print(buah)  
# output: "jeruk mangga nanas apel manggis"

b_satu, *b_sisa = buah

print(b_satu) # output: "jeruk"  
print(b_sisa) # output: ['mangga', 'nanas', 'apel', 'manggis']

Perhatikan bahwa pada dasarnya, jika ditemukan tanda * sebelum nama variable, itu bermakna mengambil semua isi data list. Contoh pada variable *b_sisa, karena didahului dengan variable b_satu, maka b_satu hanya dialokasikan isi list pada indeks nol, dan sisa isi list dialokasikan pada variable b_sisa. Kita coba eksperimen lain sebagai berikut.

b_satu, *b_tengah, b_akhir = buah

print(b_satu) # output: "jeruk"  
print(b_tengah) # output: ['mangga', 'nanas', 'apel']  
print(b_akhir) # output: "manggis"

Variable b_satu dan b_akhir mendapat alokasi isi list pertama dan terakhir (satu buah nilai), sisanya diberikan pada b_tengah.

11. Mengiris (slicing) data

Slicing merupakan fitur bawaan untuk mengambil isi dalam list sesuai nomor indeks dan jumlah data yang telah ditentukan.

Berikut ini contoh slicing data dalam berbagai cara.

data = ['budi', 20, 'andi', 21, 'indah', 19, 'arman', 21]

# mengambil data pada indeks ke-0 (atau pertama)  
print(data[0]) # output: budi

# indeks terakhir disimbolkan dengan angka "-1"  
print(data[-1]) # output: 21

# mengambil data pertama hingga sebelum indeks ke-2  
print(data[:2]) # output: ['budi', 20]

# mengambil data pada indeks -2 hingga terakhir  
print(data[-2:]) # output: ['arman', 21]

# mengambil data dari indeks ke-0 hingga akhir dengan 2 langkah  
# indeks: 0, 2, 4, 6  
print(data[::2]) # output: ['budi', 'andi', 'indah', 'arman']

# mengambil data dari indeks ke-1 hingga akhir dengan 2 langkah  
# indeks: 1, 3, 5, 7  
print(data[1::2]) # output: [20, 21, 19, 21]

# mengambil data list secara terbalik  
print(data[::-1])  
# output: [21, 'arman', 19, 'indah', 21, 'andi', 20, 'budi']

Fungsi bawaan dari tipe data list sebenarnya cukup banyak. Beberapa website yang bisa dijadikan sumber belajar adalah Python Docs, Belajar Python, dan Jago Ngoding.

Demikian tips dan trik terkait pemanfaatan tipe data list dalam Python. Semoga bermanfaat.

Terima kasih.

Kode sumber dari tutorial ada di github repo. Cek juga versi notebook statis di Github [up-to-date], Datalore atau yang versi interaktif di MyBinder.

Website · Github Pages · Demo Mini Projects

Buat apa install banyak Python dengan beda versi, kalau satu saja sudah cukup? 😊

Ceritanya begini, instalasi Python di OS Windows 11 saya semula melalui aplikasi Anaconda. Warisan dari instalasi lama di Windows 10 selumnya. Setelah sekian lama install, uninstall, update/upgrade aplikasi atau paket library di dalamnya — di berbagai virtual environment berbeda — akhirnya ada konflik antar paket di anaconda-nya.

Sudah saya coba melakukan update semua paket ke anaconda terbaru atau coba reset (rollback) ke versi yang lama, tapi masih bermasalah. Coba uninstall anaconda, hapus semua direktori terkait anaconda, bahkan sampai ke registry-nya, kemudian install ulang fresh, juga belum mempan.

Akhirnya ambil keputusan buat uninstall anaconda dan coba install python yang versi asli (atau standalone). Pilihan pertama ingin mencoba python versi terbaru yaitu versi 3.10, langsung unduh di websitenya.

1. Instalasi Awal

Setelah unduh file python-3.10.0-amd64.exe, langsung buka untuk melakukan instalasi. Tutorial instalasi sudah tersedia di websitenya juga.

Untuk setelan di gambar sebelah kiri dicentang semua pilihannya, dan sebelah kanan juga begitu (sebagian saja, lihat gambar). Untuk alamat direktori instalasi saya pilih di direktori user dan nama folder-nya Python310. Di halaman instalasi awal (tidak saya screenshot), terdapat opsi: Add Python 3.10 to PATH, dicentang saja biar nanti dapat otomatis dipanggil melalui windows console di direktori manapun. Hal ini juga berlaku untuk python versi 3.8 dan 3.9.

Jika instalasi dan konfigurasi berhasil, kita dapat langsung mengujinya dengan membuka command prompt, dan mengetikkan python [tekan ENTER].

Untuk memeriksa alamat direktori instalasi, kita dapat menggunakan perintah: pip -V. Sebenarnya perintah ini digunakan untuk memeriksa versi dari aplikasi pip dan alamat direktori paket library dari python yang diinstal.

C:\Users\galih-hermawan>pip -V
pip 21.3.1 from C:\Users\galih-hermawan\Python310\lib\site-packages\pip (python 3.10)

Sebagai tambahan info, salah satu tempat untuk menyimpan hasil konfigurasi agar aplikasi python dapat dipanggil langsung di command prompt adalah berada di :

System Properties >Advanced > Environment Variables

Kalau di Windows, cukup ketik kata “env” di kotak pencarian langsung otomatis muncul tautan programnya.

Setelah tombol “Environment Variables” diklik, akan muncul halaman berikut.

Klik ganda atau tekan tombol Edit, setelah menyorot pada pilihan (kolom) Variable, berisi Path.

Selama terdapat isian alamat direktori python di sini, maka semua aplikasi yang ada di direktori tersebut akan dapat dipanggil di command prompt secara langsung. Jika tidak ada, dapat dibuatkan path barunya dengan cara tekan tombol New, dan masukkan alamat direktori instalasi dari Python yang diinginkan.

2. Instalasi Paket Library dan Pembuatan Virtual Environment

Penjelasan terkait apa pentingnya dan tutorial dasar penggunaannya dapat melihat di website resminya atau di Real Python.

Singkatnya, jika tidak menggunakan virtual environment (venv), semua aplikasi paket library akan disimpan di direktori Lib\site-packages\ dalam direktori instalasi python kita sebelumnya. Jika menggunakan venv, tempat penyimpanan paket dapat diletakkan di mana saja selain di direktori instalasi.

Misalnya, venv untuk mengembangkan aplikasi berbasis GUI (graphical user interface) dibedakan dengan venv untuk aplikasi berbasis website, atau mobile.

Sebelum melakukan instalasi virtual environment (venv), sebaiknya kita juga memeriksa jika ada pembaruan pada aplikasi-aplikasi yang terlibat dalam melakukan instalasi, yaitu: pip, setuptools, dan wheel. Berikut perintah melakukan upgrade aplikasi jika tersedia.

pip install --upgrade pip setuptools wheel

Berikutnya kita lakukan instalasi venv dengan mengeksekusi perintah berikut ini.

pip install virtualenv

Jika instalasi berhasil, berikutnya adalah kita dapat membuat venv dengan nama bebas. Aturan perintah dalam pembuatan venv adalah:

python -m venv nama_venv

Pertama-tama adalah menetapkan dulu alamat direktori venv. Misalkan dalam contoh ini saya gunakan alamat berikut.

D:\PythonKu\#venv\

Misal kita akan membuat venv dengan nama WebApps. Cara pertama, dalam jendela command prompt, kita langsung dapat mengetikkan perintah berikut:

python -m venv D:\PythonKu\#venv\WebApps

Isian nama_venv adalah nama venv disertai alamat direktori penyimpanan venv yang kita tetapkan. Dalam alamat venv tersebut akan otomatis dibuatkan folder baru bernama WebApps yang sudah ada isinya.

Cara kedua, dari jendela command prompt, kita lakukan perintah pindah direktori ke direktori venv, kemudian buat venv baru dengan nama misalnya WebAppsDua.

C:\Users\galih-hermawan>cd D:\PythonKu\#venv\ C:\Users\galih-hermawan>d: D:\PythonKu\#venv>python -m venv WebAppsDua

3. Mengaktifkan dan Menggunakan Virtual Environment

Setelah berhasil membuat venv, kita coba melakukan aktifasi venv dan bekerja di dalamnya. Untuk mengkatifkan venv kita ketikkan perintah dengan ketentuan berikut.

nama_venv\Scripts\activate

Jika posisi direktori default di command prompt ada di luar alamat direktori venv, maka kita cukup mengetikkan alamat direktori lengkap dari nama venv (contoh kasus venv WebApps) disertai dengan tambahan perintah “\Scripts\activate”.

Cara lain adalah dengan pindah direktori dulu ke alamat #venv kemudian mengetikkan perintah sebagaimana ada dalam ketentuan di atas.

Nah, setelah behasil mengaktifkan venv, kita dapat melakukan instalasi paket library dan bekerja menggunakan lingkungan venv ini. Misal, kita lakukan instalasi paket bernama: numpy.

pip install numpy  
...  
Successfully installed numpy-1.21.3

Paket ini akan disimpan di direktori venv WebApps, pada folder “Lib\site-packages”.

Untuk keluar dari venv cukup mengetikkan perintah: deactivate.

4. Instalasi dan Konfigurasi Python Versi 3.8 dan 3.9

Sebelum dilanjutkan instalasi, ada cerita sedikit pengalaman menggunakan python 3.10. Waktu saya akan instal paket Scikit-Learn versi 1.0.1 dan Scipy versi 1.7.1 (versi terakhir hingga tanggal artikel ini diterbitkan), ternyata paket tersebut baru mendukung hingga python versi 3.9.

Dan ketika akan memasang paket Tensorflow, instalasi berhasil tapi Cuda (GPU) saya tidak terdeteksi. Ketika dilakukan uji coba, modul tensorflow ini meminta sebuah file .dll (library) yang terdapat pada Cuda versi terbaru, — yaitu versi 11 — sedangkan milik saya masih versi 10.2. Versi ini memang sesuai dengan driver GPU Nvidia saya.

Setelah mencari informasi di internet ¹ ² ³, ditemukan bahwa Cuda-GPU versi 10.2 dapat disandingkan dengan Tensorflow versi 2.2.0, Keras versi 2.3.0, tapi harus dengan Python 3.8 😔. Dikarenakan belum berhasil untuk instalasi tensorflow dari source, terpaksa harus install python versi 3.8.

Jadi, saat ini saya memiliki instalasi dari tiga python dengan versi 3.8, 3.9, dan 3.10. Alamat direktori instalasi saya buat pada alamat direktori root yang sama, hanya beda nama.

Kemudian untuk alamat direktori venv juga dibuat dengan kondisi serupa.

Untuk konfigurasi Path — Environment Variables, saya masukkan alamat direktori dari ketiga versi python. Python default yang akan digunakan adalah yang berada pada urutan teratas, dalam hal ini saya pilih yang versi 3.8. Urutan ini dapat diganti dengan menekan tombol Move Up atau Move Down di menu sebelah kanan (dalam gambar terpotong).

Selanjutnya saya buat venv sesuai kebutuhan pada masing-masing versi python.

5. Penutup

Pada bagian penutup ini saya ingin memberikan tips bagaimana cara mengakses python sesuai versinya dengan mudah.

1. Mengubah nama file python yang ada di direktori instalasi dengan tambahan nomor versi. Jika yang diprioritaskan adalah python 3.8, maka yang versi lain nama aplikasinya dapat diubah, misal:

Di direktori instalasi "Python39"
python.exe -> python39.exe

Di direktori instalasi "Python310"
python.exe -> python310.exe

Untuk selanjutnya, kita cukup memanggil dengan python39 atau python310 jika ingin memilih versi selain python 3.8. Dan untuk mengakses aplikasi pip, khusus versi 3.9 dan 3.10, kita tidak bisa lagi sekedar dengan menulis perintah ‘pip’. Tapi harus disertakan nama aplikasi python-nya. Misalkan untuk melakukan instalasi paket (di luar venv) sesuai versi python adalah:

python39 -m pip install nama_paket
python310 -m pip install nama_paket

2. Tips berikutnya adalah mengkases cepat venv (dengan versi python berapapun) melalui file batch (.bat).

• Siapkan folder khusus untuk menyimpan file batch, misalnya: “D:\PythonKu\#bat\”.

• Buka aplikasi text editor (notepad, dan sejenisnya), isi dengan:

  start D:\PythonKu\#venv\py39_WebApps\Scripts\activate
  

  Kode tersebut bertujuan untuk membuka command prompt dan mengeksekusi perintah yang mengaktifkan venv WebApps yang sudah dibuat di Python 3.9. Silakan sesuaikan sesuai dengan alamat direktori venv dan nama venv yang sudah dimiliki.

• Berikutnya simpan file tersebut dengan nama yang mudah diingat, misal dalam kasus di atas adalah: py39_WebApps.bat (nama yang mewakili nama venv dan versi python yang dipilih.)

• File .bat ini dapat dibuat sejumlah venv yang dimiliki sesuai dengan versi python masing-masing.
• Terakhir, buat shortcut dari file .bat tersebut, dan kirim ke Desktop.

Demikian cerita pengalaman kenapa dan bagaimana cara melakukan instalasi python dengan versi yang berbeda-beda. Semoga bermanfaat.

Website · Github Pages · Demo Mini Projects

Dengan nama Allah Yang Maha Pengasih, Maha Penyayang. Segala puji bagi Allah, Tuhan seluruh alam, Yang Maha Pengasih, Maha Penyayang, Pemilik hari pembalasan. Hanya kepada Engkaulah kami menyembah dan hanya kepada Engkaulah kami mohon pertolongan. Tunjukilah kami jalan yang lurus, (yaitu) jalan orang-orang yang telah Engkau beri nikmat kepadanya; bukan (jalan) mereka yang dimurkai, dan bukan (pula jalan) mereka yang sesat.
(QS. Al-Fatihah [1]: 1–7)

Sesungguhnya Allah itu Tuhanku dan Tuhanmu, karena itu sembahlah Dia. Inilah jalan yang lurus.”
(QS. Ali Imran [3]: 51)

Katakanlah (Muhammad), “Sesungguhnya Tuhanku telah memberiku petunjuk ke jalan yang lurus, agama yang benar, agama Ibrahim yang lurus. Dia (Ibrahim) tidak termasuk orang-orang musyrik.” Katakanlah (Muhammad), “Sesungguhnya salatku, ibadahku, hidupku dan matiku hanyalah untuk Allah, Tuhan seluruh alam, tidak ada sekutu bagi-Nya; dan demikianlah yang diperintahkan kepadaku dan aku adalah orang yang pertama-tama berserah diri (muslim).”
(QS. Al-An’am [6]: 161–163)

Katakanlah (Muhammad), “Wahai manusia! Sesungguhnya aku ini utusan Allah bagi kamu semua, Yang memiliki kerajaan langit dan bumi; tidak ada tuhan (yang berhak disembah) selain Dia, Yang menghidupkan dan mematikan, maka berimanlah kamu kepada Allah dan Rasul-Nya, (yaitu) Nabi yang ummi yang beriman kepada Allah dan kepada kalimat-kalimat-Nya (kitab-kitab-Nya). Ikutilah dia, agar kamu mendapat petunjuk.”
(QS. Al-A’raf [7]: 158)

Dan Kami tidak mengutus seorang rasul melainkan untuk ditaati dengan izin Allah. Dan sungguh, sekiranya mereka setelah menzalimi dirinya datang kepadamu (Muhammad), lalu memohon ampunan kepada Allah, dan Rasul pun memohonkan ampunan untuk mereka, niscaya mereka mendapati Allah Maha Penerima tobat, Maha Penyayang.
(QS An-Nisa’ [4]: 64)

Wahai orang-orang yang beriman! Taatlah kepada Allah dan Rasul-Nya, dan janganlah kamu berpaling dari-Nya, padahal kamu mendengar (perintah-perintah-Nya),
(QS. Al-Anfal [8]: 20)

Dan taatlah kepada Allah dan Rasul (Muhammad), agar kamu diberi rahmat.
(QS. Ali Imran [3]: 132)

Dan taatilah Allah dan Rasul-Nya dan janganlah kamu berselisih, yang menyebabkan kamu menjadi gentar dan kekuatanmu hilang dan bersabarlah. Sungguh, Allah beserta orang-orang sabar.
(QS. Al-Anfal [8]: 46)

Wahai orang-orang yang beriman! Taatilah Allah dan taatilah Rasul (Muhammad), dan Ulil Amri (pemegang kekuasaan) di antara kamu. Kemudian, jika kamu berbeda pendapat tentang sesuatu, maka kembalikanlah kepada Allah (Al-Qur’an) dan Rasul (sunnahnya), jika kamu beriman kepada Allah dan hari kemudian. Yang demikian itu lebih utama (bagimu) dan lebih baik akibatnya.
(QS. An-Nisa’ [4]: 59)

Hanya ucapan orang-orang mukmin, yang apabila mereka diajak kepada Allah dan Rasul-Nya agar Rasul memutuskan (perkara) di antara mereka, mereka berkata, “Kami mendengar, dan kami taat.” Dan mereka itulah orang-orang yang beruntung.
Dan barang siapa taat kepada Allah dan Rasul-Nya serta takut kepada Allah dan bertakwa kepada-Nya, mereka itulah orang-orang yang mendapat kemenangan.
(QS. An-Nur [24]: 51–52)

Katakanlah, “Taatlah kepada Allah dan taatlah kepada Rasul; jika kamu berpaling, maka sesungguhnya kewajiban Rasul (Muhammad) itu hanyalah apa yang dibebankan kepadanya, dan kewajiban kamu hanyalah apa yang dibebankan kepadamu. Jika kamu taat kepadanya, niscaya kamu mendapat petunjuk. Kewajiban Rasul hanyalah menyampaikan (amanat Allah) dengan jelas.”
Allah telah menjanjikan kepada orang-orang di antara kamu yang beriman dan yang mengerjakan kebajikan, bahwa Dia sungguh, akan menjadikan mereka berkuasa di bumi, sebagaimana Dia telah menjadikan orang-orang sebelum mereka berkuasa, dan sungguh, Dia akan meneguhkan bagi mereka dengan agama yang telah Dia ridai. Dan Dia benar-benar mengubah (keadaan) mereka, setelah berada dalam ketakutan menjadi aman sentosa. Mereka (tetap) menyembah-Ku dengan tidak menyekutukan-Ku dengan sesuatu apa pun. Tetapi barang siapa (tetap) kafir setelah (janji) itu, maka mereka itulah orang-orang yang fasik.
Dan laksanakanlah salat, tunaikanlah zakat, dan taatlah kepada Rasul (Muhammad), agar kamu diberi rahmat.
(QS. An-Nur [24]: 54–56)

Wahai orang-orang yang beriman! Bertakwalah kamu kepada Allah dan ucapkanlah perkataan yang benar, niscaya Allah akan memperbaiki amal-amalmu dan mengampuni dosa-dosamu. Dan barang siapa menaati Allah dan Rasul-Nya, maka sungguh, dia menang dengan kemenangan yang agung.
(QS. Al-Ahzab [33]: 70–71)

Wahai orang-orang yang beriman! Penuhilah seruan Allah dan Rasul, apabila dia menyerumu kepada sesuatu yang memberi kehidupan kepadamu, dan ketahuilah bahwa sesungguhnya Allah membatasi antara manusia dan hatinya dan sesungguhnya kepada-Nyalah kamu akan dikumpulkan.
(QS. Al-Anfal [8]: 24)

Katakanlah (Muhammad), “Taatilah Allah dan Rasul. Jika kamu berpaling, ketahuilah bahwa Allah tidak menyukai orang-orang kafir.”
(QS. Ali Imran [3]: 32)

Barang siapa menaati Rasul (Muhammad), maka sesungguhnya dia telah menaati Allah. Dan barang siapa berpaling (dari ketaatan itu), maka (ketahuilah) Kami tidak mengutusmu (Muhammad) untuk menjadi pemelihara mereka.
(QS. An-Nisa’ [4]: 80)

Dan barang siapa menaati Allah dan Rasul (Muhammad), maka mereka itu akan bersama-sama dengan orang yang diberikan nikmat oleh Allah, (yaitu) para nabi, para pencinta kebenaran, orang-orang yang mati syahid dan orang-orang saleh. Mereka itulah teman yang sebaik-baiknya.
Yang demikian itu adalah karunia dari Allah, dan cukuplah Allah yang Maha Mengetahui.
(QS. An-Nisa’ [4]: 69–70)

… Barang siapa taat kepada Allah dan Rasul-Nya, Dia akan memasukkannya ke dalam surga-surga yang mengalir di bawahnya sungai-sungai, mereka kekal di dalamnya. Dan itulah kemenangan yang agung.
Dan barang siapa mendurhakai Allah dan Rasul-Nya dan melanggar batas-batas hukum-Nya, niscaya Allah memasukkannya ke dalam api neraka, dia kekal di dalamnya dan dia akan mendapat azab yang menghinakan.
(QS. An-Nisa’ [4]: 13–14)

Mereka menanyakan kepadamu (Muhammad) tentang (pembagian) harta rampasan perang. Katakanlah, “Harta rampasan perang itu milik Allah dan Rasul (menurut ketentuan Allah dan Rasul-Nya), maka bertakwalah kepada Allah dan perbaikilah hubungan di antara sesamamu, dan taatlah kepada Allah dan Rasul-Nya jika kamu orang-orang yang beriman.”
Sesungguhnya orang-orang yang beriman adalah mereka yang apabila disebut nama Allah gemetar hatinya, dan apabila dibacakan ayat-ayat-Nya kepada mereka, bertambah (kuat) imannya dan hanya kepada Tuhan mereka bertawakal, (Yaitu) orang-orang yang melaksanakan salat dan yang menginfakkan sebagian dari rezeki yang Kami berikan kepada mereka.
Mereka itulah orang-orang yang benar-benar beriman. Mereka akan memperoleh derajat (tinggi) di sisi Tuhannya dan ampunan serta rezeki (nikmat) yang mulia.
(QS. Al-Anfal [8]: 1–4)

Dan orang-orang yang beriman, laki-laki dan perempuan, sebagian mereka menjadi penolong bagi sebagian yang lain. Mereka menyuruh (berbuat) yang makruf, dan mencegah dari yang mungkar, melaksanakan salat, menunaikan zakat, dan taat kepada Allah dan Rasul-Nya. Mereka akan diberi rahmat oleh Allah. Sungguh, Allah Maha Perkasa, Maha Bijaksana.
(QS. At-Taubah [9]:71)

Katakanlah (Muhammad), “Jika kamu mencintai Allah, ikutilah aku, niscaya Allah mencintaimu dan mengampuni dosa-dosamu.” Allah Maha Pengampun, Maha Penyayang.
(QS. Ali Imran [3]: 31)

Sungguh, telah ada pada (diri) Rasulullah itu suri teladan yang baik bagimu (yaitu) bagi orang yang mengharap (rahmat) Allah dan (kedatangan) hari Kiamat dan yang banyak mengingat Allah.
(Q5. Al-Ahzab [33]: 21)

… Apa yang diberikan Rasul kepadamu maka terimalah. Dan apa yang dilarangnya bagimu maka tinggalkanlah.
(QS. Al-Hasyr [59]: 7)

Catatan.

• Susunan ayat (surat) Al-Qur’an dan terjemahan mengikuti susunan pada buku Kisah Para Sahabat ¹ dengan judul bab yang sama pada judul artikel.
• Khat ayat Al-Qur’an dan terjemahan diambil dari website Qur’an Kemenag ².
• Beberapa kata dalam terjemahan diubah untuk disesuaikan dengan ejaan yang ada di Kamus Besar Bahasa Indonesia (KBBI), Kemdikbudristek ^{3 4} tanpa mengubah makna dari kata terjemahan yang asli.
• Dikarenakan blog Medium belum mendukung penulisan right-to-left (RTL), teks khat ayat Al-Qur’an yang sudah penulis kumpulkan di office editor harus di-screenshot dan ditempel di artikel ini.

Referensi.

1. Al Kandhalawi, M. Y., & Syaifuddin, M. A., 2003. Kehidupan para sahabat. 1st ed. Bandung: Pustaka Zaadul Ma’aad.
2. Kementerian Agama Republik Indonesia. (2021). Qur’an Kemenag. Retrieved from https://quran.kemenag.go.id/
3. Kementerian Pendidikan, Kebudayaan, Riset, dan Teknologi Republik Indonesia. (2021). Kamus Besar Bahasa Indonesia (KBBI) Daring. Retrieved from https://kbbi.kemdikbud.go.id/
4. Ebta Setiawan. (2021). KBBI Online. Retrieved from https://kbbi.web.id/

Cover Photo by Adli Wahid on Unsplash

Deretan nama dalam gambar di atas merupakan hasil pembangkitan otomatis yang disusun secara acak dari gabungan beberapa fail teks yang berisi nama.

Apa maksudnya berbasis aturan?

Bahwa pemerolehan nama tidak serta merta dilakukan hanya dengan sekadar mengacak data dari daftar nama, tapi ada nama-nama tertentu yang dalam penyusunannya mengikuti aturan yang telah ditetapkan. Begitu juga dalam pembangkitan nama dapat disesuaikan dengan aturan sendiri dari pengguna, jumlah kata (nama) yang diinginkan, apakah nama acak semua atau disertai nama permanen (atau tetapan).

Dalam artikel ini selanjutnya akan saya sampaikan pembahasan dari tahap paling dasar hingga jadi seperti aplikasi utuh yang siap digunakan.

Tahap 1. Tutorial dasar penggunaan fungsi Random

Salah satu paket (library) dalam Python untuk mengambil data secara acak dari sekumpulan data bernama Random. Berikut potongan kode untuk mengimpor library dan membuat contoh data (tuple) berisi nama.

import random
daftarNama = ("andi", "budi", "gunawan", "tanto", "rudi", "yanto", "sugeng")

Contoh pemanggilan pertama adalah mengambil satu nama secara acak dari daftarNama. Luaran yang dihasilkan bertipe string.

stringNama = random.choice(daftarNama)  
# stringNama berisi (contoh): 'andi'

Yang kedua adalah mengambil nama dari daftarNama dengan tipe luaran berupa list. Pemanggilan dapat dilakukan beberapa kali yang jumlahnya diletakkan setelah parameter ‘k’. Luaran berupa list.

lstNama = random.choices(daftarNama, k=3)  
# lstNama berisi (contoh): ['rudi', 'gunawan', 'gunawan']

Pada contoh di atas, isi list bisa jadi berisi data kembar dikarenakan method random.choices dengan k=3 itu bermakna jumlah pengacakan dilakukan sebanyak 3 kali. Serta tidak menjamin data yang diperolehnya acak (unik). Adapun untuk memperoleh sejumlah data secara unik adalah dengan menggunakan method random.sample, contohnya adalah sebagai berikut.

jmlNama = 3  
lstNama = random.sample(daftarNama, jmlNama)  
# lstNama berisi (contoh): ['tanto', 'sugeng', 'budi']

Kode sumber untuk penerapan tutorial di atas adalah sebagai berikut.

Penggunaan library random cukup mudah, dan masih ada fitur lain yang bisa dipelajari dan siapa tahu berguna buat Anda nantinya, silakan cek di laman web Python ¹.

Tahap 2. Contoh pemrosesan nama berbasis aturan

Dalam agama Islam, terdapat beberapa panduan dalam memberikan nama pada seseorang. Beberapa di antaranya adalah memberikan nama harus dengan nama yang (mengandung arti) baik, mengandung do’a kebaikan, terdapat nama yang bermakna hamba Tuhan Allah Subhanahu wa Ta’ala (misal; nama ‘Abdul’ ditambah nama Allah yang baik atau asmaul husna), nama Nabi, sahabat Nabi, atau orang-orang shalih zaman dahulu dengan harapan supaya bisa menjadi orang baik sesuai nama yang disandangnya, dan berbagai panduan lainnya. Terdapat berbagai sumber jika kita mau menelusurinya ² ³. Untuk kebiasaan atau tata tertib pemberian nama di agama lain, kebudayaan, atau daerah lain mungkin juga ada; hal ini dapat disesuaikan nantinya.

Salah satu aturan yang akan coba kita terapkan di sini adalah penggunaan nama “Abdul” yang berarti ‘hamba’. Penggunaan nama “Abdul” yang paling sesuai adalah dengan disandingkan dengan “asmaul husna”, contohnya adalah sebagai berikut.

# sebelah kiri panah adalah nama asmaul husna dan artinya
# sebelah kanan panah adalah contoh penggunaan untuk nama orang

Ar Rahman (Yang Maha Pengasih) -> Abdul Rahman atau Abdurrahman
Ar Rahim (Yang Maha Penyayang) -> Abdul Rahim atau Abdurrahim
Al Wahhab (Yang Maha Pemberi Karunia) -> Abdul Wahhab
As Salam (Yang Maha Pemberi Kesejahteraan) -> Abdul Salam atau Abdussalam
... dst.

Artikel daring yang membahas “asmaul husna” cukup banyak ditemukan ⁴ ⁵ ⁶. Anda dapat menelusuri dan mengkajinya lebih lanjut.

Nama “Abdul” tidak dapat berdiri sendiri, ini salah satu aturan yang akan kita gunakan. Kemudian juga tidak dapat dipasangkan dengan nama biasa yang tidak mencirikan sifat Allah yang agung. Jadi, aturan dasarnya sebagai berikut.

# aturan 1 nama = hasil pengacakan dengan jumlah 1 kata (nama)
jika nama yang ditemukan mengandung kata "abdul", lakukan pengacakan lagi

# aturan 2 nama = hasil pengacakan dengan jumlah 2 kata (nama)
- jika ditemukan nama "abdul" pada kata terakhir, ikuti aturan 1
- sebaliknya, jika ditemukan pada kata pertama, maka kata pertama diisi "abdul" dan kata kedua diambil dari nama acak yang terdapat dalam daftar nama asmaul husna.

Berikutnya adalah aturan penggabungan nama “abdul” dengan “asmaul husna”. Contoh nama yang dapat digabung adalah: Abdul Rahim menjadi Abdurrahim, Abdul Rahman menjadi Abdurrahman, dst. Tapi ada juga yang tidak dapat digabung, seperti: Abdul Wahhab, Abdul Ghaniy, dst.

Sementara ini, aturan yang dapat kita terapkan adalah nama asmaul husna yang berawalan karakter atau string berikut, ada kemungkinan digabung menjadi satu kata (nama) “bagi yang mau”. Kenapa begitu? Karena dalam kenyataannya penggunaan nama ini tergantung selera masing-masing orang.

# huruf (string) awal nama asmaul husna yang dapat digabung  
karGabung = ("dh", "n", "r", "s", "sh", "sy", "t", "z")

Kode sumber lengkapnya adalah sebagai berikut.

Dari kode tersebut di atas, kita sudah dapat membangkitkan nama acak sejumlah yang kita inginkan berdasarkan daftar nama yang kita punyai.

Tahap 3. Kustomisasi pembangkitan nama acak

Pada bagian ketiga ini, kita ingin membuat pembangkitan nama lebih dapat disetel (customize) sedemikian rupa sesuai dengan aturan yang kita buat sendiri. Misalkan kita ingin membangkitkan nama berisi 3 (kata) nama, dimana kata pertama harus berisi “Muhammad”, kata kedua dan kata ketiga bebas. Atau contoh lain, kita ingin membangkitkan 4 (kata) nama, dimana kata pertama bebas, kata kedua harus berisi “Abdul”, kata ketiga bebas, dan kata keempat berisi “Hermawan”.

Kalau kita tetapkan misalnya sebuah parameter yang mewakili nama acak adalah karakter (string) “x”, maka desain atau format nama lengkapnya adalah sebagai berikut.

strFormat_contoh_1 = "Muhammad X X"

strFormat_contoh_2 = "X Abdul X Hermawan"

Langkah-langkahnya adalah:

a. Menginventarisir nama sesuai (dalam) format.

Nama selain “X” kita anggap sebagai suatu tetapan yang tidak bisa diubah. Kita dapat masukkan ke penyimpanan khusus nama-nama yang tidak bisa diubah dan jangan sampai dibangkitkan jika terdapat dalam daftar nama. Misalkan kita beri nama lstBlokir (list blokir). Sedangkan untuk nama dalam posisi “X”, kita hafal dan simpan nomor indeksnya.

strFormat_1 = "Muhammad X X"  
lstBlokir_1 = ['Muhammad']  
lstIndeks_X_1 = [[1,1], [2,0]]

strFormat_2 = "X Abdul X Hermawan"  
lstBlokir_2 = ['Abdul', 'Hermawan']  
lstIndeks_X_2 = [[0,2], [2,0]]

Perhatikan isi dari peubah (variable) lstIndeks_X_1 dan lstIndeks_X_2 yang digunakan untuk menampung dua hal, yaitu nomor indeks ‘X’ dan jarak dengan ‘X’ berikutnya. Untuk lstIndeks_X_1 dengan nilai [[1,1], [2,0]] berarti ‘X’ ditemukan pada indeks ke-1 dengan jarak ke indeks ‘X’ berikutnya adalah 1. Dan juga ditemukan pada indeks ke-2 dengan jarak dengan ‘X’ berikutnya 0 (karena tidak ditemukan).

Sedangkan pada lstIndeks_X_2 dengan nilai [[0,2], [2,0]] berarti ‘X’ ditemukan pada indeks ke-0 dengan jarak ke indeks ‘X’ berikutnya adalah 2. Dan juga ditemukan pada indeks ke-2 dengan jarak dengan ‘X’ berikutnya 0 (karena tidak ditemukan).

b. Berikutnya adalah kita evaluasi atau hitung mana nama dalam ‘X’ yang berkumpul, dan mana dipisahkan oleh nama tetapan. Misal kita simpan dalam sebuah lstJarak (list jarak)

strFormat_1 = "Muhammad X X"  
lstIndeks_X_1 = [[1,1], [2,0]]  
lstJarak_1 = [[1, 2]]

strFormat_2 = "X Abdul X Hermawan"  
lstIndeks_X_2 = [[0,2], [2,0]]  
lstJarak_2 = [[0,1], [2,1]]

Dalam lstJarak1 = [[1, 2]] bermakna ‘X’ ditemukan 2 kali berturut-turut dari indeks ke-1, yaitu indeks 1 dan 2. Sedangkan dalam lstJarak_2 = [[0,1], [2,1]] ditemukan ‘X’ pada indeks ke-0 hanya 1 buah saja, dan pada indeks ke-2 juga hanya 1 buah saja.

Jadi logikanya, berdasarkan rekaman jarak indeks tersebut, kita dapat membangkitkan nama acak serta menempatkan kembali sesuai dengan alamat indeks yang sudah kita simpan. Berikut adalah gambarannya.

strFormat_1 = "Muhammad X X"  
lstJarak_1 = [[1, 2]]  
# ... bangkitkan 2 nama acak dan letakkan pada indeks 1 dan 2

strFormat_2 = "X Abdul X Hermawan"  
lstJarak_2 = [[0,1], [2,1]]  
# ... bangkitkan 2 nama acak dan letakkan satu nama pada indeks 0 dan satu nama pada indeks 2

Selain mendesain metode pembangkitan nama, inventarisasi indeks, dan lain sebagainya; urutan peletakan metode juga sangat penting diperhatikan. Dalam hal ini saya akan memodifikasi urutan penerapan metode serta mengubah cara validasi nama yang mengandung nama “abdul”.

• pembangkitan nama acak dengan jumlah tertentu,
• cek ke daftar nama yang diblokir, ulangi ke poin pertama jika ditemukan nama yang terblokir,
• inventarisasi nilai indeks nama berdasarkan daftar nama yang dibangkitkan,
• keluarkan nama yang sudah dibangkitkan,
• cek nama dengan mengikuti aturan validasi nama “abdul”,
• keluarkan nama final yang sudah fixed.

Tahap 4. Pemanggilan nama dari daftar nama yang tersimpan di fail eksternal

Sebelum melampirkan kode sumber lengkap, pada tahap terakhir ini saya ingin memberikan contoh pengaksesan data dari fail eksternal. Saya siapkan 5 fail sebagai berikut.

namaFileAsmaulHusna = "nama_asmaul_husna.txt"  
namaFileLaki = "nama_laki.txt"  
namaFileNabi = "nama_nabi.txt"  
namaFileSahabat = "nama_sahabat_nabi.txt"  
namaFileIslam = "nama_islam.txt"

Penjelasan dari file di atas adalah:

• nama_asmaul_husna.txt → terdapat 99 data nama asmaul husna,
• nama_laki.txt → contoh data nama laki-laki pada umumnya,
• nama_nabi.txt = terdapat 25 data nama nabinya yang umum dikenal oleh ummat Islam,
• nama_sahabat_nabi.txt → terdapat sedikit contoh nama sahabat nabi,
• nama_islam.txt → terdapat sedikit contoh nama-nama Islami

Berikutnya saya manfaatkan library membaca file dari proyek-proyek kecil terdahulu yang juga ada di repository Github, bernama libBerkas.py.

daftarAsmaulHusna = BacaBerkas(namaFileAsmaulHusna)  
daftarNamaLaki = BacaBerkas(namaFileLaki)  
daftarNamaNabi = BacaBerkas(namaFileNabi)  
daftarNamaSahabat = BacaBerkas(namaFileSahabat)  
daftarNamaIslam =  BacaBerkas(namaFileIslam)

Untuk menjadikan daftar nama tersebut di atas sebagai sumber referensi data adalah contohnya sebagai berikut.

# contoh penetapan dari satu sumber data  
# sumber = daftarNamaLaki  
# sumber = daftarNamaIslam  

# contoh sumber data gabungan  
# sumber = daftarNamaNabi + daftarNamaIslam  
sumber = daftarNamaLaki + daftarNamaSahabat + daftarNamaIslam

Pilih salah satu saja, atau silakan meramu data sumber sendiri sesuai keinginan.

Dan terakhir memanfaatkan metode pengambilan nama acak, misalnya:

nama = CetakNama(sumber, strFormat, charAcak)  
namaBaru = ValidasiAbdul(sumber, nama, strFormat, charAcak, True)  
print(f"{i+1}. {namaBaru}")

Berikut ini contoh kode sumber yang sudah menerapkan metode dan aturan-aturan yang sudah kita bahas sebelumnya. Dibuat sedemikian rupa agar dapat dipanggil secara mandiri (standalone) maupun sebagai library.

Contoh screenshot dari hasil eksekusi kode sumber tersebut adalah sebagaimana terlihat pada gambar di bagian paling atas yang saya jadikan cover image.

Contoh variasi lain seperti terlihat pada gambar di bawah ini dapat dilihat di repository Github.

Berikut contoh luaran aplikasi.

Bagi yang ingin mencoba aplikasi secara langsung (online) silakan cek di sini.

https://galihboy.github.io/mini_projects/

Demikian tutorial pembangkitan nama secara otomatis dan berbasis aturan. Semoga bermanfaat.

Terima kasih.

😉🙏❤️

Bacaan

1. https://docs.python.org/3/library/random.html
2. https://islam.nu.or.id/post/read/103702/ketentuan-pemberian-nama-anak-selain-nama-arab
3. https://rumaysho.com/11876-hadiah-di-hari-lahir-15-bolehkah-memakai-nama-nabi-dan-malaikat.html
4. https://katadata.co.id/muchamadnafi/berita/60ae08b006237/asmaul-husna-99-arti-nama-nama-baik-allah-swt
5. https://kangsantono.wordpress.com/2014/12/09/nama-islami-dari-asmaul-husna-dengan-penambahan-kata-abd-%D8%B9%D8%A8%D8%AF-untuk-bayi-laki-laki/
6. https://alquran-indonesia.com/makna-asma-ul-husna-99-nama-allah/

Kali ini saya akan menulis artikel yang tidak berkaitan dengan pemrograman sebagaimana biasanya. Tulisan ini saya sadur dari kitab terjemahan berjudul Kehidupan Para Sahabat yang disusun oleh Maulana Muhammad Yusuf al Kandhalawi rahimahullah, serta diterjemahkan oleh Maulana Ahmad Syaifuddin, M.A.

Dari Atha bin Yasar, dia berkata, “Aku bertemu dengan Abdullah bin Amr bin Ash radhiyallâhu ‘anhu, lalu aku menanyakan kepadanya, ‘Terangkanlah kepadaku mengenai sifat-sifat Rasulullah ﷺ yang tertulis di dalam kitab Taurat!’ Maka dia menjawab, “Baiklah. Demi Allah, sesungguhnya Nabi ﷺ telah diterangkan sifat-sifatnya di dalam kitab Taurat sebagaimana diterangkan di dalam al-Quran.” (Tertulis dalam Taurat), “Wahai Nabi, sesungguhnya, Kami mengutus engkau untuk menjadi saksi, pembawa kabar gembira, dan pemberi peringatan, juga untuk menjaga orang-orang (Arab) yang ummi. Engkau adalah hamba-Ku dan Rasul-Ku. Aku namai engkau dengan sebutan mutawakkil. Engkau bukan seorang yang kasar dan keras hati, dan engkau bukan pula seorang yang suka membalas kejahatan dengan kejahatan, melainkan engkau selalu memaafkan dan mengampuni. Dan sekali-kali engkau tidak akan diwafatkan oleh Allah, sehingga orang-orang memeluk agama ini dengan mengucapkan kalimah laa ilaaha illallaah yang dengannya Allah membukakan mata yang buta, telinga yang tuli, dan hati yang tertutup.” (Hr. Ahmad)

Hadits ini telah diriwayatkan juga oleh Bukhari dari Abdullah, Baihaqi dari Ibnu Salam, Ibnu Ishaq dari Ka’ab Ahbar yang semakna dengan hadits di atas, juga oleh Baihaqi dari Aisyah radhiyallâhu ‘anha secara ringkas.

Wahab bin Munabbih mengatakan bahwa Allah Subhanahu wa ta’ala telah berfirman kepada Nabi Daud di dalam kitab Zabur, “Wahai Daud, sesungguhnya kelak sesudahmu akan datang seorang Nabi yang bernama Ahmad (Muhammad), seorang Nabi yang dipercaya dan sebagai penghulu dari sekalian para Nabi. Aku sekali-kali tidak akan marah kepadanya dan dia juga tidak akan pernah membuat Aku marah sedikit pun. Dan sesungguhnya Aku telah mengampuninya sebelum dia berbuat maksiat (dosa) kepada-Ku, yakni dosa-dosanya yang terdahulu dan dosa-dosanya yang kemudian. Dan umatnya adalah umat yang dirahmati (oleh Allah). Aku berikan kepada umatnya amalan-amalan nafil (sunnah) seperti yang telah Aku berikan kepada para Rasul; dan Aku telah wajibkan kepada umatnya amalan-amalan fardhu seperti yang telah Aku wajibkan kepada para Nabi dan Rasul. Sampai mereka menghadap kepada-Ku di hari Kiamat sedang cahaya mereka seperti cahaya para Nabi — sampai pada firman-Nya — “Wahai Daud, sesungguhnya Aku telah memuliakan Muhammad dan umatnya dari seluruh umat-umat yang lain.”
(Demikian disebutkan dalam al-Bidayah jilid II halaman 326)

Abdullah bin Amar radhiyallâhu ‘anhu pernah berkata kepada Ka’ab Ahbar radhiyallâhu ‘anhu, “Terangkanlah kepadaku mengenai sifat-sifat Nabi ﷺ dan umatnya!” Maka dia menjawab, “Aku temukan sifat-sifat mereka di dalam kitab Allah Subhanahu wa ta’ala (Taurat), bahwa sesungguhnya Ahmad (ﷺ) dan umatnya adalah orang-orang yang selalu memuji Allah Subhanahu wa ta’ala baik dalam keadaan senang maupun dalam keadaan susah (misalnya mereka mengucapkan alhamdulillah ‘alaa kulli haal), mengucapkan takbir Allaahu Akbar setiap kali mereka berjalan naik, dan mereka selalu mengucapkan subhaanallaah setiap kali mereka berjalan menurun. Seruan adzan mereka bergema hingga ke langit. Jika mereka dalam shalat, sayup-sayup terdengar dengungan bagaikan dengungan lebah di atas batu. Mereka berbaris dalam shalat seperti barisan para malaikat, dan mereka berbaris di medan perang seperti berbaris dalam shalat. Apabila mereka berperang (berjihad) di jalan Allah Subhanahu wa ta’ala maka para malaikat dengan tombak yang kuat senantiasa berada di depan dan di belakang mereka. Apabila mereka telah masuk di barisan (kancah) peperangan, maka Allah Subhanahu wa ta’ala akan hadir untuk menaungi mereka — Ka’ab berisyarat dengan tangannya — seperti burung nasar melingkupi sarangnya. Dan sekali-kali mereka tidak akan pernah mundur dari medan perang.”
(Hr. Abu Nu’aim dari Sa’id bin Abi Hilal dalam al-Hilyah jilid V halaman 386)

Hadits ini juga telah diriwayatkan oleh Abu Nu’aim dari Ka’ab Ahbar dengan sanad yang lain secara panjang lebar isinya ada sedikit perbedaan, yaitu: “Umat Muhammad ﷺ adalah umat yang banyak memuji Allah Subhanahu wa ta’ala (dengan ucapan alhamdulillah) dalam setiap keadaan, selalu mengucapkan Allaahu Akbar dalam setiap ketinggian, selalu mengawasi peredaran matahari untuk mengetahui waktu shalat mereka dengan tepat, mereka selalu mengerjakan shalat lima waktu tepat pada waktunya walaupun mereka sedang berada di tempat sampah, mereka selalu memakai kain sarung (celana) di tengah-tengah betis mereka, dan mereka selalu membersihkan anggota-anggota badan mereka dengan berwudhu.”

Sumber.

Al Kandhalawi, M. and Syaifuddin, M., 2003. Kehidupan para sahabat. 1st ed. Bandung: Pustaka Zaadul Ma’aad.

Cover photo by Abdullah Öğük on Unsplash