[scikit-learn] Small suggestion for documentation

2018-08-07 Thread Fellype via scikit-learn
Dear maintainers,I've just known scikit-learn and found it very useful. 
Congratulations for this library.
I found some confuse terms to describe r2_score parameters in documentation 
[1]. For me, the meanings of y_true and y_pred are not clear. From [1]:- 
y_true: ... Ground truth (correct) target values- y_pred: ... Estimated target 
values
Since the R^2 value is usually used to compare the behavior of experimental 
data (observed) with a theoretical model or standard data (expected), I guess 
that it would be better to change the description of y_true and y_pred to 
something like:- y_true: ... Observed (or measured) target values- y_pred: ... 
Expected (or theoretical) target values
 I also think that the same should be done in documentation of other 
scikit-learn functions that use the y_true and y_pred terms with the same 
meaning.

Thanks for your attention and best wishes.
Fellype

[1] 
http://scikit-learn.org/stable/modules/generated/sklearn.metrics.r2_score.html___
scikit-learn mailing list
[email protected]
https://mail.python.org/mailman/listinfo/scikit-learn


Re: [scikit-learn] Small suggestion for documentation

2018-08-07 Thread Fellype via scikit-learn
Hi Gaël,

  > Em terça-feira, 7 de agosto de 2018 15:24:00 BRT, Gael Varoquaux 
 escreveu:  > 
 >
 > I think that the vocabulary mismatch comes from the fact that you are 
 > looking at these terms thinking about in sample statistics, while they are 
 > used here in the context of prediction. I think that in the context of 
 > prediction, these are the right terms. 

Actually, I was looking at the terms in the context of curve fitting, which is 
based in statistics, of course...
Fellype

  ___
scikit-learn mailing list
[email protected]
https://mail.python.org/mailman/listinfo/scikit-learn