diff --git a/docs/source/A2.4_hymod.rst b/docs/source/A2.4_hymod.rst index 83179f0..7e7d7cf 100644 --- a/docs/source/A2.4_hymod.rst +++ b/docs/source/A2.4_hymod.rst @@ -34,22 +34,29 @@ The tutorial includes the following steps: 1. Introduction to HYMOD ^^^^^^^^^^^^^^^^^^^^^^^^ -`1.1 - Introduction to a simple hydrologic model (HYMOD) <#hymod>`__ -`1.2 - Input Data <#inputs>`__ `1.3 - Running a basic -simulation <#baseline>`__ `1.4 - Model outputs <#outputs>`__ +`1.1 - Introduction to a simple hydrologic model (HYMOD) <#hymod>` + +`1.2 - Input Data <#inputs>` + +`1.3 - Running a basic simulation <#baseline>` + +`1.4 - Model outputs <#outputs>` 2. Global Sensitivity Analysis ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ -`2.1 - Design of Experiments <#sensitivity>`__ `2.2 - Sensitivity -analysis for one output <#sa_metrics>`__ `2.3 - Sensitivity analysis -across multiple outputs <#diff_performance>`__ `2.4 - Time-varying -sensitivity analysis <#TVSA>`__ +`2.1 - Design of Experiments <#sensitivity>` + +`2.2 - Sensitivity analysis for one output <#sa_metrics>` + +`2.3 - Sensitivity analysis across multiple outputs <#diff_performance>` + +`2.4 - Time-varying sensitivity analysis <#TVSA>` 1 - Introduction to HYMOD ========================= -# 1.1- Overview +1.1 Overview HYMOD is a hydrologic model (rainfall-runoff model) that simulates key hydrologic fluxes such as infiltration, streamflow and @@ -95,10 +102,7 @@ Kq values of all three linear reservoirs are the same) :math:`K_s`: Slow flow residence time of linear infinite reservoir -.. figure:: ./figs/hymod_schematic-DAVE.png - :alt: Title - - alt text +.. image:: _statichymod_schematic-DAVE.png Vertical Processes ~~~~~~~~~~~~~~~~~~ @@ -108,9 +112,9 @@ HYMOD models the fraction of water that is stored in the soil .. math:: F(XH_{uz}) = 1 - (1 - \frac{XH_{uz}}{H_{uz}})^{B} -where *:math:`XH_{uz}`* is the water storage capacity of the soil; -**:math:`H_{uz}`** is the parameter describing basin maximum water -storage capacity (mm); and **:math:`B`** is the parameter describing the +where :math:`XH_{uz}` is the water storage capacity of the soil; +:math:`H_{uz}` is the parameter describing basin maximum water +storage capacity (mm); and :math:`B` is the parameter describing the degree of spatial variability within the basin. The portion of precipitation that exceeds the water storage capacity is @@ -135,7 +139,7 @@ H. V., & Sorooshian, S. (2001). A framework for development and application of hydrological models. Hydrology and Earth System Sciences, 5(1), 13-26. -### 1.2 Input data +1.2 Input data The HYMOD model only requires precipitation and potential evapotranspiration as inputs. For this example, we’ll run HYMOD using @@ -308,7 +312,7 @@ while rainfall labels are shown on the right y-axis. .. image:: _static/hymod1.png -### 1.3 Running a Baseline Model Simulation +1.3 Running a Baseline Model Simulation We’ll start our experiment by running HYMOD using its default parameters. @@ -395,7 +399,7 @@ observed streamflow and the LOG(RMSE) is fairly low. 2- Global Sensitivity Analysis ============================== -## 2.1- Experimental Design and Setup +2.1 Experimental Design and Setup Now we’ll examine how sensitive streamflow simulations generated by HYMOD are to the model’s input parameters. We’ll perform global @@ -583,7 +587,7 @@ observed streamflow. -### 2.2 - Sensitivity of streamflows to model parameters +2.2 Sensitivity of streamflows to model parameters Now we’ll examine how each of HYMOD’s parameters impact the variance of simulated streamflows. Using SALib we’ll calculate the first order and @@ -909,7 +913,7 @@ interaction between Alp and Ks. -## 2.4 Time-Varying Sensitivity Analysis +2.4 Time-Varying Sensitivity Analysis In section 2.5 we saw how performing sensitivity analysis on different measurements of model output can yeild in different results on the diff --git a/docs/source/_static/hymod_schematic-DAVE.png b/docs/source/_static/hymod_schematic-DAVE.png new file mode 100644 index 0000000..83406b4 Binary files /dev/null and b/docs/source/_static/hymod_schematic-DAVE.png differ