\ci dZddlZddlZddlZddlmZmZmZddl m Z m Z m Z m Z mZmZmZddlmZdZdZd(d Zd Zd Zd(d Zedd ddddddddddZefdZdZdZGddZGddZdZGddZ dZ!e!dze!dzd d!Z"d"Z#efd#Z$edd dddddddddd$d%Z%edd ddddddddddd& d'Z&dS))a Replicate FITPACK's logic for constructing smoothing spline functions and curves. Currently provides analogs of splrep and splprep python routines, i.e. curfit.f and parcur.f routines (the drivers are fpcurf.f and fppara.f, respectively) The Fortran sources are from https://github.com/scipy/scipy/blob/maintenance/1.11.x/scipy/interpolate/fitpack/ .. [1] P. Dierckx, "Algorithms for smoothing data with periodic and parametric splines, Computer Graphics and Image Processing", 20 (1982) 171-184. :doi:`10.1016/0146-664X(82)90043-0`. .. [2] P. Dierckx, "Curve and surface fitting with splines", Monographs on Numerical Analysis, Oxford University Press, 1993. .. [3] P. Dierckx, "An algorithm for smoothing, differentiation and integration of experimental data using spline functions", Journal of Computational and Applied Mathematics, vol. I, no 3, p. 165 (1975). https://doi.org/10.1016/0771-050X(75)90034-0 N)array_namespace concat_1dxp_capabilities) _not_a_knotmake_interp_splineBSplinefpcheck _lsq_solve_qr$_lsq_solve_qr_for_root_rati_periodic_periodic_knots)_dierckxgMbP?Fct||||||\}}}}}tj|rt t d||fS)Nperiodicr)r npisnansum ValueError_iermesg) xytkwr_fp residualss p/var/www/html/mdtn/previsions/meteo_cartes/venv/lib/python3.11/site-packages/scipy/interpolate/_fitpack_repro.py_get_residualsr!-s_+1aAq8LLLAq!R x   &!%%% b=c:|dS|dvrtd||S)N not-a-knot)r$rzKOnly 'not-a-knot' and 'periodic' boundary conditions are recognised, found )r)bc_types r _validate_bc_typer&>sC|000,"),,-- - Nr"ctj||||}tj||}tj|d||||df}|S)arAdd a new knot. (Approximately) replicate FITPACK's logic: 1. split the `x` array into knot intervals, ``t(j+k) <= x(i) <= t(j+k+1)`` 2. find the interval with the maximum sum of residuals 3. insert a new knot into the middle of that interval. NB: a new knot is in fact an `x` value at the middle of the interval. So *the knots are a subset of `x`*. This routine is an analog of https://github.com/scipy/scipy/blob/v1.11.4/scipy/interpolate/fitpack/fpcurf.f#L190-L215 (cf _split function) and https://github.com/scipy/scipy/blob/v1.11.4/scipy/interpolate/fitpack/fpknot.f N)rfpknotr searchsortedr_)rrrrnew_knotidx_tt_news r add_knotr.JsR"q!Q 22H OAx ( (E E!FUF)Xqy0 1E Lr"c <tj|t}tj|t}|jjs|}|jjs|}|tj|t}ntj|t}|jjs|}|jdkrtd|jd|dk rtd| dkrtd|jdks |jd krtd |jd t|}|r'|jd krtd |jd |d n2|jdkrtd |jd|d |dddf}|j d|j dkr td|j d|j d |j d|j dkr td|j d|j d |jdks(|dd|ddk rtdtj|}|dkrtd||t|}|t!|}|r2tj|d|ddstd|||||||fS)zACommon input validations for generate_knots and make_splrep. dtypeNr w.ndim = z not implemented yet.rzWeights must be non-negativezAll weights are zero.z y.ndim = z not supported (must be 1 or 2.)z% != 2 not supported with parametric =.z% != 1 not supported with parametric =z"Weights is incompatible: w.shape =z != z Data is incompatible: x.shape = z and y.shape = z(Expect `x` to be an ordered 1D sequence.z"`s` must be non-negative. Got s = gV瞯<)atolzPFirst and last points does not match which is required for `bc_type='periodic'`.)rasarrayfloatflags c_contiguouscopy ones_likendimranyrboolshapeoperatorindexminmaxallclose) rrrrsxbxe parametricrs r _validate_inputsrJbs. 1E"""A 1E"""A 7  FFHH 7  FFHHy L% ( ( ( Jq & & &w# A 6Q;;@@@@AA A E;;== =;<< < 5577a<<455 5 v{{afqjjGAFGGGHHHj!!J 6Q;;SSSJSSSTT T  6Q;;SSSJSSSTT T aaagJwqzQWQZNQWNNAGNNNOOOwqzQWQZP!'PP17PPPQQQv{{quq"v~**,,{CDDDqA1uu@!@@AAA z VV z VV6 AaD!B%e<<<6566 6 aAq"b  r"T)cpu_onlyjax_jitallow_dask_compute)rrGrHrrFnestr%c #Kt|||} t|}|dk} |dkrU||td| r|dkrt||} nt ||} | | VdSt |||||||tj|dk|  \}}}}}}}t||||||||| |  Ed{VdS) a Generate knot vectors until the Least SQuares (LSQ) criterion is satified. Parameters ---------- x, y : array_like The data points defining the curve ``y = f(x)``. w : array_like, optional Weights. xb : float, optional The boundary of the approximation interval. If None (default), is set to ``x[0]``. xe : float, optional The boundary of the approximation interval. If None (default), is set to ``x[-1]``. k : int, optional The spline degree. Default is cubic, ``k = 3``. s : float, optional The smoothing factor. Default is ``s = 0``. nest : int, optional Stop when at least this many knots are placed. ends are equivalent. bc_type : str, optional Boundary conditions. Default is `"not-a-knot"`. The following boundary conditions are recognized: * ``"not-a-knot"`` (default): The first and second segments are the same polynomial. This is equivalent to having ``bc_type=None``. * ``"periodic"``: The values and the first ``k-1`` derivatives at the ends are equivalent. Yields ------ t : ndarray Knot vectors with an increasing number of knots. The generator is finite: it stops when the smoothing critetion is satisfied, or when then number of knots exceeds the maximum value: the user-provided `nest` or `x.size + k + 1` --- which is the knot vector for the interpolating spline. Examples -------- Generate some noisy data and fit a sequence of LSQ splines: >>> import numpy as np >>> import matplotlib.pyplot as plt >>> from scipy.interpolate import make_lsq_spline, generate_knots >>> rng = np.random.default_rng(12345) >>> x = np.linspace(-3, 3, 50) >>> y = np.exp(-x**2) + 0.1 * rng.standard_normal(size=50) >>> knots = list(generate_knots(x, y, s=1e-10)) >>> for t in knots[::3]: ... spl = make_lsq_spline(x, y, t) ... xs = xs = np.linspace(-3, 3, 201) ... plt.plot(xs, spl(xs), '-', label=f'n = {len(t)}', lw=3, alpha=0.7) >>> plt.plot(x, y, 'o', label='data') >>> plt.plot(xs, np.exp(-xs**2), '--') >>> plt.legend() Note that increasing the number of knots make the result follow the data more and more closely. Also note that a step of the generator may add multiple knots: >>> [len(t) for t in knots] [8, 9, 10, 12, 16, 24, 40, 48, 52, 54] Notes ----- The routine generates successive knots vectors of increasing length, starting from ``2*(k+1)`` to ``len(x) + k + 1``, trying to make knots more dense in the regions where the deviation of the LSQ spline from data is large. When the maximum number of knots, ``len(x) + k + 1`` is reached (this happens when ``s`` is small and ``nest`` is large), the generator stops, and the last output is the knots for the interpolation with the not-a-knot boundary condition. Knots are located at data sites, unless ``k`` is even and the number of knots is ``len(x) + k + 1``. In that case, the last output of the generator has internal knots at Greville sites, ``(x[1:] + x[:-1]) / 2``. .. versionadded:: 1.15.0 rrNzs == 0 is interpolation onlyrr3rIrxp) rr&rr rr7rJrr=_generate_knots_impl) rrrrGrHrrFrOr%rSrrs r generate_knotsrUs r Aq ! !B((G*$HAvv  q};<< <  "A1%%AAAq!!Ajjmm, 1aAr2"'!**/Aq!Q2r $Aq!RQ4bQQQQQQQQQQQQr"c # K|tz} |j} |<|rt| d|zzd|zdz}nEt| |zdzd|zdz}n(|d|dzzkrtd|dd|dzzd|sd|dzz} | |zdz} nd|dzz} | d|zz} ||z }|rt j| t }td|dzD]0}|d||z |zz ||<|| dz ||zz|||zdz<1t|||||| \}}||z | ks| | kr|VdSnd }d }|s-t j |g|dzz|g|dzzzt }n:t jd|zdzt }|| dzdzdz ||dz<d}|j d}t| D]}|rg|j d}|||<||||z dz <td|dzD]6}|||z |z dz |z |||z <|||z|z|||z |zdz <7| |V|}t|||||| \}}||z }t|| ks|dkrdS|| krd}nJ||z }|| krt||z|z n|dz}t|dzt||dzd}t|D]}t||||}|j d}|| kr>|st||}nt!||}| |VdS||kr| |VdS||dz krt|||||| \}}dS) Nr3rNr`nest` too small: nest = < 2*(k+1) = r4r0rr)rr)TOLsizerDrrzerosr8ranger!r7r@absintrCr.rr )rrrrGrHrrFrOrrSaccmnminnmaxperrirrfpoldnplusniterjrfpmsdeltanpl1s r rTrTs c'C A |  +q1Q3w!a((DDq1uqy!A#'**DD !QU)  R$RR1Q3RRRSS S !a%y1uqy!a%y1Q3w r'C HT ' ' 'q!a% . .AQ41q5C-'AaDQU8a#g-Aa!eaiLLq!Q1x@@@2 6C<<44<<GGG F(  JtQqSzRD!A#J.e < < < HQqS1WE * * *a!eaZ!^$!a%  Aa:R:R  2 AAaDAa!eaiL1a!e__ 2 2QUQY]+c1!a%#$QU8c>!a%!)a-  jjmm&q!QQ19;;; 2Av IIOO FF 99EEBJE05 3ut|e+,,,qDaT5!8Q!7!788Eu R RAAq),,A ADyy.#Aq))AA'1--Ajjmm###Dyyjjmm###519}}-aAqAQQQ 11 R6 Fr"ctd}t|dzD]"}||z|kr||||||zz z}#|S)Ng?r3)r])rrerjrresrFs r proddrpsM C 1Q3ZZ## q5A:: AaD1QqS6M "C Jr"c |jd}|||z dz ||z }|d|zz dz }tj|dz |dzft}t |dz D]S}||zdz}t |dzD]6}||z} || |zdz|| z t || ||z |||f<7T|||z |zz}tjdt |dz Dtj} ||z dz } || | fS)aDiscontinuity matrix: jumps of k-th derivatives of b-splines at internal knots. See Eqs. (9)-(10) of Ref. [1], or, equivalently, Eq. (3.43) of Ref. [2]. This routine assumes internal knots are all simple (have multiplicity =1). Parameters ---------- t : ndarray, 1D, shape(n,) Knots. k : int The spline degree Returns ------- disc : ndarray, shape(n-2*k-1, k+2) The jumps of the k-th derivatives of b-splines at internal knots, ``t[k+1], ...., t[n-k-1]``. offset : ndarray, shape(2-2*k-1,) Offsets nc : int Notes ----- The normalization here follows FITPACK: (https://github.com/scipy/scipy/blob/maintenance/1.11.x/scipy/interpolate/fitpack/fpdisc.f#L36) The k-th derivative jumps are multiplied by a factor:: (delta / nrint)**k / k! where ``delta`` is the length of the interval spanned by internal knots, and ``nrint`` is one less the number of internal knots (i.e., the number of subintervals between them). References ---------- .. [1] Paul Dierckx, Algorithms for smoothing data with periodic and parametric splines, Computer Graphics and Image Processing, vol. 20, p. 171 (1982). :doi:`10.1016/0146-664X(82)90043-0` .. [2] Tom Lyche and Knut Morken, Spline methods, http://www.uio.no/studier/emner/matnat/ifi/INF-MAT5340/v05/undervisningsmateriale/ rrr3r0cg|]}|Srs).0res r zdisc..s111Qq111r")r@remptyr8r]rparrayint64) rrrhrlnrintmatrjjrjiireoffsetncs r discrsI^  A a!eaiL1Q4 E !GaKE 8UQYA&e 4 4 4DEAIEE FQJA,, E EBRAa!eaiL1Q4/5Aq!3D3DDDRLL E UE\A DX11%a..111 B B BF QB  r"c(eZdZdZdddddZdZdS)Fa The r.h.s. of ``f(p) = s``. Given scalar `p`, we solve the system of equations in the LSQ sense: | A | @ | c | = | y | | B / p | | 0 | | 0 | where `A` is the matrix of b-splines and `b` is the discontinuity matrix (the jumps of the k-th derivatives of b-spline basis elements at knots). Since we do that repeatedly while minimizing over `p`, we QR-factorize `A` only once and update the QR factorization only of the `B` rows of the augmented matrix |A, B/p|. The system of equations is Eq. (15) Ref. [1]_, the strategy and implementation follows that of FITPACK, see specific links below. References ---------- [1] P. Dierckx, Algorithms for Smoothing Data with Periodic and Parametric Splines, COMPUTER GRAPHICS AND IMAGE PROCESSING vol. 20, pp 171-184 (1982.) https://doi.org/10.1016/0146-664X(82)90043-0 N)RYc||_||_||_||_|t j|t n|}|jdkrtd|jd||_ ||_ |jdkrtd|jdt||\} } } ||t|||||\}}} } } |j d|z dz } |dz}|j d|kr$td |j dd |dzd t j| j d|j dft }tj|d| |f|_t j| | j dz|jdzft }|d| ddf|d| d|f<||_tjt j| tj| f|_| |_| |_dS) Nr0rr2 != 1.r3&F: expected y.ndim == 2, got y.ndim = instead.rzInternal error: R.shape[1] =z != k+1 =r4)rrrrrr<r8r=rrrFrr r@r\r*YYAAarangerxr}r~b)selfrrrrrFrrrrb_offsetb_ncrr~nzzrs r __init__z F.__init__s,-IBL% ( ( ( (1 6Q;;111122 2 6Q;;QQVQQQRR R!AJJ8T 9)!Q1a88MAq!Q WQZ!^a  U 71:  J JJ!A#JJJKK K Hagaj!'!*-U ; ; ;%#2# "XrAGAJq1 ? ? ?"aaay3B38 eBIb9998CD r"c |j}|j}|j}|j|z ||dddf<|j}t j|||||t j|||j |j |j |j |j |\}}}t|j ||j } | |_||jz S)N)startrow)rr;r}r~rrr qr_reducefpbackrrrrrr splrF) rpABr}r~QYcrrrs r __call__z F.__call__Js W\\^^!!## WVaZ2336 W\\^^ 2vr2;;;;?2r4646464646SUVV1bdfa((DF{r"N__name__ __module__ __qualname____doc__rrrsr"r rrsP0/44/////br"rc.eZdZdZddddddddZdZdS) Fperiodica Fit a smooth periodic B-spline curve to given data points. This class fits a periodic B-spline curve S(t) of degree k through data points (x, y) with knots t. The spline is smooth and repeats itself at the start and end, meaning the function and its derivatives up to order k-1 are equal at the boundaries. We want to find spline coefficients c that minimize the difference between the spline and the data, while also keeping the spline smooth. This is done by solving: minimize || W^{1/2} (Y - B c) ||^2 + s * c^T @ R @ c subject to periodic constraints on c. where: - Y is the data values, - B is the matrix of B-spline basis functions at points x, - W is a weighting matrix for the data points, - s is the smoothing parameter (larger s means smoother curve), - R is a matrix that penalizes wiggliness of the spline, - c spline coefficients to be solved for - periodic constraints ensure the spline repeats smoothly. The solution is obtained by forming augmented matrices and performing a QR factorization that incorporates these constraints, following the approach in FITPACK's `fpperi.f`. Parameters: ----------- x : array_like, shape (n,) y : array_like, shape (n, m) t : array_like, shape (nt,) Knot vector for the spline k : int Degree of the spline. s : float Controls smoothness: bigger s means smoother curve, smaller s fits data closer. w : array_like, shape (n,), optional Weights for data points. Defaults to all ones. R, Y, A1, A2, Z : arrays, optional Precomputed matrices from least squares and QR factorization steps to speed up repeated fits with the same knots and data. Attributes: ----------- G1, G2 : arrays Augmented matrices combining the original QR factors and constraints related to the spline basis and data. G1 is roughly the "upper-triangular" part; G2 contains additional constraint information for periodicity. H1, H2 : arrays Matrices associated with the discontinuity jump constraints of the k-th derivative of B-splines at the knots. These encode the periodicity conditions and are scaled by the smoothing parameter. offset : array Offset indices used for efficient indexing during QR reduction. Methods: -------- __call__(p): Perform QR reduction of augmented matrices scaled by 1/p, solve for spline coefficients, and return residual difference fp - s. References: ----------- - FITPACK's fpperi.f and fpcurf.f Fortran routines for periodic spline fitting. N)rrA1A2ZcB||_||_||_||_|t j|t n|}|jdkrtd|jd||_ ||_ |jdkrtd|jdt||\} } }| | | ||t|||||\}} } } }}}}tj| | | t||\}}}}}||_||_||_||_| |_||_dS)Nr0rr2rr3rr)rrrrrr<r8r=rrrFrr rinit_augmented_matriceslenG1_G2_H1_H2_Z_offset_)rrrrrrFrrrrrrrrrrG1G2H1H2r}s r rzFperiodic.__init__sT -.IBL% ( ( ( (1 6Q;;111122 2 6Q;;QQVQQQRR R!AJJ8T Z2: Y19(L1aA(( $Ar2q!Q1"*!A"b!SQRVVUV!W!WBB r"c |j}|j}|j}|j}|j}d|z }||z}||z}t jt|j |j z dz |j df|j }|dt|j d|j zz dz ddf|dt|j d|j zz dz ddf<tj||||||jt|j |j tj||||j |j dz|jdd|jddddf|j |jdd \}} } t)|j ||j } | |_| |jz S)Nrr0r3r5)rr;rrrrrrvrrrr@r1rqr_reduce_augmented_matricesrfpbacprrrr rrF) rrrrrrrpinvrrrrs r rzFperiodic.__call__s X]]__ X]]__ X]]__ X]]__ GLLNNs $Y $Y Hc$&kkDF*Q. ;17 K K K,-.Is46{{QtvX/E/I.I111.L,M %3tv;;46 !A % %qqq () - BAt|S[[$& B B B ? A FDFQJss TVCRCF^ FDF3B3K!!1b dfa((DF{r"rrrsr"r rrbsZDDJ64DTT66666p(((((r"rc|||z z}|||z z}|||z z}|tjkr||z||zz |z S||z|z||z|zz||z|zz ||z||zz||zzz S)aThe root of r(p) = (u*p + v) / (p + w) given three points and values, (p1, f2), (p2, f2) and (p3, f3). The FITPACK analog adjusts the bounds, and we do not https://github.com/scipy/scipy/blob/maintenance/1.11.x/scipy/interpolate/fitpack/fprati.f NB: FITPACK uses p < 0 to encode p=infinity. We just use the infinity itself. Since the bracket is ``p1 <= p2 <= p3``, ``p3`` can be infinite (in fact, this is what the minimizer starts with, ``p3=inf``). )rinf) p1f1p2f2p3f3h1h2h3s r fpratir s rBwB rBwB rBwB RV||BB"$$ U2X2b 2b58 + ,22 20E FFr"ceZdZdZdS)Bunchc *|jjdi|dS)Nrs)__dict__update)rkwargss r rzBunch.__init__s# &&v&&&&&r"N)rrrrrsr"r rrs#'''''r"rzerror. a theoretically impossible result was found during the iteration process for finding a smoothing spline with fp = s. probably causes : s too small. z6the weighted sum of squared residuals is becoming NaN zthere is an approximation returned but the corresponding weighted sum of squared residuals does not satisfy the condition abs(fp-s)/s < tol. a7error. the maximal number of iterations maxit (set to 20 by the program) allowed for finding a smoothing spline with fp=s has been reached. probably causes : s too small there is an approximation returned but the corresponding weighted sum of squared residuals does not satisfy the condition abs(fp-s)/s < tol. )rr3rNc d}d}d}d\}}|\\} } \} } |} ttD]}| || }}t||krd\}}n|dkr,|| z |kr|} |} | |z} | | kr | |z||zz} S|dkrd}|dkr<| |z |kr+|} |} | |z } | tjkr| | kr ||z| |zz} |dkrd}| |ks|| krd\}}n)t | | ||| | } |dkr||} } ||} } d \}}|dkr.t jtt|d t|| || S) aSolve `f(p) = 0` using a rational function approximation. In a nutshell, since the function f(p) is known to be monotonically decreasing, we - maintain the bracket (p1, f1), (p2, f2) and (p3, f3) - at each iteration step, approximate f(p) by a rational function r(p) = (u*p + v) / (p + w) and make a step to p_new to the root of f(p): r(p_new) = 0. The coefficients u, v and w are found from the bracket values p1..3 and f1...3 The algorithm and implementation follows https://github.com/scipy/scipy/blob/maintenance/1.11.x/scipy/interpolate/fitpack/fpcurf.f#L229 and https://github.com/scipy/scipy/blob/maintenance/1.11.x/scipy/interpolate/fitpack/fppara.f#L290 Note that the latter is for parametric splines and the former is for 1D spline functions. The minimization is indentical though [modulo a summation over the dimensions in the computation of f(p)], so we reuse the minimizer for both d=1 and d>1. g?g?g{Gz?)rr)rTrr)r3F)rNFr3) stacklevel) convergedroot iterationsier) r]MAXITr^rrrwarningswarnRuntimeWarningrr)fp0bracketr`con1con9con4ich1ich3rrrrritrrrrs r root_ratir9s, D D DJD$!HRhr2 AEll4"4"AAaDDB r77S==$NC E 199Bw#~~dF77D2d7*Q66D 199Bw#~~dF< 0` is the input parameter. In other words, we balance maximizing the smoothness (measured as the jumps of the derivative, the first criterion), and the deviation of :math:`g(x_j)` from the data :math:`y_j` (the second criterion). Note that the summation in the second criterion is over all data points, and in the first criterion it is over the internal spline knots (i.e. those with ``xb < t[i] < xe``). The spline knots are in general a subset of data, see `generate_knots` for details. Also note the difference of this routine to `make_lsq_spline`: the latter routine does not consider smoothness and simply solves a least-squares problem .. math:: \sum w_j \times (g(x_j) - y_j)^2 \to \mathrm{min} for a spline function :math:`g(x)` with a _fixed_ knot vector ``t``. .. versionadded:: 1.15.0 Nrs==0 is for interpolation only)rr%rFrQrR)rr7r&rrrJrr) rrrrGrHrrFrrOr%rSrrs r make_splreprsN Aq! $ $B} JJqMM((GAvv =AMT-==>> >!!Q!W====:%H,Q1aB8=RRRAq!Q2r Aq!RQ1dH L L LC E!!!Q$KCE Jr") ruubuerrFrrOr%c Lt| } | dk} t|trtg||||R} nt||||} | |d}|w|ddddf|ddddfz dz} | | | | d}t| d||dz }|dkr/|||td t||j |d |fSt|||||||d | \}}}}}}}|| |}t|||||||||| | } | jj }t!| j|| jd}|| |fS)a Create a smoothing parametric B-spline curve with bounded error, minimizing derivative jumps. Given a list of N 1D arrays, `x`, which represent a curve in N-dimensional space parametrized by `u`, find a smooth approximating spline curve ``g(u)``. Parameters ---------- x : array_like, shape (ndim, m) Sampled data points representing the curve in ``ndim`` dimensions. The typical use is a list of 1D arrays, each of length ``m``. w : array_like, shape(m,), optional Strictly positive 1D array of weights. The weights are used in computing the weighted least-squares spline fit. If the errors in the `x` values have standard deviation given by the vector d, then `w` should be 1/d. Default is ``np.ones(m)``. u : array_like, optional An array of parameter values for the curve in the parametric form. If not given, these values are calculated automatically, according to:: v[0] = 0 v[i] = v[i-1] + distance(x[i], x[i-1]) u[i] = v[i] / v[-1] ub, ue : float, optional The end-points of the parameters interval. Default to ``u[0]`` and ``u[-1]``. k : int, optional Degree of the spline. Cubic splines, ``k=3``, are recommended. Even values of `k` should be avoided especially with a small ``s`` value. Default is ``k=3`` s : float, optional A smoothing condition. The amount of smoothness is determined by satisfying the conditions:: sum((w * (g(u) - x))**2) <= s, where ``g(u)`` is the smoothed approximation to ``x``. The user can use `s` to control the trade-off between closeness and smoothness of fit. Larger ``s`` means more smoothing while smaller values of ``s`` indicate less smoothing. Recommended values of ``s`` depend on the weights, ``w``. If the weights represent the inverse of the standard deviation of ``x``, then a good ``s`` value should be found in the range ``(m - sqrt(2*m), m + sqrt(2*m))``, where ``m`` is the number of data points in ``x`` and ``w``. t : array_like, optional The spline knots. If None (default), the knots will be constructed automatically. There must be at least ``2*k + 2`` and at most ``m + k + 1`` knots. nest : int, optional The target length of the knot vector. Should be between ``2*(k + 1)`` (the minimum number of knots for a degree-``k`` spline), and ``m + k + 1`` (the number of knots of the interpolating spline). The actual number of knots returned by this routine may be slightly larger than `nest`. Default is None (no limit, add up to ``m + k + 1`` knots). bc_type : str, optional Boundary conditions. Default is `"not-a-knot"`. The following boundary conditions are recognized: * ``"not-a-knot"`` (default): The first and second segments are the same polynomial. This is equivalent to having ``bc_type=None``. * ``"periodic"``: The values and the first ``k-1`` derivatives at the ends are equivalent. Returns ------- spl : a `BSpline` instance For `s=0`, ``spl(u) == x``. For non-zero values of ``s``, `spl` represents the smoothed approximation to ``x``, generally with fewer knots. u : ndarray The values of the parameters See Also -------- generate_knots : is used under the hood for generating the knots make_splrep : the analog of this routine 1D functions make_interp_spline : construct an interpolating spline (``s = 0``) make_lsq_spline : construct the least-squares spline given the knot vector splprep : a FITPACK analog of this routine Notes ----- Given a set of :math:`m` data points in :math:`D` dimensions, :math:`\vec{x}_j`, with :math:`j=1, ..., m` and :math:`\vec{x}_j = (x_{j; 1}, ..., x_{j; D})`, this routine constructs the parametric spline curve :math:`g_a(u)` with :math:`a=1, ..., D`, to minimize the sum of jumps, :math:`D_{i; a}`, of the ``k``-th derivative at the internal knots (:math:`u_b < t_i < u_e`), where .. math:: D_{i; a} = g_a^{(k)}(t_i + 0) - g_a^{(k)}(t_i - 0) Specifically, the routine constructs the spline function :math:`g(u)` which minimizes .. math:: \sum_i \sum_{a=1}^D | D_{i; a} |^2 \to \mathrm{min} provided that .. math:: \sum_{j=1}^m \sum_{a=1}^D (w_j \times (g_a(u_j) - x_{j; a}))^2 \leqslant s where :math:`u_j` is the value of the parameter corresponding to the data point :math:`(x_{j; 1}, ..., x_{j; D})`, and :math:`s > 0` is the input parameter. In other words, we balance maximizing the smoothness (measured as the jumps of the derivative, the first criterion), and the deviation of :math:`g(u_j)` from the data :math:`x_j` (the second criterion). Note that the summation in the second criterion is over all data points, and in the first criterion it is over the internal spline knots (i.e. those with ``ub < t[i] < ue``). The spline knots are in general a subset of data, see `generate_knots` for details. .. versionadded:: 1.15.0 References ---------- .. [1] P. Dierckx, "Algorithms for smoothing data with periodic and parametric splines, Computer Graphics and Image Processing", 20 (1982) 171-184. .. [2] P. Dierckx, "Curve and surface fitting with splines", Monographs on Numerical Analysis, Oxford University Press, 1993. rr)rNr5r3rYrr)rrTrQ)rrS)r& isinstancerrstackcumulative_sumsqrtrrrrTrJr7rrr rr)rrrrrrrFrrOr%rrSdprccspl1s r make_splpreprsL ((G:%H!T)  )a ) )A )q ) ) ) Q1a ( ( A yAAAh3B36"Q &   rwwrvvbqv'9'9:: < < b"a!B%i ( (Avv =AMT-==>> >!!QSAA66699,Q1aB8rsV&MMMMMMMMMM  "   0<!<!<!<!~$$GGG"t!$mRmRmRmRHGmR`DFC C C C zFFFR````````DffffffffRGGG&''''''''       "ZFZFZFxDF[[[[|$$GGGDTqDtTYYYYHGYx$$GGG$4TdjjjjHGjjjr"