Steps to setup and run VIC and VIC-Res:

####################### rainfall-runoff #######################
---------------------------------------------------------------
1) The 'input' folder contains the climate forcings that will go to the rainfall-runoff model. In each input file, the rows represent the days (1/1/2005 to 31/12/2020), and four columns represent the data corresponding to precipitation (mm), maximum temperature (°C), minimum temperature (°C), and wind speed (m/sec). 

2) The 'output' folder (../rainfall-runoff/output) will store your simulated hydrological fluxes (runoff, evapotranspiration, soil moisture, and others).

3) The 'src' folder should contain the source code for the VIC model, version 4.x, which can be downloaded from https://vic.readthedocs.io/en/master/. Make sure you have already installed the dependent compilers (C and Fortran) to build the 'make' file (../rainfall-runoff/src).

4) Edit and save the 'global.param.txt' file, indicating the path to the desired supporting files (soil and vegetation) and the run period.

5) Go to ../rainfall-runoff/src and run the rainfall-runoff model:
a) make clean
b) make
c) ./vicNl -g ../global_param.txt

6) Run the routing model once the rainfall-runoff model run is completed.

####################### routing #######################
----------------------------------------------------------------------- 
1) The outputs of the rainfall-runoff model will be the inputs for routing. Copy the files from ../rainfall-runoff/output to ../routing/input. 

2) Edit and save the 'configuration_cs.txt' file, indicating the path to the desired supporting files (reservoir, flow direction, station to route) and the run period.

3) The 'src' folder contains the source code for the VIC-Res model, which can be downloaded from https://github.com/Critical-Infrastructure-Systems-Lab/VICRes. Note that the VIC-Res model includes several options for representing reservoirs. In this specific implementation, we use the option 6 (Predefined reservoir volume time series data). Additional details are provided on the GitHub repo.

4) Go to ../routing/src and run the routing model:
a) make clean
b) make
c) ./rout ../configuration_cs.txt

5) The final output files will be saved in ../routing/output

####################### Ex-post analysis #######################
----------------------------------------------------------------------- 

The model output can be compared against measured discharge at Chiang Sean, which are available on the database of the Mekong River Commission (https://portal.mrcmekong.org/home).