Skip to content

DOC ensure SpectralClustering passes numpydoc validation and improve references #20987

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 6 commits into from
Sep 23, 2021

Conversation

lobpcg
Copy link
Contributor

@lobpcg lobpcg commented Sep 8, 2021

This PR implements the following changes:

  • make sure that SpectralClustering follows numpydoc convention
  • add a reference for the LOBPCG solver
  • add hyperlinks for each reference
  • cross-reference in the appropriate parameter and description

Documentation update:

Remove the irrelevant reference, already used in the discretize function:
    - Multiclass spectral clustering, 2003
      Stella X. Yu, Jianbo Shi

Add two new references, proposing ARPACK, LOBPCG/AMG algorithms actually coded here:
    - Modern Preconditioned Eigensolvers for Spectral Image Segmentation
      and Graph Bisection, 2003
      Andrew Knyazev
      https://bit.ly/3tmTR4k

    - Multiscale Spectral Graph Partitioning and Image Segmentation, 2006
      Andrew Knyazev
      https://bit.ly/3toJU6i
@lobpcg lobpcg changed the title Update _spectral.py [MRG] Update _spectral.py references in doc Sep 8, 2021
Copy link
Member

@glemaitre glemaitre left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Similar changes should be done at the level of the class SpectralClustering.

made changes proposed by the reviewer
minor error fixed
lint errors fix
@lobpcg
Copy link
Contributor Author

lobpcg commented Sep 22, 2021

@glemaitre I have made your requested changes. Could you please have another look?

@glemaitre glemaitre self-requested a review September 23, 2021 13:47
@glemaitre glemaitre changed the title [MRG] Update _spectral.py references in doc DOC ensure SpectralClustering passes numpydoc validation and improve references Sep 23, 2021
@glemaitre glemaitre removed their request for review September 23, 2021 14:18
@glemaitre
Copy link
Member

I made a push to create hyperlinks to the PDF and add references in the docstring parameters entry. Since I was modifying, I checked that the docstring was passing numpydoc validation.

Now, looks good. I will check the rendering after that the CI documentation will be completed.

@glemaitre glemaitre merged commit 2eabb45 into scikit-learn:main Sep 23, 2021
@glemaitre
Copy link
Member

Thanks @lobpcg Rendering looks good. Merging.

@lobpcg lobpcg deleted the patch-1 branch September 24, 2021 16:51
@lobpcg
Copy link
Contributor Author

lobpcg commented Sep 24, 2021

Thanks @glemaitre

@glemaitre glemaitre mentioned this pull request Oct 23, 2021
10 tasks
glemaitre added a commit to glemaitre/scikit-learn that referenced this pull request Oct 23, 2021
…references (scikit-learn#20987)

Co-authored-by: Guillaume Lemaitre <g.lemaitre58@gmail.com>
glemaitre added a commit that referenced this pull request Oct 25, 2021
…references (#20987)

Co-authored-by: Guillaume Lemaitre <g.lemaitre58@gmail.com>
samronsin pushed a commit to samronsin/scikit-learn that referenced this pull request Nov 30, 2021
…references (scikit-learn#20987)

Co-authored-by: Guillaume Lemaitre <g.lemaitre58@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants