Ahza Studio Logo
Ahza Studio Deep Learning Toolbox

Selamat datang di dokumentasi resmi Deep Learning Land Cover Toolbox v2.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 Pendukung

Setelah toolbox berhasil ditambahkan, langkah pertama yang wajib dilakukan adalah menginstal library Python yang dibutuhkan (PyTorch & FastAI). Kami telah menyediakan alat otomatis untuk ini.

  1. Buka tool "03. Auto-Install Deep Learning Libraries".
  2. Tool ini secara otomatis akan:
    • Mengecek lingkungan Python (environment) Anda.
    • Mengunduh library Deep Learning yang kompatibel.
    • Mengonfigurasi dukungan GPU (CUDA) jika tersedia.
Antarmuka Tool Install
Tips Penting:
Untuk instalasi pertama kali, sangat disarankan membuka ArcGIS Pro dengan cara Klik Kanan > Run as Administrator agar tidak terjadi masalah izin akses (*permission denied*).
  • ✅ Mode Perbaikan: Pilih "Auto Detect & Fix".
  • ✅ Gunakan GPU: Centang jika Anda memiliki kartu grafis NVIDIA agar proses lebih cepat.

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

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

Antarmuka Tool Manage Landsat

Parameter Input

  • Output Geodatabase Lokasi penyimpanan Mosaic 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 di dalamnya.
  • Dataset Type Pilih Level 2 (Surface Reflectance) untuk hasil klasifikasi terbaik.

Catatan: Pastikan opsi “Multispectral” dicentang agar band-band spektral penting ikut terproses.

🧠 Langkah 3: Klasifikasi Tutupan Lahan

Ini adalah inti dari toolbox ini. Tool ini akan membaca Mosaic Dataset Anda dan memprediksi tutupan lahan menggunakan Model Deep Learning (.dlpk).

⚠️ Wajib Mengunduh Model Anda membutuhkan file model pelatihan (.dlpk) untuk menjalankan tool ini.
Unduh Model (.dlpk)
PENTING: Syarat Data Input

Tool klasifikasi ini HANYA BEKERJA dengan data Landsat 8 Level 2 (Surface Reflectance). Jika Anda menggunakan data Level 1 (Digital Number), hasil klasifikasi akan menjadi tidak valid (seperti terdeteksi sebagai "Snow/Ice" atau "Awan" di seluruh area).

Antarmuka Tool Klasifikasi

Parameter Utama

  • Input Raster Pilih Mosaic Dataset yang sudah dibuat pada Langkah 2.
  • File Model (.dlpk) Masukkan file LandCoverClassification.dlpk yang sudah Anda unduh.
  • Output Raster Lokasi penyimpanan hasil klasifikasi.
  • Convert to Polygon Centang jika ingin hasil akhir berupa data vektor (Shapefile/Feature Class).

Pengaturan Lanjutan (Advanced)

  • Processing Mode Biarkan default: PROCESS_AS_MOSAICKED_IMAGE untuk menghindari masalah batas antar citra.
  • Processor Type Pilih GPU untuk performa maksimal. Gunakan CPU hanya jika tidak memiliki GPU NVIDIA.
  • Batch Size Default: 4. Turunkan menjadi 1 jika muncul error "Out of Memory".

Kelas Output (Standar SNI)

Tool ini secara otomatis memetakan piksel ke dalam kelas tutupan lahan standar SNI:

ID Nama Kelas Keterangan
1AirBadan air, sungai, danau, waduk.
2HutanKawasan berhutan dengan tutupan tajuk rapat.
3Area TerbukaPadang rumput atau area terbuka di dalam kawasan hutan.
4RawaLahan basah dan vegetasi yang tergenang.
5PertanianLahan garapan, sawah, perkebunan rakyat.
7Area TerbangunKawasan perkotaan, permukiman, jalan raya.
8Lahan KosongTanah terbuka tanpa vegetasi (tanah gundul).
10AwanArea tertutup awan (Masking).

🔑 Cek Lisensi & Machine ID

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

  1. Buka ArcGIS Pro dan akses Catalog Pane.
  2. Buka toolbox Deep Learning Land Cover.
  3. Klik dua kali pada tool Check License Status (ikon kunci).
  4. Klik Run tanpa mengubah parameter apapun.
  5. Setelah selesai, klik View Details pada jendela hasil.
  6. Salin kode unik yang tertera pada baris ID Mesin.
Contoh Tampilan Output
ID Mesin : BFEBFBFF000306A9

❓ Pemecahan Masalah (Troubleshooting)

Gagal Install / Permission Denied
Tutup aplikasi ArcGIS Pro sepenuhnya. Klik kanan shortcut ArcGIS Pro dan pilih "Run as Administrator". Lalu jalankan tool Instalasi kembali.
Hasil Klasifikasi "Snow/Ice" Semua
Ini terjadi jika Anda menggunakan data Level 1 (DN) pada model yang dilatih untuk Level 2. Pastikan Anda menggunakan data Landsat 8 Collection 2 Level 2 (Surface Reflectance) agar nilai spektralnya sesuai.
Error: CUDA Out of Memory
Pada tool Klasifikasi, buka bagian Advanced Parameters dan kurangi nilai Batch Size menjadi 1.