matplotlib / matplotlib/matplotlib

Clarify Lasso[Selector] demos

Abierto
#19,221 10 comentarios 0 reacciones 0 asignados Ver en GitHub

Nadie ha tomado este issue todavía.

Documentation topic: widgets/UI
Lenguaje dominante
Python
Estrellas
23.2k
Forks
8.5k
Merge medio
1 d 6 h
PR fusionados (30 d)
66

Descripción

### Problem
It is not easy to figure out the differences between the [Lasso Demo](https://matplotlib.org/devdocs/gallery/event_handling/lasso_demo.html#sphx-glr-gallery-event-handling-lasso-demo-py) and the [Lasso Selector Demo](https://matplotlib.org/devdocs/gallery/widgets/lasso_selector_demo_sgskip.html#sphx-glr-gallery-widgets-lasso-selector-demo-sgskip-py). There is some redundancy between them

The Lasso Demo explanation contains this off putting sentence:

> This is currently a proof-of-concept implementation (though it is usable as is). There will be some refinement of the API.

Furthermore, despite both `Lasso` and `LassoSelector` being in `widgets.py` the `Lasso Demo` is under the Event Handling sections of the gallery - which I find confusing.

https://matplotlib.org/3.3.2/gallery/widgets/lasso_selector_demo_sgskip.html and It not eas

### Suggested Improvements

1. Move `Lasso Demo` under the widgets examples
2. remove the sentence about proof of concept implementation from Lasso Demo.
3. Add a recommendation (and link to demo) to use `LassoSelector` for selecting points to the explanatory paragraph in `Lasso Demo`
- Both examples should probably cross reference eachother actually
4. Create an example showcasing the difference between `Lasso` and `LassoSelector` (After a cursory read I don't see why I wouldn't always prefer the latter)

**Matplotlib version**
* Matplotlib documentation version: devdocs/3.3.3

Guía de contribución

Abrir la guía de contribución

Primeros pasos

  1. Lee el issue completo y luego la guía de contribución del proyecto.
  2. Comenta en el issue que vas a ocuparte — evita que dos personas hagan lo mismo.
  3. Haz un fork del repositorio y trabaja en una rama.
  4. Abre un pull request que haga referencia al número del issue.

Línea de trabajo

Lea los ejemplos enlazados de la galería para Lasso y LassoSelector, junto con widgets.py, para comparar su propósito y ubicación. Mueva la demostración de Lasso bajo widgets, elimine la redacción obsoleta de prueba de concepto y añada referencias cruzadas o un ejemplo comparativo que explique cuándo usar cada uno. Confirme que ambas demostraciones se compilan y se renderizan correctamente en la galería de documentación.

Escrito por el modelo de indexación a partir del texto del issue.

Evaluación

Stack tecnológico
python
Área
documentation
Tipo de issue
Documentación
Dificultad
3/5
Tiempo estimado
1-2 días
Estado de actividad
Tranquilo
Claridad
Bastante claro
Aptitud para principiantes
52/100

Recibe los nuevos issues en tu correo

Un resumen breve de issues de GitHub para principiantes.