Pemecahan Masalah WBPP: Kesalahan Umum dan Bug yang Diketahui

Artikel ini disusun dari catatan tahun 2022–2025; sebagian alat atau alur kerja sudah diperbarui, jadi mohon diperhatikan saat membacanya. Pesan kesalahan dan perilaku versi yang disebutkan di dalamnya semuanya dicatat sebagaimana adanya pada waktu itu. Untuk antarmuka WBPP, master kalibrasi, dan alur eksekusi normalnya, silakan lihat artikel pendamping “The Complete Guide to WBPP”.

Menjalankan WBPP dari awal sampai akhir hanya dengan satu klik memang terasa memuaskan, tetapi begitu benar-benar dipakai, Anda selalu saja menemui situasi ketika prosesnya macet, memunculkan pesan kesalahan, atau hasilnya terasa tidak beres. Artikel ini merangkum beberapa kategori masalah WBPP yang saya temui selama beberapa tahun terakhir — dan yang paling sering ditanyakan kepada saya — menjadi sebuah buku pegangan pemecahan masalah, mulai dari cara berpikir dalam mendiagnosis sampai beberapa bug yang sudah diketahui.

Langkah Pertama Pemecahan Masalah: Lihat Dulu Process Console

Ketika pemrosesan di PixInsight bermasalah, hal pertama yang harus selalu Anda ingat adalah melihat Process Console. Ia akan memberi tahu di mana kesalahan itu terjadi dan jenis kesalahannya apa; inilah titik awal dari semua diagnosis.

Hanya saja WBPP adalah sebuah skrip, dan selama skrip itu tidak sedang berjalan, console akan terlipat dan tidak dapat dipilih. Jadi kalau ingin melihat console, sering kali Anda harus menutup WBPP terlebih dahulu. Kedengarannya merepotkan, tetapi inilah satu-satunya sumber petunjuk untuk banyak masalah — pemecahan beberapa bug di bawah ini semuanya berawal dari satu baris tulisan merah di console itu.

Kegagalan dan Bug pada Tahap Kalibrasi

Kalibrasi gagal (failed) — tutup dulu PI lalu buka lagi. Jika saat menjalankan WBPP kalibrasi awalnya (yang memakai master kalibrasi) langsung gagal dan status menampilkan failed berwarna merah, Anda bisa menghentikan sementara seluruh alurnya, lalu menutup PI, membuka kembali WBPP, dan menjalankannya sekali lagi; kesalahan kalibrasi gagal ini biasanya lalu menghilang. Saat memproses citra OSC, saya sudah menemui bug ini setidaknya empat kali atau lebih, dan setiap kali selalu beres dengan jurus yang sama.

Flat terus-menerus gagal dikalibrasi — kembalilah ke pemrosesan manual langkah demi langkah. Beberapa versi WBPP memiliki bug yang membuat kalibrasi flat terus-menerus bermasalah. Pada saat seperti ini, kemampuan memproses sendiri selangkah demi selangkah secara manual menjadi penting. Sekalian mari kita ulas kembali tahapan Pre-Process:

1. Calibration: light − dark / ((flat − flat dark) * med(flat))
2. Cosmetic Correction
3. Debayer: melakukan interpolasi pada matriks Bayer
4. Star Alignment
5. NSG
6. Integration

Ketika otomatisasi tidak bisa diandalkan, memecah alurnya dan menjalankannya secara manual justru lebih memudahkan Anda menentukan di langkah mana masalahnya berada.

Masalah Path: Dua Kemungkinan Penyebab File I/O Error

Saat menggunakan WBPP di Windows, jika pada tahap kalibrasi (calibration) muncul File I/O Error, biasanya penyebabnya salah satu dari dua hal berikut:

1. Path file ditambah nama filenya terlalu panjang, melebihi batas sistem sehingga perlu dipendekkan.
2. Folder tujuan tidak dapat ditulisi, misalnya karena output disetel ke folder sistem.

Penyebab pertama adalah yang paling sering terjadi. Untuk menyembuhkan “path terlalu panjang” sampai ke akarnya, Anda dapat mengaktifkan dukungan path panjang di Windows (lewat regedit, setel LongPathsEnabled ke 1); selain itu disarankan pula menghindari path yang mengandung karakter non-ASCII (misalnya, aksara Tionghoa). Langkah rinci untuk kedua persiapan lingkungan ini sudah saya tulis di bagian pengaturan lingkungan Windows dalam “The Complete Guide to WBPP”, jadi tidak saya ulangi di sini.

Bug Koordinat RA/DEC “60 Detik Tidak Dinaikkan”

Ini adalah masalah yang paling rumit sekaligus paling layak diangkat tersendiri, karena gejalanya bermacam-macam sementara akar penyebabnya sama saja: koordinat asensiorekta/deklinasi di dalam FITS Header memiliki nilai detik “60” yang tidak pernah dinaikkan ke satuan berikutnya.

Saya pernah menemuinya dua kali, pada versi yang berbeda dan dengan wujud gejala yang berbeda pula.

Kali pertama: WBPP tidak dapat memuat file. Saya menutup WBPP lalu melihat Process Console, dan menemukan bahwa suatu baris pada sebuah skrip js melaporkan “koordinat tidak valid”. Waktu itu saya mengira itu bug WBPP; pesan kesalahannya saya cari di internet, dan barulah saya menemukan beberapa laporan kesalahan yang sama persis di PixInsight Forum — ternyata masalah koordinatlah yang membuat citra tidak dapat dimuat ke WBPP. Sudah punya arah pun, saya tetap menghabiskan satu jam mengaduk-aduk ratusan frame light sampai berhasil menemukan citra yang bermasalah itu: koordinat OBJCTDEC-nya keliru. Saya buka process FITSHeader di PI, gulir sampai OBJCTDEC, lalu ubah nilai yang “semestinya dinaikkan tetapi tidak dinaikkan” itu — pada contoh ini -69 26 60 saya ubah menjadi -69 27 0 — dan frame ini pun langsung termuat dengan lancar, dan file-file sesudahnya tidak lagi tersendat karenanya.

Kali kedua: file tidak bisa ditambahkan, console melaporkan too much recursion. Belakangan saya menemuinya lagi: saat menambahkan file ke WBPP, perangkat lunaknya macet, dan hasilnya sama sekali tidak ada file yang tertambah. Saya tutup WBPP lalu lihat Console, dan yang muncul adalah InternalError: too much recursion berwarna merah. Setelah membuka ulang WBPP, ternyata sebagian file sudah termuat dan sebagian belum; saya periksa yang belum termuat, dan benar saja, lagi-lagi FITS Header yang menyimpang — kali ini DEC tertulis -46 01 60, padahal detik “60” semestinya dinaikkan menjadi -46 02 00. Begitu WBPP membaca nilai menyimpang seperti ini, ia akan macet, dan ikut membuat citra-citra berikutnya tidak dapat dimuat pula. Sama seperti sebelumnya, buka FITS Header lalu naikkan detiknya secara manual; setelah diperbaiki, tinggal tambahkan ulang filenya. Ketika semua file berhasil dimuat, WBPP akan otomatis memunculkan pesan diagnostik, misalnya “60 of 60 light frames were added”.

Kesimpulan bersama: masalah koordinat yang tidak dinaikkan secara otomatis ini, sejauh yang saya lihat sampai sekarang, hampir semuanya terjadi pada situasi ketika perangkat lunak pemotretannya adalah MDL (kendali jarak jauh), tetapi saya tidak bisa mengesampingkan kemungkinan perangkat lunak pemotretan lain mengidap penyakit yang sama. Jadi, setiap kali WBPP macet dan file tidak bisa ditambahkan, periksalah dulu Process Console untuk memastikan jenis kesalahannya, lalu periksa apakah Header RA/DEC mengidap bug “60 detik tidak dinaikkan”; setelah diperbaiki secara manual, umumnya masalahnya beres.

Performa: Mengapa Paket Lengkapnya Berjalan Begitu Lama

Terakhir, mari bicara soal masalah yang secara ketat sebenarnya bukan “kesalahan” tetapi sangat menyiksa — paket lengkap WBPP benar-benar terlalu lambat. Saya pernah membiarkan paket lengkap berjalan penuh empat jam hanya demi lima citra yang hendak saya jadikan HDR (mesin saya waktu itu AMD R5-4650G, DDR4 3200 32GB, Gen4 SSD, dengan citra 24 megapiksel; penantian semacam ini sungguh membuat orang ingin ganti komputer).

Ada dua bagian yang sangat memakan waktu:

1. Separated RGB: memproses kanal RGB dari foto berwarna secara terpisah untuk menghilangkan aberasi kromatik.
2. Local Normalization: memilih beberapa citra terbaik sebagai acuan, lalu menerapkan Local Normalization pada citra-citra lainnya.

Jika kedua hal ini dimatikan, WBPP akan jauh lebih cepat. Perlu tidaknya mengorbankan keduanya demi kecepatan bergantung pada seberapa tinggi tuntutan Anda terhadap hasil akhir — untuk pengukuran nyata soal “langkah mana yang dimatikan, berapa banyak waktu yang dihemat, dan berapa banyak kualitas yang hilang”, ada satu set data yang menunjukkan percepatan 7–8 kali lipat di “The Complete Guide to WBPP” yang bisa Anda jadikan acuan.

---

Mari kita rangkum inti dari buku pegangan pemecahan masalah ini: begitu ada masalah, lihat dulu Process Console; kalau kalibrasi failed, tutup PI lalu buka lagi; kalau flat terus-menerus gagal dikalibrasi, kembalilah ke pemrosesan manual langkah demi langkah; File I/O Error umumnya karena path terlalu panjang atau folder tidak dapat ditulisi; kalau tidak bisa memuat, macet, atau melaporkan recursion, periksalah apakah RA/DEC di FITS Header punya detik 60 yang tidak dinaikkan. Hafalkan beberapa jurus ini, dan sebagian besar tabiat WBPP sudah bisa Anda hadapi.