How to run the Jupyter notebooks for RHESSys End-to-End modeling workflows

This Readme file provides the users with the step-by-step guide to successfully run the three developed notebooks.
The steps, in the order they need to be taken, are explained in what follows.

STEP 0: Preliminary step

In this step the researchers make sure that they have access to the content files of the resource and required compute platform.
- In order to be able to run the three Jupyter notebooks, researchers need to first have a HydroShare account.
- If the researchers do not have access to CyberGIS-Jupyter for water (CJW), they need to submit an access request to CyberGIS-Jupyter for water.

• To run this notebook:
  1. Click the OpenWith button in the upper-right corner of this HydroShare resource webpage;
  2. Select "CyberGIS-Jupyter for water";
  3. Open the notebook and follow instructions;

STEP 1: Execute 'Step_0_B_Download_Model_Input_CoweetaSub18_and_Compile_RHESSys_EC7_2.ipynb' in CJW

In this step, first, users run the notebook to create model directory, downlaod raw RHESSys input, and compile RHESSysEC 7.2

STEP 2: Execute 'Step_2_A_Delineate_Watershed_and_Reclassify_NLCD_and_Soil_Map.ipynb' in CJW

In this step, users run the notebook to delineate DEM, extract land cover, and SSURGO map at Coweeta subbasin18.

STEP 3: Execute 'Step_2_B_Create_Landuse_Fraction_Definition_Flow_and_Worldfiles_Model_Input.ipynb' in CJW

In this step, users run the notebook to create land use fraction, definition, flow, and worldfiles for RHESSys input.

STEP 4: Execute 'Step_2_C_Create_Time_Series_Model_Input.ipynb' in CJW

In this step, first, users run the notebook to create RHESSys time-series input

STEP 5: Execute 'Step_3_A_Execute_RHESSys_as_Single_Run.ipynb' in CJW

In this step, users run the notebook to execute RHESSys as singlue run

STEP 6: Execute 'Step_3_B_Execute_RHESSys_as_Ensemble_Run.ipynb' in CJW

In this step, users run the notebook to execute RHESSys as ensemble runs

STEP 7: Execute 'Step_3_C_Submit_Parallel_Jobs_to_XSEDE.ipynb' in CJW

In this step, users run the notebook to execute RHESSys with HPC

STEP 8: Execute 'Step_3_D_Calibrate_RHESSys_Automatically_using_SPOTPY_Uniform.ipynb' in CJW

In this step, users run the notebook to execute RHESSys with SPOTPY to automatically calibrate it (takes long time to calibrate using MCMC)

STEP 9: Execute 'Step_3_E_Visualize_Model_Output_with_Map.ipynb' in CJW

In this step, users run the notebook to visualize Model output with map visualization