VFlood
Panduan Cepat

2. Panduan cepat

Jika Anda sudah punya folder proyek RRI (berisi RRI_Input.txt + topo/, rain/, dst — baik proyek RRI asli maupun proyek baru, formatnya identik):

vflood-rri path/to/RRI_Input.txt

Perintah ini mencetak ringkasan grid yang ter-load, lalu menjalankan simulasi penuh dan menulis berkas output sesuai yang ditentukan di RRI_Input.txt (./out/hs_, ./out/hr_, ./out/... — konvensi sama seperti RRI asli: prefix + angka step dengan zero-padding + .out).

Flag yang berguna:

vflood-rri RRI_Input.txt --hours 3     # uji cepat: hanya simulasi 3 jam pertama
vflood-rri RRI_Input.txt --quiet       # menonaktifkan progress printing per-step

Catatan tentang --hours: opsi ini juga mengubah cadence output agar tetap mendapat satu snapshot per jam (bukan memakai outnum asli yang mengasumsikan durasi run penuh). Jangan gunakan --hours untuk run sungguhan yang ingin dipertahankan — ini hanya untuk smoke-test.

Contoh

vflood-rri "D:\...\rokan15s_\_RRI_Input.txt"

Contoh output:

vflood-rri: D:\...\RRI_Input.txt  (388x446 grid, 5597 river cells, 87582 active cells, 264h @ dt=600s)
  step    1  t=      3600s  hs_max=0.0001  hr_max=0.0003  qr_max=0.0001
  step    2  t=      7200s  hs_max=0.0002  hr_max=0.0016  qr_max=0.0020
  ...
VFlood-RRI: done in 187.4s

Melanjutkan (resuming) sebuah run

Field init_slo/riv/gw/gampt_ff_switch + initfile_slo/riv/gw/ gampt_ff di RRI_Input.txt (tidak berubah dari upstream RRI) memungkinkan run dimulai dari state tersimpan, bukan selalu cold-start dari nol — set switch menjadi 1 dan arahkan initfile_* ke grid yang sesuai.

Format .out yang sama persis (yang sudah ditulis setiap simulasi) dapat dipakai sebagai init file: reader RRI.f90 hanya “meng-clamp” nilai <= 0 menjadi 0 — termasuk sentinel “di luar domain” bernilai -0.1 di dalam .out. Jadi cara resume yang paling natural adalah menunjuk initfile_hs/initfile_hr/dll langsung ke berkas output run sebelumnya: hs_NNNNNN.out/hr_NNNNNN.out.

Satu hal yang tidak dilakukan otomatis: menggeser data curah hujan/batas (boundary) agar sesuai jam resume. Seperti RRI asli, jam internal VFlood-RRI selalu mulai ulang dari t=0 pada setiap run, init file atau tidak — file rain.dat/boundary dibaca berdasarkan origin waktunya sendiri, terlepas state yang dimuat.

Jika Anda memberi “resume run” dengan rain.dat asli (full-storm) maka storm akan “diputar” dari awal lagi di atas state yang sudah banjir, sehingga hasil akan cepat menyimpang (divergence terverifikasi: salah mengerjakan ini menghasilkan sekitar 1 menit error palsu pada hr dalam 3 jam). Workflow yang benar adalah menyiapkan rain.dat baru yang t=0-nya sama dengan titik resume.

Contoh: resume dari jam ke-48, maka kurangi 48*3600 dari setiap timestamp pada rain.dat asli, buang record yang menjadi negatif, lalu arahkan run resume ke config yang menunjuk ke file yang sudah dipotong.

Dengan state yang benar + rain.dat yang sudah time-shift, uji resume 3 jam akan cocok dengan run kontinu yang setara hingga level milimeter — ini bukan kebetulan, melainkan pengecekan reproduktif yang nyata.