Add underflow discussion to HSGP-Basic

[Armatron44]

Hi all,

Added a section to address underflow in HSGPs as discussed here pymc-devs/pymc#7881. There's also a typo fix in the markdown cell that discusses m and c for matern52.

• Notebook follows style guide https://docs.pymc.io/en/latest/contributing/jupyter_style.html
• PR description contains a link to the relevant issue:
  • a tracker one for existing notebooks (tracker issues have the "tracker id" label)
  • or a proposal one for new notebooks
• Check the notebook is not excluded from any pre-commit check: https://github.com/pymc-devs/pymc-examples/blob/main/.pre-commit-config.yaml

Helpful links

• https://github.com/pymc-devs/pymc-examples/blob/main/CONTRIBUTING.md

---

📚 Documentation preview 📚: https://pymc-examples--803.org.readthedocs.build/en/803/

[review-notebook-app]

Check out this pull request on 

See visual diffs & provide feedback on Jupyter Notebooks.

---

Powered by ReviewNB

[AlexAndorra]

Thanks @Armatron44 ! I'll review ASAP

[AlexAndorra]

This is great @Armatron44 , thanks a lot! I left a few comments in ReviewNB, and as an overall ask: can we make this into an admonition block (see the style guide?
With a title like "Click if you get this XX issue". This is a very niche and technical issue, and I'm afraid having it displayed by default in the notebook will break the flow, especially as it's a beginner NB. Does this make sense to you?

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

AlexAndorra commented on 2025-08-15T20:57:33Z
----------------------------------------------------------------

Line #1.    m52_L = m52_c * 50  # c * s

Maybe just comment quickly on why s = 50

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

AlexAndorra commented on 2025-08-15T20:57:34Z
----------------------------------------------------------------

Line #14.    # check non have underflowed to zero.

Typo: non --> none

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

AlexAndorra commented on 2025-08-15T20:57:34Z
----------------------------------------------------------------

Line #18.    )  # this will not pass assertion.

Maybe add an assertion error message? So that it displays better when failing

[review-notebook-app]

View / edit / reply to this conversation on ReviewNB

AlexAndorra commented on 2025-08-15T20:57:35Z
----------------------------------------------------------------

Typo: "as you need a m large to cover small lengthscales" --> "as you need an m large enough to cover small lengthscales"

[Armatron44]

Thanks @AlexAndorra for the comments and suggestions. I agree it hinders the flow of an introductory notebook so will try the admonition block as suggested. I've not much time this week so may have to leave this until next week to address.

[Armatron44]

I've now put the discussion into a dropdown.

[AlexAndorra]

Looks great now @Armatron44 , thanks for sticking with it!