-
-
Notifications
You must be signed in to change notification settings - Fork 7.9k
DOC: Clarify the relationship between plot
and scatter
#7083
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
Comments
I can do a PR for this, thought I am very much convinced this will not fixed the issue. |
it goes deeper than matplotlib. The forums for matlab has similar arguments On Mon, Sep 12, 2016 at 1:02 PM, Nelle Varoquaux [email protected]
|
The problem isn't IMO in the arguments. I am totally fine with the functions having different arguments (well, no I am not, but you have to choose your battles…). The problem is that we are telling users to use plot instead of scatter in cases where anyone in their right mind would use the scatter function because of the name: the users are trying to do a scatter plot, so why not use the scatter function? I understand the challenges in fixing the design problem in the scatter function, but we've been trying to teach to users to use plot instead of scatter when colors and size are identical for now 4 years, and it clearly hasn't worked. We can try teaching users better by improving the documentation, but I don't believe users will read the documentation : I sure never read the documentation, unless I have no clue of what I am doing or the program is not behaving the way I expect it to. It would actually be interesting to select a number of advanced users from the scientific python community, and ask them to do a scatter plot with identical with a large number of points to see whether these advanced users know to use plot instead of scatter. |
The Notes section of the
scatter
docstring should point out that the simplest scatter plots can be made more efficiently withplot
. There are probably also examples and other places in the docs where this could be illustrated or mentioned.This came up in the discussion of #7072.
The text was updated successfully, but these errors were encountered: