Fix the doc error: module 'scipy.misc' has no attribute 'face'

[zhenying-liu]

The error we have is due to recent changes in the SciPy library, upgrading from 1.15.0 to 1.17.0. The scipy.misc.face() function has been deprecated and removed from the scipy.misc module. To resolve this issue, we use the updated method for accessing the face image dataset. And add the dependency of pooch for scipy.datasets module.

[dfm]

Thanks! Can you add more details about why we need the added pinned dependency?

[dfm]

Is this pin really needed?

[zhenying-liu]

I tried below locally which requires pooch, but it might not the case for the CI. I removed this requirement in the latest commit.

from scipy import datasets
face = datasets.face(gray=True).astype('float64')

[zhenying-liu]

docs/readthedocs.org:jax failed with the below error message:
Missing optional dependency 'pooch' required for scipy.datasets module. Please use pip or conda to install 'pooch'.
So I need to add it back.

[dfm]

Thanks! Yeah it looks like we do need to add this requirement here as you originally did, but maybe just pooch rather than pinning to that specific old version? If we really do need such an old version, can you add a comment with justification? Thanks!!

[zhenying-liu]

You are right. We don't need a specific version for pooch. Fixed.

[dfm]

Thank you! This looks good to me. Can you squash these commits into one and rebase onto the main branch? Then I'll merge. Thanks again!