˽Xc@`sdZddlmZmZmZddlZddlmZmZm Z m Z m Z m Z ddddd gZ d d Zd d dd dZdZdZedZdS(sW Functions which are common and require SciPy Base and Level 1 SciPy (special, linalg) i(tdivisiontprint_functiontabsolute_importN(tarangetnewaxisthstacktproducttarrayt fromstringtcentral_diff_weightst derivativetlenatascenttfaceicC`s||dkrtdn|ddkr>tdnddlm}|d?}t| |d}|ddtf}|d }x-td|D]}t|||g}qWttd|dd d|j||}|S( s Return weights for an Np-point central derivative. Assumes equally-spaced function points. If weights are in the vector w, then derivative is w[0] * f(x-ho*dx) + ... + w[-1] * f(x+h0*dx) Parameters ---------- Np : int Number of points for the central derivative. ndiv : int, optional Number of divisions. Default is 1. Notes ----- Can be inaccurate for large number of points. is;Number of points must be at least the derivative order + 1.iis!The number of points must be odd.(tlinalgg?Ngtaxis( t ValueErrortscipyRRRtrangeRRtinv(tNptndivRthotxtXtktw((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyR s  0g?ic C`sv||dkrtdn|ddkr>tdn|dkr |dkrrtdddgd}q |d krtdd dd dgd }q |d krtdddddddgd}q |dkrtdddddddddg d}q t|d}n|dkr|dkrPtdddg}q |d kr~tdddddgd }q |d krtdddd dddgd!}q |dkrtdd"d#d$d%d$d#d"dg d&}q t|d}nt||}d'}|d?}x;t|D]-} ||| ||| |||7}q*W|t|f|d(dS()s6 Find the n-th derivative of a function at a point. Given a function, use a central difference formula with spacing `dx` to compute the `n`-th derivative at `x0`. Parameters ---------- func : function Input function. x0 : float The point at which `n`-th derivative is found. dx : float, optional Spacing. n : int, optional Order of the derivative. Default is 1. args : tuple, optional Arguments order : int, optional Number of points to use, must be odd. Notes ----- Decreasing the step size too small can result in round-off error. Examples -------- >>> from scipy.misc import derivative >>> def f(x): ... return x**3 + x**2 >>> derivative(f, 1.0, dx=1e-6) 4.9999999999217337 ism'order' (the number of points used to compute the derivative), must be at least the derivative order 'n' + 1.iisJ'order' (the number of points used to compute the derivative) must be odd.iig@iiig(@ii ii-igN@iii`iiXi ig@@giiiiigf@iiiig@gR(RRR RR( tfunctx0tdxtntargstordertweightstvalRR((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyR 2s<#   " ( .   " ( . +cC`stddS(s Function that previously returned an example image .. note:: Removed in 0.17 Parameters ---------- None Returns ------- None Raises ------ RuntimeError This functionality has been removed due to licensing reasons. Notes ----- The image previously returned by this function has an incompatible license and has been removed from SciPy. Please use `face` or `ascent` instead. See Also -------- face, ascent sLlena() is no longer included in SciPy, please use ascent() or face() insteadN(t RuntimeError(((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyR {scC`sjddl}ddl}|jj|jjtd}t|d}t|j|}WdQX|S(sw Get an 8-bit grayscale bit-depth, 512 x 512 derived image for easy use in demos The image is derived from accent-to-the-top.jpg at http://www.public-domain-image.com/people-public-domain-images-pictures/ Parameters ---------- None Returns ------- ascent : ndarray convenient image to use for testing and demonstration Examples -------- >>> import scipy.misc >>> ascent = scipy.misc.ascent() >>> ascent.shape (512, 512) >>> ascent.max() 255 >>> import matplotlib.pyplot as plt >>> plt.gray() >>> plt.imshow(ascent) >>> plt.show() iNs ascent.dattrb( tpickletostpathtjointdirnamet__file__topenRtload(R%R&tfnametfR ((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyR s   !cC`sddl}ddl}t|jj|jjtdd}|j}WdQX|j|}t |dd}d|_ |t krd |dddddfd |ddddd fd |dddddfj d}n|S(sw Get a 1024 x 768, color image of a raccoon face. raccoon-procyon-lotor.jpg at http://www.public-domain-image.com Parameters ---------- gray : bool, optional If True return 8-bit grey-scale image, otherwise return a color image Returns ------- face : ndarray image of a racoon face Examples -------- >>> import scipy.misc >>> face = scipy.misc.face() >>> face.shape (768, 1024, 3) >>> face.max() 255 >>> face.dtype dtype('uint8') >>> import matplotlib.pyplot as plt >>> plt.gray() >>> plt.imshow(face) >>> plt.show() iNsface.datR$tdtypetuint8iiigzG?gQ?igQ?i(iii( tbz2R&R+R'R(R)R*treadt decompressRtshapetTruetastype(tgrayR1R&R.trawdatatdataR ((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyR s!  -  q((t__doc__t __future__RRRtnumpytnpRRRRRRt__all__R R R R tFalseR (((s0/tmp/pip-build-7oUkmx/scipy/scipy/misc/common.pyts . $I '