[SciPy-dev] ANN: NumPy/SciPy Documentation Marathon 2008

Johann Cohen-Tanugi cohen@slac.stanford....
Mon May 19 11:54:47 CDT 2008


yesterday when I started to modify the doctest I used import numpy. It 
is easy enough to change to import numpy as np, but please let's get 
that out of the way once and for all. I have no preference between the 2.
Johann

John Hunter wrote:
> On Sun, May 18, 2008 at 8:10 PM, Joe Harrington <jh@physics.ucf.edu> wrote:
>
>   
>> This is why we have asked people (in the doc instructions and example)
>> to assume "import numpy" for numpy docs, to assume that and "import
>> scipy" for scipy docs, and to make all other imports explicitly in the
>> examples (e.g., if you want to plot in an example).
>>     
>
> in the numpy sprint at Berkeley the numpy devs including Travis,
> Robert, Jarrod and others voted to recommend 'import numpy as np'.
> Perhaps we can go with that and avoid further debate.  The vote was
> for:
>
> import numpy as np
> import scipy as sp
> import matplotlib.pyplot as plt
>
> JDH
>
> >From the sprint chat:
>
>
> In the chat room: Fernando Perez (fdo.perez@gmail.com),
> chris.d.burns@gmail.com, Robert Kern (robert.kern@gmail.com), Jarrod
> Millman (millman.ucb@gmail.com), teoliphant@gmail.com
>
> 2:43 PM Fernando: You've been invited to this chat room!
>   john?
>  me: hey
>  Fernando: quick, I know you're busy...
>   import numpy as np
> import scipy as sp
> import matplotlib as mpl
> 2:44 PM me: no problem what's up?
>  Fernando: these as conventions for shorhands?
>   the mpl one I don't like... awkawrd to touch type...
>   OK with the first two?
>  me: well, you probably mean pyplot, not maptlotlib, since that is
> where the pylab plotting functionality lives
>   import pyplot as plt?
> 2:45 PM the first two look good to me -- I much prefer the lower case
> over import numpy as N and single letter lower case is too brittle
> 2:46 PM Fernando: rkern says pyl...
>   travis says lab
> 2:47 PM travis also votes for plt...
>  me: I like plt reasonably well -- I'd also like to do apylab next
> generation along the lines of what we talked about before
>   import pyplot as plot
>   import numpy as np
>   import scipy as sp
>   import numpy.fft as fft
> 2:48 PM import scipy.optimize as opt
>   etc....
>  Fernando: OK, the show of hands here also goes for plt.
>   Let's just run with it, you OK?
>  me: yep
>  Fernando: so it is: np, sp, plt. Hammer goes down.
> 2:49 PM We may ping you again for quickies like this if you approve.
> I'll make sure not to disturb you too much, but it helps to make
> decisions and move along. Thanks!
>  me: sounds good -- good luck!
> _______________________________________________
> Scipy-dev mailing list
> Scipy-dev@scipy.org
> http://projects.scipy.org/mailman/listinfo/scipy-dev
>   


More information about the Scipy-dev mailing list