Improve Getting Started notebooks

[brosaplanella]

Description

This PR aims to improve and simplify the Getting Started notebooks so they are a better resource to new users (I am assuming users could have very limited Python knowledge). It is still work in progress.

Main changes

• Tutorial 1: minor text changes.
• Tutorial 2: minor text changes.
• Tutorial 3: removed the part where two simulations (DFN & SPM) got the voltage components plot together as it used some additional plotting functionality outside of PyBaMM. Also implemented the new API for plot_voltage_components which matches the functionality of plot.
• Tutorial 4: removed the drive cycle example, as I believe we should encourage users to use the experiment class for that. This also means we do not need to import os for this notebook.
• Tutorial 5: minor text changes plus extra detail added on the cycle and step definition.
• Tutorial 6: minor text changes.
• Tutorial 7: minor text changes plus list of notebooks with other examples.
• Tutorial 8: minor text changes, including the fact that the fast solver postprocess the solution and trims the interval past the cut-off voltage (so the discussion was wrong).
• Tutorial 9: minor text changes.
• Tutorial 10: I wanted to move it to Creating Models folder, but it seems a duplication of 3-negative-particle-problem.ipynb` so I deleted it.
• Tutorial 11: moved to Creating Models folder (which will be addressed at a later stage).

Questions

• Tutorial 4: do we want to show how to define your own parameter set as a file? I would say no (or at least not in this notebook),

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[codecov]

Codecov Report

All modified and coverable lines are covered by tests ✅

Project coverage is 99.60%. Comparing base (bc31cac) to head (2dd7baa).
Report is 1 commits behind head on develop.

Additional details and impacted files

@@           Coverage Diff            @@
##           develop    #3750   +/-   ##
========================================
  Coverage    99.60%   99.60%           
========================================
  Files          259      259           
  Lines        21270    21270           
========================================
  Hits         21186    21186           
  Misses          84       84           

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

[brosaplanella]

Addressed the comments and fixed a small typo in the parameter argument of current_with_time.

[kratman]

Looks good to me

[agriyakhetarpal]

I can leave a review later in the day today; adding a note to self that broken links should be checked across the documentation and that the links on https://pybamm.org/learn/ would have to be updated in accordance with these changes

[kratman]

@brosaplanella Just noticed these in the doc tests. Missed it before

/home/runner/work/PyBaMM/PyBaMM/docs/source/user_guide/index.md:45: WARNING: toctree contains reference to nonexisting document 'source/examples/notebooks/getting_started/tutorial-10-creating-a-model'
/home/runner/work/PyBaMM/PyBaMM/docs/source/user_guide/index.md:45: WARNING: toctree contains reference to nonexisting document 'source/examples/notebooks/getting_started/tutorial-11-creating-a-submodel'
/home/runner/work/PyBaMM/PyBaMM/docs/source/examples/index.rst:10: WARNING: toctree contains reference to nonexisting document 'source/examples/notebooks/getting_started/tutorial-10-creating-a-model'
/home/runner/work/PyBaMM/PyBaMM/docs/source/examples/index.rst:10: WARNING: toctree contains reference to nonexisting document 'source/examples/notebooks/getting_started/tutorial-11-creating-a-submodel'
looking for now-outdated files... none found
pickling environment... done
checking consistency... /home/runner/work/PyBaMM/PyBaMM/docs/source/examples/notebooks/creating_models/7-creating-a-submodel.ipynb: WARNING: document isn't included in any toctree

[kratman]

@brosaplanella Is this ready to go now?

[valentinsulzer]

Looks great, thanks, would just suggest giving more info on adding your own parameter set in tutorial 4

[brosaplanella]

Should I add a short paragraph explaining that the option exists and pointing to the example, or did you mean a fully fleshed example?

[valentinsulzer]

Something that says you can create custom parameter values by passing in a dictionary, with an example including a couple of scalars and a function, e.g.

def cubed(x):
    return x ** 3

parameter_values = pybamm.ParameterValues({
    "a": 1,
    "b": 2,
    "c": cubed,
})

• explain that the function object itself should be passed in without being called

Then provide a link to the folder of .py files of parameters where people can find an example to copy for their own custom parameter sets

[kratman]

@brosaplanella I will re-review this afternoon so we can get these updates in there