Skip to content

Updating UMAP random_state doc#7590

Merged
rapids-bot[bot] merged 3 commits intorapidsai:mainfrom
viclafargue:umap-random-state-doc-update
Dec 17, 2025
Merged

Updating UMAP random_state doc#7590
rapids-bot[bot] merged 3 commits intorapidsai:mainfrom
viclafargue:umap-random-state-doc-update

Conversation

@viclafargue
Copy link
Copy Markdown
Contributor

@viclafargue viclafargue commented Dec 10, 2025


For fully reproducible results, ``build_algo`` must also be set to
``'brute_force_knn'``, as NN Descent produces non-deterministic KNN
graphs. Alternatively, a pre-computed KNN graph can be provided via
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

build_algo="auto" (the default) will use 'brute_force_knn' if a random_state is provided; there's no need to explicitly set it to 'brute_force_knn'.

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

You're right, but there's still a strong incentive for users to choose NN-Descent because it is much faster. That is why we should probably re-word the documentation to clearly state that opting for NN-Descent will break reproducibility.

@viclafargue viclafargue requested a review from jcrist December 17, 2025 10:52
@viclafargue viclafargue added improvement Improvement / enhancement to an existing function non-breaking Non-breaking change labels Dec 17, 2025
@jcrist
Copy link
Copy Markdown
Member

jcrist commented Dec 17, 2025

/merge

@rapids-bot rapids-bot bot merged commit 322bfd1 into rapidsai:main Dec 17, 2025
103 checks passed
mani-builds pushed a commit to mani-builds/cuml that referenced this pull request Jan 11, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Cython / Python Cython or Python issue improvement Improvement / enhancement to an existing function non-breaking Non-breaking change

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants