Package: safepython
SAFEpythonPython version of the Sensitivity Analysis for Everybody (SAFE) Toolbox.BEFORE STARTINGAn introduction to the SAFE Toolbox is provided in the paper:Pianosi, F., Sarrazin, F., Wagener, T. (2015), A Matlab toolbox for Global Sensitivity Analysis, Environmental Modelling & Software, 70, 80-85. The paper is freely available at:https://doi.org/10.1016/j.envsoft.2015.04.009We recommend reading this (short) paper before getting started. Other reading materials, including general introductions to Sensitivity Analysis and case study applications, can be found at:https://safetoolbox.github.ioINSTALLING THE PACKAGEOption 1: Installing the package using pippip install safepythonOption 2: Installing a local version of the package (if you want to customize the code)Download the SAFEpython source code to your computer. You go into the SAFE-Python folder and execute:pip install .NotesYou can execute the previous commands from python command line (e.g. Anaconda prompt).From command line, you should use:option 1:python -m pip install safepythonoption 2:python -m pip install .For windows users: python cannot be called directly from Windows command line. You have to go into the folder in which python is installed and then execute:option 1:python -m pip install safepythonoption 2:python -m pip install mydir\SAFE-python(mydir is the directory in which the SAFEpython folder is saved, and it shoud not contain which spaces)If you want to install the package without administrator rights, you may have to use:pip install --user .GETTING STARTEDTo get started using SAFE, we suggest opening one of the workflow scripts in the 'examples' folder available in thegithub repositoryand running the code step by step. The header of each workflow script gives a short description of the method and case study model, and of the main steps and purposes of that workflow, as well as references for further reading. The name of each workflow is composed as: workflow_method_modelImplemented models are:the hydrological Hymod modelthe hydrological HBV modelthe Ishigami and Homma test functionthe Sobol' g-functionImplemented methods are:eet (elementary effects test, or method of Morris)fast (Fourier amplitude sensitivity test)pawnrsa (regional sensitivity analysis)vbsa (variance-based sensitivity analysis, or method of Sobol')Furthermore, SAFE includes additional workflow scripts:external: how to connect SAFE to a model running outside pythontvsa: how to apply GSA methods to perform time-varying sensitivity analysisvisual: how to use visualisation functions for qualitative GSAIf the user still has no clear idea of what method(s) to start with, we suggest one of the three most widely used methods: eet (e.g. workflow_eet_hymod), rsa (workflow_rsa_hymod), vbsa (workflow_vbsa_hymod) or the visualization workflow (workflow_visual_ishigami_homma.m).NotePlease make sure that you download the version of the 'examples' folder that corresponds to the version of SAFEpython package you are using. To use the latest version of SAFEpython, you can update the package using:pip install --upgrade safepythonHOW TO CITE SAFEPYTHONIf you would like to use the software, please cite it using the following:Pianosi, F., Sarrazin, F., Wagener, T. (2015), A Matlab toolbox for Global Sensitivity Analysis, Environmental Modelling & Software, 70, 80-85, doi: 10.1016/j.envsoft.2015.04.009.