lmcinnes/umap

Document reproducibility guarantees

Open

#298 ouverte le 25 sept. 2019

Voir sur GitHub
 (16 commentaires) (0 réactions) (0 assignés)Python (751 forks)batch import
0.4documentationgood first issue

Métriques du dépôt

Stars
 (6 478 stars)
Métriques de merge PR
 (Merge moyen 12h 3m) (15 PRs mergées en 30 j)

Description

Following up on the discussion here, it would be good to document how to get reproducible results with UMAP.

I think we should consider changing random_state in the UMAP constructor to a seed (e.g. 42, like the new transform_seed default) so that UMAP is reproducible by default.

We should document that users can set random_state to None to get faster results at the expense of reproducibility. In this mode there is no seed that would produce the same output due to the multithreading. (This was introduced in #294.)

Guide contributeur

Direction de recherche
Examinez la discussion liée dans le problème pour comprendre le contexte. Ensuite, lisez la documentation actuelle d'UMAP et le code source relatifs à random state et à la reproductibilité. Proposez des modifications pour documenter comment obtenir des résultats reproductibles et envisagez de mettre à jour la valeur par défaut de random state vers une graine. Si nécessaire, ouvrez une PR pour la documentation et d'éventuelles modifications de code.
Stack technique
python
Domaine
data
Type d'issue
Documentation
DifficultéDifficulté estimée pour un nouveau contributeur, de 1 pour un très petit changement à 5 pour un travail expert.
2
Temps estiméFourchette de temps approximative pour investiguer, implémenter, tester et préparer une pull request.
1-3 heures
Statut d'activitéDisponibilité apparente de l'issue : fraîche, active, ancienne, bloquée ou en attente d'un mainteneur.
Active
ClartéClarté avec laquelle l'issue explique le changement attendu, les critères d'acceptation et la prochaine étape.
Claire
Prérequis
Python
Accessibilité débutantScore de 1 à 100 estimant l'accessibilité de cette issue pour un premier contributeur.
75