DOC: Add notebooks

[bzah]

Pull Request to resolve #277, #298

• [ ] Unit tests cover the changes.
• [x] These changes were tested on real data.
• [x] The relevant documentation has been added or updated.
• [x] A short description of the changes has been added to doc/source/references/release_notes.rst.

Describe the changes you made

This PR adds a few notebooks that were initially written by Christian for ISENES to our documentation. This is also a test to make sure the review of jupyter notebooks in PRs is properly enabled via NBReview.

TODO:

• [ ] some cleanup remains, I'm not sure why the pre-commit hooks (in particular ruff) are not applied to the notebooks right now.
• [x] we should include a #Get data section in each notebook in case someone wants to execute them locally. That would describe briefly how to use C4I, how to get the metalink file and how to download dataset from this metalink.
• [x] Add reference to the notebooks in the readme

[review-notebook-app[bot]]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[github-actions[bot]]

Report

File	Stmts	Miss	Cover	Missing
/opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/icclim
_generated_api.py	184	9	95%	17–27
icclim_logger.py	85	29	66%	24, 43, 65, 70–95, 105, 111–142, 150–155
icclim_types.py	13	13	0%	1–21
main.py	283	34	88%	59–65, 125, 134, 415–419, 502, 528–529, 531–532, 534, 536–537, 539–540, 560–567, 637–642, 727, 734, 738–739
utils.py	40	8	80%	14–15, 25–30, 37–41, 43–44
/opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/icclim/ecad
xclim_binding.py	52	8	85%	16–18, 45, 49, 78, 82, 111, 115
/opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/icclim/generic_indices
generic_indicators.py	498	98	80%	49–55, 68, 72, 89, 93, 97, 110–113, 117, 191, 333–337, 339–343, 389, 420–421, 723–724, 759, 765, 773–774, 794, 958–962, 964–965, 983–989, 993, 1021, 1023, 1091–1092, 1125–1151, 1179–1199, 1215, 1224–1225, 1252–1284, 1290–1293, 1315
standard_variable.py	48	1	98%	19
threshold.py	411	34	92%	49–54, 210–211, 233, 237, 285, 301–303, 318–322, 326–330, 410, 552–553, 616–621, 716–717, 912, 935–936, 941, 1015–1016, 1019–1023, 1111–1113
/opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/icclim/models
cf_calendar.py	35	1	97%	20
climate_variable.py	106	21	80%	27–34, 107–113, 168–169, 178, 214–218, 221, 261, 265–269, 296–297, 334
frequency.py	180	15	92%	36–38, 174–177, 321–327, 331, 414–418, 440, 445
global_metadata.py	6	6	0%	1–9
index_config.py	27	5	81%	7–11
index_group.py	38	2	95%	33–37
logical_link.py	21	1	95%	12
operator.py	31	3	90%	10, 15–19
standard_index.py	30	6	80%	7–10, 59, 62, 66
user_index_dict.py	20	20	0%	1–28
/opt/hostedtoolcache/Python/3.9.18/x64/lib/python3.9/site-packages/icclim/pre_processing
in_file_dictionary.py	8	8	0%	1–29
input_parsing.py	205	53	74%	22–28, 81–82, 86–87, 92–97, 111–112, 178, 183–187, 190, 200–201, 212–216, 242, 256, 270, 291–296, 300, 302, 310–315, 320–325, 336–337, 351–358, 369–389, 428
rechunk.py	89	6	93%	21–22, 43–44, 48, 137
TOTAL	2655	381	86%

Test results

Tests	Skipped	Failures	Errors	Time
192	0 :zzz:	0 :x:	0 :fire:	1m 40s :stopwatch:

[bzah]

@pagecp it looks like ReviewNB is working, if you wish you can review (and comment!) on the notebooks that were added.