Ahza Studio Logo
Ahza Studio Deep Learning Toolbox

Selamat datang di dokumentasi resmi Deep Learning Land Cover Toolbox v2.1.0. Panduan ini akan menuntun Anda langkah demi langkah mulai dari instalasi hingga melakukan klasifikasi tutupan lahan menggunakan Citra Landsat 8 dan Kecerdasan Buatan (AI) di ArcGIS Pro.

📦 Persiapan Awal (Instalasi)

Sebelum memulai, pastikan Anda telah mengunduh file toolbox. Ikuti langkah berikut untuk memasukkannya ke dalam ArcGIS Pro:

  1. Ekstrak file ZIP yang telah diunduh ke folder yang aman (contoh: D:\GIS_Tools\).
  2. Buka aplikasi ArcGIS Pro.
  3. Buka panel Catalog Pane (biasanya di sebelah kanan).
  4. Klik kanan pada Toolboxes > pilih Add Toolbox.
  5. Cari dan pilih file DeepLearningLandCover.pyt.
Struktur Toolbox di ArcGIS Pro

🛠️ Langkah 1: Instalasi Library (Smart Installer)

Setelah toolbox ditambahkan, Anda wajib menginstal library Deep Learning (PyTorch & FastAI). Versi 2.1.0 kini dilengkapi dengan Smart Installer yang secara otomatis mendeteksi hardware Anda.

  1. Buka tool "01. Install Deep Learning Libraries (Otomatis)".
  2. Centang "Gunakan GPU (CUDA)" jika Anda memiliki kartu grafis NVIDIA.
  3. Klik Run dan perhatikan jendela Messages untuk hasil deteksi hardware.

Akselerasi GPU (Recommended)

Sistem akan mengecek apakah GPU NVIDIA Anda siap digunakan. Jika CUDA Toolkit belum terinstal, sistem akan menawarkan Download Otomatis (~3GB).

  • ✅ 10x Lebih cepat dibanding CPU.
  • ✅ Otomatis mendeteksi Driver NVIDIA.
  • ✅ Memasang bundle PyTorch GPU (cu118).

Mode CPU (Universal)

Jika laptop Anda tidak memiliki GPU NVIDIA, sistem akan memasang versi CPU yang dijamin berhasil di semua perangkat.

  • ✅ Kompatibel dengan semua processor.
  • ✅ Tanpa perlu konfigurasi tambahan.
  • ⚠️ Proses klasifikasi akan lebih lambat.

Penting: Restart ArcGIS Pro

Sistem akan menampilkan dialog konfirmasi setelah instalasi selesai. Klik Yes untuk melakukan restart otomatis agar perubahan library dapat diterapkan sepenuhnya oleh ArcGIS Pro.

📀 Panduan Instalasi CUDA Manual (Opsional)

Jika Smart Installer gagal mengunduh otomatis atau Anda ingin melakukan instalasi secara mandiri, ikuti panduan berikut untuk mengaktifkan akselerasi GPU secara manual.

1. Unduh CUDA Toolkit 11.8

Deep Learning di ArcGIS Pro versi ini dioptimalkan untuk CUDA 11.8. Versi lain mungkin menyebabkan konflik library.

Download CUDA 11.8 dari NVIDIA Official Site →

2. Langkah Instalasi

  • Jalankan installer cuda_11.8.0_522.06_windows.exe.
  • Pilih opsi Custom (Advanced).
  • Pastikan CUDA tercentang. Anda boleh menghilangkan centang pada Display Driver jika driver Anda sudah versi terbaru.
  • Tunggu hingga selesai dan Restart Komputer.

3. Verifikasi di ArcGIS Pro

Setelah instalasi manual selesai, jalankan kembali tool 01. Install Deep Learning Libraries dengan opsi "Gunakan GPU (CUDA)" tercentang. Tool akan mendeteksi CUDA yang baru Anda instal dan mengonfigurasi PyTorch secara otomatis.

🛰️ Langkah 2: Persiapan Data (Manage Landsat 8)

Toolbox ini membutuhkan input berupa Mosaic Dataset atau Raster Dataset. Gunakan tool ini untuk merapikan data mentah Landsat 8 Anda menjadi satu kesatuan yang siap diolah.

Antarmuka Tool Manage Landsat

Parameter Input

  • Output Geodatabase Lokasi penyimpanan dataset (default: GDB proyek Anda).
  • Mosaic Name Nama dataset mozaik yang akan dibuat (contoh: L8_Mozaik_2024).
  • Input Source Folder Folder tempat Anda menyimpan hasil ekstrak citra Landsat 8. Tool akan mencari file _MTL.txt secara otomatis.
  • Dataset Type Pilih Level 2 (Surface Reflectance) untuk hasil klasifikasi terbaik.

🧠 Langkah 3: Klasifikasi Tutupan Lahan

Tool ini akan membaca input raster Anda dan memprediksi tutupan lahan menggunakan Model Deep Learning (.dlpk). Kini mendukung klasifikasi otomatis ke format Vektor.

⚠️ Wajib Mengunduh Model Anda membutuhkan file model pelatihan (.dlpk) untuk menjalankan tool ini.
Unduh Model (.dlpk)
Antarmuka Tool Klasifikasi

Parameter Utama

  • Input Raster Raster input (Landsat 8 L2SR).
  • File Model (.dlpk) Masukkan file LandCoverClassification.dlpk.
  • Convert to Polygon Centang untuk menghasilkan Shapefile secara otomatis.
  • Output Standard Pilih SNI Indonesia (1:50.000).

🔑 Cek Lisensi & Machine ID

Untuk melakukan pemesanan lisensi Pro, Anda memerlukan Machine ID komputer Anda. Ikuti langkah berikut untuk mendapatkannya:

  1. Buka toolbox Deep Learning Land Cover.
  2. Klik tool 05. Check License Status.
  3. Setelah selesai, klik View Details.
  4. Salin kode pada baris ID Mesin.
Contoh Tampilan Output
ID Mesin : BFEBFBFF000306A9

❓ Pemecahan Masalah (Troubleshooting)

GPU Tidak Terdeteksi oleh PyTorch
Pastikan Driver NVIDIA terbaru telah terinstal. Jika hardware terdeteksi namun CUDA tidak aktif, silakan instal CUDA Toolkit 11.8 dan jalankan kembali Tool 01 dengan mode "Force Reinstall All".
Error: Permission Denied saat Instalasi
Gunakan environment hasil Clone (seperti DLP-LCL8) untuk menghindari batasan izin akses di folder Program Files.
Hasil Klasifikasi Didominasi Awan/Salju
Ini terjadi jika Anda menggunakan data Level 1 (Digital Number). Model ini dilatih khusus untuk data Collection 2 Level 2 (Surface Reflectance).
Masalah Out of Memory (OOM)
Kurangi nilai Batch Size menjadi 1 dan Tile Size menjadi 256 pada pengaturan Advanced Klasifikasi.