Tunny Icon
TunnyDocs

The next-gen Grasshopper optimization tool.

Sobol

Overview

Sobol sensitivity indices quantify parameter importance through variance decomposition of the objective function. They work for linear and nonlinear functions alike and can measure interaction effects between parameters. Values are in [0, 1].

Tunny Dashboard provides two indices:

Index Symbol Meaning
First-order SiS_i Fraction of variance explained by xix_i alone
Total-effect STiST_i xix_i alone plus all interactions involving xix_i

Theory

The objective's variance is decomposed as:

Var(Y)=iVi+i<jVij++V1..p\operatorname{Var}(Y) = \sum_i V_i + \sum_{i<j} V_{ij} + \cdots + V_{1..p}

First-order index:

Si=ViVar(Y)S_i = \frac{V_i}{\operatorname{Var}(Y)}

Total-effect index:

STi=1Var(E[YXi])Var(Y)ST_i = 1 - \frac{\operatorname{Var}(E[Y \mid X_{\sim i}])}{\operatorname{Var}(Y)}

where XiX_{\sim i} means "all parameters except xix_i." STiSiST_i \geq S_i always holds. A large gap (STiSi)(ST_i - S_i) indicates strong interactions.

Note on finite-sample estimates: the Saltelli first-order estimator and the Jansen total-effect estimator are computed independently, so raw estimates can violate ST^iS^i\hat{ST}_i \geq \hat{S}_i in finite samples. Tunny Dashboard enforces the property after estimation by taking ST^imax(ST^i,S^i)\hat{ST}_i \leftarrow \max(\hat{ST}_i, \hat{S}_i) before clamping both values to [0,1][0, 1].

How Tunny Dashboard Computes This

Because Monte Carlo integration is impractical for real trial data, a quadratic Ridge surrogate is fitted on the trials, and Saltelli sampling is run on that surrogate using the Jansen estimator.

Parameters

Setting Value
Saltelli sample count NN 1,024
Ridge regularization strength α\alpha 1.0
Random number generator ChaCha8 (deterministic, seed 0xDEAD_BEEF_1234_5678)

Interpreting Results

  • SiS_i high, STiSiST_i \approx S_i → parameter has a large independent effect, few interactions.
  • SiS_i small, STiST_i high → parameter mainly acts through interactions with others.
  • Both near zero → parameter has little influence on the objective.

Strengths and Limitations

Strengths:

  • Handles linear, nonlinear, and interaction effects.
  • Values in [0, 1] allow easy comparison across parameters.
  • STSST - S quantifies interaction strength.

Limitations:

  • Results depend on surrogate model quality (quadratic Ridge).
  • Accuracy decreases when the true function is highly nonlinear.
  • Categorical parameters are label-encoded (string labels → integer IDs 0.0, 1.0, …); Sobol indices for categoricals are approximate because integer IDs carry no ordinal/distance information.

When to Use

  • When interactions between parameters are important.
  • When a global, model-agnostic sensitivity measure is needed.
  • After Spearman / Ridge screening identifies top candidates.

References

  • Saltelli, A. et al. (2010). Variance based sensitivity analysis of model output. Design and estimator for the total sensitivity index. Computer Physics Communications, 181(2), 259–270. https://doi.org/10.1016/j.cpc.2009.09.018
  • Jansen, M. J. W. (1999). Analysis of variance designs for model output. Computer Physics Communications, 117(1), 35–43. https://doi.org/10.1016/S0010-4655(98)00154-4
  • Sobol, I. M. (1993). Sensitivity estimates for nonlinear mathematical models. Mathematical Modelling and Computational Experiments, 1(4), 407–414.