A general introduction to the rationale and architecture of SAFE is given in:
Detailed documentation on how to use the toolbox is given in the workflow scripts provided with the Toolbox and in the help of each function.
We published a range of papers on Global Sensitivity Analysis that provide the methodological background of the methods implemented in SAFE, and provide practical guidance on how to set-up the analysis and interpret the results.
What is GSA useful for? Why and how should it be used in the first place?
A literature review of GSA applications in the context of earth systems modelling, focusing on what can be learnt about the construction, testing and use of environmental models through the application of GSA. This paper could be a useful starting point to explore the type of questions GSA can address:
Wagener, T. & Pianosi, F. (2019), What has Global Sensitivity Analysis ever done for us? A systematic review to support scientific advancement and to inform policy-making in earth system modelling, Earth-Science Reviews, 149, 1-18.
How to set-up a GSA (how to choose the GSA method, the sampling strategy, the sample size, etc.)?
A general introduction on the key choices in setting-up GSA with references for further reading is given in:
Pianosi, F., Beven, K., Freer, J.W. Hall, J. Rougier, J. Stephenson, D.B., Wagener, T. (2016), Sensitivity analysis of environmental models: A systematic review with practical workflow, Environmental Modelling & Software, 79, 214-232. (Open Access)
More discussion on the practical effects of some of the key set-up choices, and how to interpret them, is given in:
Noacco, V., Sarrazin, F., Pianosi, F. and Wagener, T. (2019), Matlab/R workflows to assess critical choices in Global Sensitivity Analysis using the SAFE toolbox, MethodX, 6, 2258-2280.
Specific discussion on the choice of sample size for EET, RSA and VBSA can be found in:
Sarrazin, F., Pianosi, F., Wagener, T. (2016), Sensitivity analysis of environmental models: Convergence and validation Environmental Modelling & Software, 79, 135-152. (Open Access)
An introduction to the benefits of SAFE/GSA through interactive Jupyter Notebooks (these interactive examples can be run from the browser):
* Using GSA to enhance model-informed decisions: application example to a flu model
* Using GSA to identify the most influential model parameters: application to a hydrological model
* Using GSA to find the key controls of a system: an ecological model example