[Numpy-discussion] Which NumPy/Numpy/numpy spelling?
Hi all,
What is the official spelling of NumPy/Numpy/numpy?
The documentation is not consistent and it mixes both NumPy and Numpy. For
example, the reference manual uses both spellings in the introduction paragraph
(http://docs.scipy.org/doc/numpy/reference/):
"This reference manual details functions, modules, and objects included in
Numpy, describing what they are and what they do. For learning how to use
NumPy, see also NumPy User Guide."
However, in all docs taken together "NumPy" is most frequently used (74%):
% find . -name "*.rst" -exec grep Numpy -ow {} \; | wc -l
161
% find . -name "*.rst" -exec grep NumPy -ow {} \; | wc -l
471
I also reported it as an issue: https://github.com/numpy/numpy/issues/7986
Yours,
Bartosz
___
NumPy-Discussion mailing list
NumPy-Discussion@scipy.org
https://mail.scipy.org/mailman/listinfo/numpy-discussion
Re: [Numpy-discussion] Which NumPy/Numpy/numpy spelling?
On 08/29/2016 07:43 AM, m...@telenczuk.pl wrote: What is the official spelling of NumPy/Numpy/numpy? IMHO it should be written numpy, because ... >>> import NumPy Traceback (most recent call last): File "", line 1, in ImportError: No module named NumPy >>> import Numpy Traceback (most recent call last): File "", line 1, in ImportError: No module named Numpy >>> import numpy >>> Phil ___ NumPy-Discussion mailing list NumPy-Discussion@scipy.org https://mail.scipy.org/mailman/listinfo/numpy-discussion
Re: [Numpy-discussion] Which NumPy/Numpy/numpy spelling?
Hi, I would not mind any choice as long as it's consistent. I agree that using all-lowercase spelling may avoid some common errors. However, PEP8 requires all module/package names to be lower case [1]. If we force the name of the library and the corresponding package to be the same, all Python libraries would be named in lowercase. This would not be the best choice for libraries, which have multi-component names (like NumPy = Numerical Python). Note also that both the Wikipedia page [2] and the official NumPy logo [3] use "NumPy" spelling. Some other popular [4] libraries use similar dichotomies: - Django - import django - Cython - import cython - PyYAML - import yaml - scikit-learn - import sklearn On the other hand all standard Python libraries are lower-case named. Cheers, Bartosz [1] https://www.python.org/dev/peps/pep-0008/#package-and-module-names [2] https://en.wikipedia.org/wiki/NumPy [3] http://www.numpy.org/_static/numpy_logo.png [4] http://pypi-ranking.info/alltime > On 08/29/2016 07:43 AM, m...@telenczuk.pl wrote: > > What is the official spelling of NumPy/Numpy/numpy? > > IMHO it should be written numpy, because ... > > >>> import NumPy > Traceback (most recent call last): >File "", line 1, in > ImportError: No module named NumPy > >>> import Numpy > Traceback (most recent call last): >File "", line 1, in > ImportError: No module named Numpy > >>> import numpy > >>> > > Phil > ___ > NumPy-Discussion mailing list > NumPy-Discussion@scipy.org > https://mail.scipy.org/mailman/listinfo/numpy-discussion ___ NumPy-Discussion mailing list NumPy-Discussion@scipy.org https://mail.scipy.org/mailman/listinfo/numpy-discussion
Re: [Numpy-discussion] Which NumPy/Numpy/numpy spelling?
https://mail.scipy.org/pipermail/scipy-user/2010-June/025756.html "NumPy and SciPy to refer to the projects. numpy and scipy to refer to the packages, specifically. When in doubt, use the former." I thought there was also another discussion about capital letters, but I don't find it. Josef On Mon, Aug 29, 2016 at 9:22 AM, Bartosz Telenczuk wrote: > Hi, > > I would not mind any choice as long as it's consistent. > > I agree that using all-lowercase spelling may avoid some common errors. > However, > PEP8 requires all module/package names to be lower case [1]. If we force the > name of the library and the corresponding package to be the same, all Python > libraries would be named in lowercase. This would not be the best choice for > libraries, which have multi-component names (like NumPy = Numerical Python). > > Note also that both the Wikipedia page [2] and the official NumPy logo [3] use > "NumPy" spelling. > > Some other popular [4] libraries use similar dichotomies: > > - Django - import django > - Cython - import cython > - PyYAML - import yaml > - scikit-learn - import sklearn > > On the other hand all standard Python libraries are lower-case named. > > Cheers, > > Bartosz > > [1] https://www.python.org/dev/peps/pep-0008/#package-and-module-names > [2] https://en.wikipedia.org/wiki/NumPy > [3] http://www.numpy.org/_static/numpy_logo.png > [4] http://pypi-ranking.info/alltime > >> On 08/29/2016 07:43 AM, m...@telenczuk.pl wrote: >> > What is the official spelling of NumPy/Numpy/numpy? >> >> IMHO it should be written numpy, because ... >> >> >>> import NumPy >> Traceback (most recent call last): >>File "", line 1, in >> ImportError: No module named NumPy >> >>> import Numpy >> Traceback (most recent call last): >>File "", line 1, in >> ImportError: No module named Numpy >> >>> import numpy >> >>> >> >> Phil >> ___ >> NumPy-Discussion mailing list >> NumPy-Discussion@scipy.org >> https://mail.scipy.org/mailman/listinfo/numpy-discussion > > > ___ > NumPy-Discussion mailing list > NumPy-Discussion@scipy.org > https://mail.scipy.org/mailman/listinfo/numpy-discussion ___ NumPy-Discussion mailing list NumPy-Discussion@scipy.org https://mail.scipy.org/mailman/listinfo/numpy-discussion
Re: [Numpy-discussion] Which NumPy/Numpy/numpy spelling?
There was similar discussion almost two years ago with respect to capitalization of matplotlib in prose. Most of the time, it was lower-case in our documentation, but then the question was if it should be upper-case at the beginning of the sentence... or should it always be upper-cased like a proper noun. I don't think a clear consensus was reached, but I ended up treating it as a proper noun in my book. I am also pretty sure I used "NumPy" in most places, even for "NumPy arrays", which still looks weird to me when I go back over my book. Ben Root On Mon, Aug 29, 2016 at 12:56 PM, wrote: > https://mail.scipy.org/pipermail/scipy-user/2010-June/025756.html > > "NumPy and SciPy to refer to the projects. numpy and scipy to refer to > the packages, specifically. When in doubt, use the former." > > I thought there was also another discussion about capital letters, but > I don't find it. > > Josef > > > On Mon, Aug 29, 2016 at 9:22 AM, Bartosz Telenczuk > wrote: > > Hi, > > > > I would not mind any choice as long as it's consistent. > > > > I agree that using all-lowercase spelling may avoid some common errors. > However, > > PEP8 requires all module/package names to be lower case [1]. If we > force the > > name of the library and the corresponding package to be the same, all > Python > > libraries would be named in lowercase. This would not be the best choice > for > > libraries, which have multi-component names (like NumPy = Numerical > Python). > > > > Note also that both the Wikipedia page [2] and the official NumPy logo > [3] use > > "NumPy" spelling. > > > > Some other popular [4] libraries use similar dichotomies: > > > > - Django - import django > > - Cython - import cython > > - PyYAML - import yaml > > - scikit-learn - import sklearn > > > > On the other hand all standard Python libraries are lower-case named. > > > > Cheers, > > > > Bartosz > > > > [1] https://www.python.org/dev/peps/pep-0008/#package-and-module-names > > [2] https://en.wikipedia.org/wiki/NumPy > > [3] http://www.numpy.org/_static/numpy_logo.png > > [4] http://pypi-ranking.info/alltime > > > >> On 08/29/2016 07:43 AM, m...@telenczuk.pl wrote: > >> > What is the official spelling of NumPy/Numpy/numpy? > >> > >> IMHO it should be written numpy, because ... > >> > >> >>> import NumPy > >> Traceback (most recent call last): > >>File "", line 1, in > >> ImportError: No module named NumPy > >> >>> import Numpy > >> Traceback (most recent call last): > >>File "", line 1, in > >> ImportError: No module named Numpy > >> >>> import numpy > >> >>> > >> > >> Phil > >> ___ > >> NumPy-Discussion mailing list > >> NumPy-Discussion@scipy.org > >> https://mail.scipy.org/mailman/listinfo/numpy-discussion > > > > > > ___ > > NumPy-Discussion mailing list > > NumPy-Discussion@scipy.org > > https://mail.scipy.org/mailman/listinfo/numpy-discussion > ___ > NumPy-Discussion mailing list > NumPy-Discussion@scipy.org > https://mail.scipy.org/mailman/listinfo/numpy-discussion > ___ NumPy-Discussion mailing list NumPy-Discussion@scipy.org https://mail.scipy.org/mailman/listinfo/numpy-discussion
