Clarify Lasso[Selector] demos · Issue #19221 · matplotlib/matplotlib · GitHub
Skip to content

Clarify Lasso[Selector] demos #19221

Description

@ianhi

Problem

It is not easy to figure out the differences between the Lasso Demo and the Lasso Selector Demo. 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

Activity

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions