Rename Sobol sensitivity method

[NicolaCourtier]

Description

Add a check for finite bounds and specify the method by renaming sensitivity_analysis to get_sobol_sensitivities.

Fixes #657

Type of change

Please add a line in the relevant section of CHANGELOG.md to document the change (include PR #).

Important checks:

Please confirm the following before marking the PR as ready for review:

• No style issues: $ pre-commit run or $ nox -s pre-commit (see CONTRIBUTING.md for how to set this up to run automatically when committing locally, in just two lines of code)
• All tests pass: nox -s tests
• The documentation builds: nox -s doctest
• Code is commented for hard-to-understand areas
• Tests added that prove fix is effective or that feature works

[codecov]

Codecov Report

✅ All modified and coverable lines are covered by tests.
✅ Project coverage is 92.11%. Comparing base (4628a65) to head (9e62c38).
⚠️ Report is 56 commits behind head on develop.

Additional details and impacted files

@@             Coverage Diff             @@
##           develop     #938      +/-   ##
===========================================
+ Coverage    89.41%   92.11%   +2.69%     
===========================================
  Files           63       74      +11     
  Lines         4857     5784     +927     
===========================================
+ Hits          4343     5328     +985     
+ Misses         514      456      -58     

☔ View full report in Codecov by Sentry.
📢 Have feedback on the report? Share it here.

🚀 New features to boost your workflow:

• ❄️ Test Analytics: Detect flaky tests, report on failures, and find test suite problems.

[NicolaCourtier]

Alternatively, we can deprecate the function and move SALib into the optional dependencies, as SALib is only used directly in the examples. What do you think @Dibyendu-IITKGP ?

[agriyakhetarpal]

Neat, thanks, I see that this was removed completely! Let's also update this section as well: https://pybop-docs.readthedocs.io/en/latest/installation.html#optional-dependencies

[NicolaCourtier]

Thanks @agriyakhetarpal, I've added the more recent optional dependencies to the docs, good spot!