Skip to content
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

Caution about rolling ball performance #7424

Merged
merged 6 commits into from
May 25, 2024

Conversation

ctrueden
Copy link
Contributor

@ctrueden ctrueden commented May 17, 2024

Description

This patch adds detail to the skimage.restoration.rolling_ball docstring, cautioning about the algorithm performance and suggesting alternatives for when something faster is desired.

As discussed in #7423, the rolling ball algorithm complexity is such that larger radii and/or images with higher dimensionality can take quite some time to compute. Let's give the user some guidance about this so they can make informed decisions about how to proceed with their image processing.

Release note

For maintainers and optionally contributors, please refer to the instructions on how to document this PR for the release notes.

Add algorithmic complexity description + suggested alternatives to `skimage.restoration.rolling_ball` docstring.

And suggest alternatives for when something faster is desired.
@jni jni added the 📄 type: Documentation Updates, fixes and additions to documentation label May 20, 2024
Copy link
Member

@jni jni left a comment

Choose a reason for hiding this comment

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

Added suggestions to follow numpydoc referencing syntax, but otherwise LGTM! Thanks @ctrueden!

skimage/restoration/_rolling_ball.py Outdated Show resolved Hide resolved
skimage/restoration/_rolling_ball.py Outdated Show resolved Hide resolved
ctrueden and others added 3 commits May 20, 2024 14:04
Co-authored-by: Juan Nunez-Iglesias <jni@fastmail.com>
Co-authored-by: Juan Nunez-Iglesias <jni@fastmail.com>
Co-authored-by: Stefan van der Walt <sjvdwalt@gmail.com>
skimage/restoration/_rolling_ball.py Outdated Show resolved Hide resolved
skimage/restoration/_rolling_ball.py Outdated Show resolved Hide resolved
hmaarrfk and others added 2 commits May 25, 2024 08:39
Co-authored-by: Marianne Corvellec <marianne.corvellec@ens-lyon.org>
Co-authored-by: Marianne Corvellec <marianne.corvellec@ens-lyon.org>
@hmaarrfk
Copy link
Member

I'm worried about linting so I'm not pressing merge.

But lets try to not have this linger too long, there seems to be strong agreement that this should be merged!

I think we can all agree with small one character additions to aid with grammar!

Thank you @ctrueden

@ctrueden
Copy link
Contributor Author

Thanks all! Please let me know if there is anything else you would like done on my side to move this forward.

@hmaarrfk hmaarrfk merged commit 7a758cb into scikit-image:main May 25, 2024
22 checks passed
@stefanv stefanv added this to the 0.24 milestone May 25, 2024
@ctrueden ctrueden deleted the rolling-ball-docs branch June 4, 2024 17:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
📄 type: Documentation Updates, fixes and additions to documentation
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

5 participants