VRain berhenti di hujan rancangan. Tahap berikutnya — dari hujan menjadi debit — dikerjakan VBasin, program terpisah yang dirancang sebagai pasangan VRain. Ketiganya membentuk alur kerja hidrologi baku:
VRain (hujan rancangan, pola badai) → VBasin (DEM → sub-DAS → debit HEC-HMS) → model hidrodinamik (HEC-RAS, VFlood, …)Setiap panah adalah berkas, bukan salin-tempel angka: VRain menulis
vrain_design_rainfall.json, VBasin membacanya untuk membangun model HEC-HMS, lalu VBasin
mengemas hidrograf hasil simulasi sebagai syarat batas model hidraulik.
Apa yang dilakukan VBasin
| Tab | Isi |
|---|---|
| 1 · DAS | DEM (DEMNAS / HydroSHEDS / Copernicus), alur sungai referensi (OSM atau digitasi), stream burning AGREE, validasi kuantitatif (F1, simpangan, kecocokan batas DAS), delineasi jaringan sub-DAS / junction / reach ala HEC-GeoHMS, Curve Number dari peta tutupan lahan |
| 2A · BANJIR | hujan rancangan (Paket VRain / grid sendiri / hujan-id) → hietograf per sub-DAS → proyek HEC-HMS lengkap siap Compute (satu Run per kala ulang) → laporan debit → paket syarat batas hidrodinamik |
| 2B · DEBIT ANDALAN | hujan historis → model HEC-HMS kontinu → kurva durasi aliran, Q80/Q90/Q95, kalibrasi AWLR |
| 3 · STRUKTUR | penampang, kapasitas Manning, genangan, screening geomorfologi, rencana survei |
| 4 · PROYEK | satu berkas YAML yang merekam seluruh pengaturan agar proyek dapat dijalankan ulang persis |
Dari VRain ke VBasin
Jalankan VRain seperti biasa
VRainMaster, VRainBasin, VRainFreq, atau VRainStorm — semuanya menulis paket hujan rancangan di folder keluarannya:
| Program | Berkas | Isi |
|---|---|---|
| VRainMaster | vrain_design_rainfall.json (+ satu per jalur) | kedalaman areal/titik per kala ulang, DDF dari IDF, per sub-DAS untuk jalur grid |
| VRainBasin | 07_VBasin/vrain_design_rainfall.json | kedalaman DAS + per sub-DAS, DDF, pola Huff terpool, hietograf |
| VRainFreq | ..._vbasin.json di samping ekspor Excel | kedalaman sebaran terpilih (titik) |
| VRainStorm | ..._vbasin_pattern-<durasi>.json | pola waktu saja |
Buka VBasin
Menu Tools → Open VBasin di program VRain mana pun (VBasin dicari di folder VBasin
bersebelahan dengan program VRain; kalau belum ketemu, Anda diminta menunjuk lokasinya sekali).
Delineasi DAS (tab 1), lalu muat paket (tab 2A, panel 1b)
Pilih sumber Paket VRain, tunjuk berkas JSON, klik Muat Paket VRain. VBasin mengambil kedalaman untuk kala ulang yang dicentang — seluruh DAS, atau per sub-DAS bila nama sub-DAS di paket cocok dengan jaringan — dan memuat pola Huff ke tabel hietograf. Nilai bercakupan titik (VRainFreq) diberi peringatan: terapkan ARF atau target areal sendiri.
Bangun hujan rancangan → Build proyek HEC-HMS → Compute → olah hasil
Panel 2 menulis proyek HEC-HMS lengkap (.hms .basin .met .gage .dss .control .run). Setelah
Compute, panel 3 menghasilkan grafik, tabel, laporan, dan — dengan centang paket syarat
batas hidrodinamik — folder batas_hidrodinamik/.
Serahkan ke model hidrodinamik
batas_hidrodinamik/RP<T>/ berisi hydrographs/<Titik>.csv, boundary_points.csv/.gpkg
(koordinat, luas kumulatif, Q puncak), berkas tempel HEC-RAS, daftar pathname DSS, dan potongan
rivers.inflows untuk VFlood — lengkap dengan README cara memakainya.
Semua langkah di atas dapat direkam dalam satu YAML (banjir.rainfall_source: vrain,
vrain_package_path: ...) dan dijalankan ulang dengan vbasin project --control kontrol.yaml
— termasuk menjalankan HEC-HMS tanpa membuka GUI-nya.
Format paket
Spesifikasi lengkap berkas vrain_design_rainfall.json (format vrain-design-rainfall v1.0)
ada di docs/VRAIN_PACKAGE_SPEC.md pada paket rilis VRain dan di repositori VBasin. Ringkasnya:
design_depth.by_return_period (mm, per kala ulang, cakupan basin/point/subbasin),
subbasins[], ddf, temporal_pattern (time_hr, fraction), hyetographs[], notes[].