+ /iF^RIt^RIt^RIt^RIt^RIHtHtHt^RIH t H t H t H t H t Ht^RIt^RIt^RIHt^RIHtHt^RIHt^RIHtHt^RIHt^R IHt^R IHt.R:Ot !RR]!4t"Rt#Rt$Rt%Rt&]'!]!R4PQ4]!R4PQ4R7t)Rt*R;Rlt+]*!]+4R]:!R]64t?]:!R]84t@]:!R]94tAR#)=N)asarraydotvdot)normsolveinvqrsvd LinAlgError)get_blas_funcs)copy_if_needed_dedent_for_py313)getfullargspec_no_self)scalar_search_wolfe1scalar_search_armijo) signature)get_close_matches) GenericAliasbroyden1broyden2anderson linearmixing diagbroydenexcitingmixing newton_krylov BroydenFirstKrylovJacobianInverseJacobian NoConvergencec]tRt^!tRtRtR#)rzXException raised when nonlinear solver fails to converge within the specified `maxiter`.N)__name__ __module__ __qualname____firstlineno____doc____static_attributes__r!T/var/www/html/photoedit/myenv/lib/python3.14/site-packages/scipy/optimize/_nonlin.pyrr!s r(cJ\P!V4P4#N)npabsolutemaxxs&r)maxnormr1's ;;q>   r(c\V4p\P!VP\P4'g\V\P R7#V#)z:Return `x` as an array, of either floats or complex floatsdtype)rr, issubdtyper4inexactfloat64r/s&r) _as_inexactr8+s: A =="** - -q ++ Hr(c\P!V\P!V44p\VRVP4pV!V4#)z;Return ndarray `x` as same array subclass and shape as `x0`__array_wrap__)r,reshapeshapegetattrr:)r0x0wraps&& r) _array_liker@3s8 1bhhrl#A 2')9)9 :D 7Nr(c\P!V4P4'g%\P!\P4#\ V4#r+)r,isfiniteallarrayinfr)vs&r) _safe_normrG:s5 ;;q>    xx 7Nr(z F : function(x) -> f Function whose root to find; should take and return an array-like object. xin : array_like Initial guess for the solution a iter : int, optional Number of iterations to make. If omitted (default), make as many as required to meet tolerances. verbose : bool, optional Print status to stdout on every iteration. maxiter : int, optional Maximum number of iterations to make. If more are needed to meet convergence, `NoConvergence` is raised. f_tol : float, optional Absolute tolerance (in max-norm) for the residual. If omitted, default is 6e-6. f_rtol : float, optional Relative tolerance for the residual. If omitted, not used. x_tol : float, optional Absolute minimum step size, as determined from the Jacobian approximation. If the step size is smaller than this, optimization is terminated as successful. If omitted, not used. x_rtol : float, optional Relative minimum step size. If omitted, not used. tol_norm : function(vector) -> scalar, optional Norm to use in convergence check. Default is the maximum norm. line_search : {None, 'armijo' (default), 'wolfe'}, optional Which type of a line search to use to determine the step size in the direction given by the Jacobian approximation. Defaults to 'armijo'. callback : function, optional Optional callback function. It is called on every iteration as ``callback(x, f)`` where `x` is the current solution and `f` the corresponding residual. Returns ------- sol : ndarray An array (of similar array type as `x0`) containing the final solution. Raises ------ NoConvergence When a solution was not found. ) params_basic params_extracfVP'dVP\,VnR#R#r+)r& _doc_parts)objs&r)_set_docrMxs  {{{kkJ. r(c aaV f\MT p \WgWW:R7p\S4oVV3RlpSP4p\P !V\P 4pV!V4p\V4p\V4pVPVP4VV4Vf)Ve V^,pM^dVP^,,pV RJdRp MV RJdRp V R9d \R4hRpR pR pR p\V4EFpVPVVV4pV'dEM\VVV,4pVP!VVR 7)p\V4^8Xd \R 4hV 'd\#VVVVV 4wppppMRpVV,pV!V4p\V4pVP%VP4V4V 'd V !VV4VV^,,V^,, pVV^,,V8d\VV4pM$\V\'VVV^,,44pTpV'gEKA\(P*P-V RV !V4R RVR R24\(P*P/4EK V'd\1\3VS44h^pV 'd3RVP4RVRVRV^8HR^R^R/V,/p\3VS4V3#\3VS4#)a> Find a root of a function, in a way suitable for large-scale problems. Parameters ---------- %(params_basic)s jacobian : Jacobian A Jacobian approximation: `Jacobian` object or something that `asjacobian` can transform to one. Alternatively, a string specifying which of the builtin Jacobian approximations to use: krylov, broyden1, broyden2, anderson diagbroyden, linearmixing, excitingmixing %(params_extra)s full_output : bool If true, returns a dictionary `info` containing convergence information. raise_exception : bool If True, a `NoConvergence` exception is raise if no solution is found. See Also -------- asjacobian, Jacobian Notes ----- This algorithm implements the inexact Newton method, with backtracking or full line searches. Several Jacobian approximations are available, including Krylov and Quasi-Newton methods. References ---------- .. [KIM] C. T. Kelley, "Iterative Methods for Linear and Nonlinear Equations". Society for Industrial and Applied Mathematics. (1995) https://archive.siam.org/books/kelley/fr16/ N)f_tolf_rtolx_tolx_rtoliterrcV<\S!\VS444P4#r+)r8r@flatten)zFr>s&r)funcnonlin_solve..funcs#1[B/0199;;r(TarmijoFzInvalid line searchg?gH.?g?gMbP?)tolz[Jacobian inversion yielded zero vector. This indicates a bug in the Jacobian approximation.?z : |F(x)| = gz; step  nitfunstatussuccessmessagez0A solution was found at the specified tolerance.z:The maximum number of iterations allowed has been reached.)NrZwolfe)r1TerminationConditionr8rUr, full_likerEr asjacobiansetupcopysize ValueErrorrangecheckminr_nonlin_line_searchupdater.sysstdoutwriteflushrr@ iteration) rWr>jacobianrSverbosemaxiterrOrPrQrRtol_norm line_searchcallback full_outputraise_exception conditionrXr0dxFxFx_normgammaeta_max eta_tresholdetanrar[s Fx_norm_neweta_Ainfos ff&&&&&&&&&&&&& r) nonlin_solver}sZ#*wH$5+0*.?I RB< A a B aB2hG(#H NN1668R&  QhG166!8nGd   33.// EGL C 7^Q+  #s7{#nnRSn) ) 8q=./ / $7aR8C%E !Aq"kABAaBr(K"%  QO Q&!3 36>L (gu%Cgs5%Q,78C 7 JJ  s,x|A.>gaU"M N JJ   SV  Ar 23 3Fy**r&6Q;A , 3% & 1b!4''1b!!r(caaaaa a aaa^.oV.o\V4^,.o\S4\S4, o R VVVVVV3Rllo V VV 3RlpVR8Xd\S VS^,RVR7wrp M'VR8Xd!\S S^,S^,)VR7wrXfRpSVS,,oVS^,8Xd S^,pMS!S4p\V4p VSW+3#) rc<VS ^,8Xd S^,#S VS,,pS!V4p\V4^,pV'dVS ^&VS^&VS^&V#r)rG) rstorextrFprrXtmp_Fxtmp_phitmp_sr0s && r)phi _nonlin_line_search..phis_ a=1:  2X H qM1  E!HGAJF1Ir(c<\V4S,^,S,pS!W,RR7S!V4, V, #)F)r)abs)rdsrrdiffs_norms& r)derphi#_nonlin_line_search..derphi%s7!fvo!U *AD&Q/255r(rd{Gz?)xtolaminrZ)rr\)T)rrr)rXr0rr search_typersminrrphi1phi0rrrrrrsff&f&f& @@@@@r)roros CETFBx{mG !WtBx F  6g,S&'!*26TC   &sGAJ ,02 y  AbDAE!H} AY !W2hG a r(c@a]tRtRtoRtRRRRR]3RltRtRtVt R#)rei?z Termination condition for an iteration. It is terminated if - |F| < f_rtol*|F_0|, AND - |F| < f_tol AND - |dx| < x_rtol*|x|, AND - |dx| < x_tol NcTVf6\P!\P4PR,pVf\PpVf\PpVf\PpW0nW@nWnW nW`n WPn RVn ^Vn R#)NgUUUUUU?) r,finfor7epsrErQrRrOrPrrSf0_normru)selfrOrPrQrRrSrs&&&&&&&r)__init__TerminationCondition.__init__Ls| =HHRZZ(,,6E >VVF =FFE >VVF       r(cV;P^, unVPV4pVPV4pVPV4pVPfW@nV^8Xd^#VPe!^VPVP8,#\ W@P 8*;'dSW@P , VP8*;'d,W`P8*;'dW`P, V8*4#)r) rurrrSintrOrPrQrR)rfr0rf_normx_normdx_norms&&&& r)rmTerminationCondition.checkds !11))B- << !L Q; 99 23 3Fjj(;;{{*dll:;;::-::#KK/69< .__array__s'$$'A%%IJJ||~%r() rrpmatvecrmatvecrsolvematmatrr<r4NN)itemsrksetattrhasattr)rkwnamesnamevaluers&, r)rJacobian.__init__s_888:KD  #>  8>> 1 KK  2r()r4rXr<Nr)r"r#r$r%r& classmethodr__class_getitem__rrrrprhr'rrs@r)rrs6#L$L1& %" r(rcZa]tRtRtoRt]!]4tRt] R4t ] R4t Rt Vt R#)riaG A simple wrapper that inverts the Jacobian using the `solve` method. .. legacy:: class See the newer, more consistent interfaces in :mod:`scipy.optimize`. Parameters ---------- jacobian : Jacobian The Jacobian to invert. Attributes ---------- shape Matrix dimensions (M, N) dtype Data type of the matrix. cWnVPVnVPVn\ VR4'dVP Vn\ VR4'dVP VnR#R#)rhrN)rvrrrprrhrr)rrvs&&r)rInverseJacobian.__init__sR nn oo 8W % %!DJ 8X & &#??DL 'r(c.VPP#r+)rvr<rs&r)r<InverseJacobian.shape}}"""r(c.VPP#r+)rvr4rs&r)r4InverseJacobian.dtyperr()rvrrrhrpN)r"r#r$r%r&rrrrpropertyr<r4r'rrs@r)rrsD,$L1+####r(c aa\PPPo\ S\ 4'dS#\ P!S4'd\S\ 4'dS!4#\ S\P4'dSP^8d \R4h\P!\P!S44oSP^,SP^,8wd \R4h\ V3RlV3RlRV3RllRV3RllSP SPR7#\PP#S4'dpSP^,SP^,8wd \R4h\ V3R lV3R lRVV3R llRVV3R llSP SPR7#\%SR 4'd\%SR4'dv\%SR4'dd\ \'SR4\'SR4SP(\'SR4\'SR4\'SR4SP SPR7#\+S4'd!VV3RlR\ 4pV!4#\ S\,4'd;\/\0\2\4\6\8\:\<R7S,!4#\?R4h)z= Convert given object to one suitable for use as a Jacobian. zarray must have rank <= 2zarray must be squarec<\SV4#r+)rrFJs&r)asjacobian..s Qr(cL<\SP4PV4#r+)rconjTrs&r)rrs#affhjj!*.JacicWnR#r+r/rs&&&r)rpasjacobian..Jac.updatesr(c<S!VP4p\V\P4'd \ W14#\ P PV4'd S!W14#\R4hzUnknown matrix type) r0 isinstancer,ndarrayrscipysparseissparserkrrFr[mrrs&&& r)rasjacobian..Jac.solve!sVdffIa,, ;&\\**1--"1=($%:;;r(c<S!VP4p\V\P4'd \ W!4#\ P PV4'd W!,#\R4hr) r0rr,rrrrrrkrrFrrs&& r)rasjacobian..Jac.matvec*sSdffIa,,q9$\\**1--5L$%:;;r(cR<S!VP4p\V\P4'd%\ VP 4P V4#\PPV4'd"S!VP 4P V4#\R4hr) r0rr,rrrrrrrrkrs&&& r)rasjacobian..Jac.rsolve3spdffIa,, Q//\\**1--"1668::q11$%:;;r(cR<S!VP4p\V\P4'd%\ VP 4P V4#\PPV4'd"VP 4P V,#\R4hr) r0rr,rrrrrrrrkr s&& r)rasjacobian..Jac.rmatvec<smdffIa,,qvvxzz1--\\**1--668::>)$%:;;r(r/Nr) r"r#r$r%rprrrrr'r)rrrs@r)Jacrs-  < < < < < < >r(cBa]tRtRto]!]4tRtRtRt Rt Vt R#)GenericBroydeniUc\PWW#4W nWn\ VR4'dWVP fG\ V4pV'd+R\\ V4^4,V, VnR#RVnR#R#R#)alphaN?r\)rrhlast_flast_xrr%rr.)rr>f0rXnormf0s&&&& r)rhGenericBroyden.setupYsit*  4 ! !djj&8"XF T"Xq!11F:   '9 !r(c\hr+rrr0rrdfrdf_norms&&&&&&&r)_updateGenericBroyden._updategrr(c W P, pWP, pVPWWC\V4\V44W nWnR#r+)r'r(r0r)rr0rr.rs&&& r)rpGenericBroyden.updatejs< _ _ Q248T"X6  r()r%r'r(N) r"r#r$r%rrrrhr0rpr'rrs@r)r#r#Us$#L1 !"r(r#ca]tRtRtoRt]!]4tRt] R4t ] R4t Rt Rt RRltRR ltR tRR ltR tRtRtRRltRtVtR #) LowRankMatrixirz A matrix represented as .. math:: \alpha I + \sum_{n=0}^{n=M} c_n d_n^\dagger However, if the rank of the matrix reaches the dimension of the vectors, full matrix representation will be used thereon. cTWn.Vn.VnW nW0nRVnR#r+)r%csrrr4 collapsed)rr%rr4s&&&&r)rLowRankMatrix.__init__s&  r(c\.ROVR,V.,4wrEpW,p\W#4F!wrV!W4p V!WVPV 4pK# V#)axpyNrN)r;scaldotc)r ziprj) rFr%r7rr;r=r>wcdas &&&& r)_matvecLowRankMatrix._matvecsZ)*B*,R&A3,8D IKDAQ AQ1661%A r(c  \V4^8Xd W, #\RR.VR,V.,4wrEV^,pV\P!\V4VPR7,p\ V4F5wr\ V4F!wrWxV 3;;,V!W4, uu&K# K7 \P !\V4VPR7p \ V4FwrV!W4W&K W,p \W|4p W, p \W,4FwrV!WV PV)4p K V #)Evaluate w = M^-1 vr;r>r<r3) lenr r,identityr4 enumeratezerosrr?rj)rFr%r7rr;r>c0AirBjrAqr@qcs&&&& r)_solveLowRankMatrix._solves r7a<7N$VV$4bfslC  U BKKBrxx8 8bMDA!" A#$q*$&" HHSWBHH -bMDA:AD"  !K GZEAQ166B3'A r(c VPe"\P!VPV4#\P WP VP VP4#)zEvaluate w = M v)r8r,rr5rDr%r7rrrFs&&r)rLowRankMatrix.matvecsB >> %66$..!, ,$$Q DGGTWWEEr(c $VPe:\P!VPPP 4V4#\ P V\P!VP4VPVP4#)zEvaluate w = M^H v) r8r,rrrr5rDr%rr7rUs&&r)rLowRankMatrix.rmatvecs\ >> %66$..**//115 5$$Q (;TWWdggNNr(c VPe\VPV4#\PWPVP VP 4#)rG)r8rr5rRr%r7rrs&&&r)rLowRankMatrix.solves> >> %+ +##Azz477DGGDDr(c VPe/\VPPP4V4#\P V\ P!VP4VPVP4#)zEvaluate w = M^-H v) r8rrrr5rRr,r%rr7rs&&&r)rLowRankMatrix.rsolvesX >> %))..0!4 4##Arwwtzz':DGGTWWMMr(cvVPe?V;PVR,VR,P4,, unR#VPPV4VPPV4\ VP4VP 8dVP4R#R#)NNNNNNr_)r8rr7appendrrHrjcollapse)rrArBs&&&r)raLowRankMatrix.appendss >> % NNai!F)..*:: :N  q q tww~O%& (   MM99=nN%& ( >> %>> ! ZZ DFF$**= =)DA F)AfINN,, ,B* r(c r\P!V\R7VnRVnRVnRVnR#)z0Collapse the low-rank matrix to a full-rank one.)riN)r,rDr r8r7rr%rs&r)rbLowRankMatrix.collapses)$^< r(c VPeR#V^8gQh\VP4V8dVPRVPRR#R#)z8 Reduce the rank of the matrix by dropping all vectors. Nr_r8rHr7rrranks&&r)restart_reduceLowRankMatrix.restart_reducesG >> % axx tww<$    r(c VPeR#V^8gQh\VP4V8dVP^VP^K6R#)z; Reduce the rank of the matrix by dropping oldest vectors. Nrmrns&&r) simple_reduceLowRankMatrix.simple_reducesG >> % axx$''lT!  "r(c VPeR#TpVeTpM V^, pVP'd'\V\VP^,44p\ ^\WC^, 44p\VP4pWS8dR#\ P !VP4Pp\ P !VP4Pp\VRR7wrx\WhPP44p\VRR7wrp \V\V 44p\W{PP44p\V4FOp VRV 3,P4VPV &VRV 3,P4VPV &KQ VPVR1VPVR1R#)al Reduce the rank of the matrix by retaining some SVD components. This corresponds to the "Broyden Rank Reduction Inverse" algorithm described in [1]_. Note that the SVD decomposition can be done by solving only a problem whose size is the effective rank of this matrix, which is viable even for large problems. Parameters ---------- max_rank : int Maximum rank of this matrix after reduction. to_retain : int, optional Number of SVD components to retain when reduction is done (ie. rank > max_rank). Default is ``max_rank - 2``. References ---------- .. [1] B.A. van der Rotten, PhD thesis, "A limited memory Broyden method to solve high-dimensional systems of nonlinear equations". Mathematisch Instituut, Universiteit Leiden, The Netherlands (2003). https://web.archive.org/web/20161022015821/http://www.math.leidenuniv.nl/scripties/Rotten.pdf Neconomic)modeF) full_matricesr_)r8r7rnrHr.r,rDrrr rrr rrlri) rmax_rank to_retainrrPrCDRUSWHks &&& r) svd_reduceLowRankMatrix.svd_reducesY: >> %    AAA 777As4771:'A 3qA#;  L 5  HHTWW    HHTWW   !*% 3388: q.b 3r7O 4499; qA1Q3DGGAJ1Q3DGGAJ GGABK GGABKr()r%r8r7rr4rrrr+)r"r#r$r%r&rrrr staticmethodrDrRrrrrrarrbrprsrr'rrs@r)r5r5rs$L16F O E N "  ??r(r5a alpha : float, optional Initial guess for the Jacobian is ``(-1/alpha)``. reduction_method : str or tuple, optional Method used in ensuring that the rank of the Broyden matrix stays low. Can either be a string giving the name of the method, or a tuple of the form ``(method, param1, param2, ...)`` that gives the name of the method and values for additional parameters. Methods available: - ``restart``: drop all matrix columns. Has no extra parameters. - ``simple``: drop oldest matrix column. Has no extra parameters. - ``svd``: keep only the most significant SVD components. Takes an extra parameter, ``to_retain``, which determines the number of SVD components to retain when rank reduction is done. Default is ``max_rank - 2``. max_rank : int, optional Maximum rank for the Broyden matrix. Default is infinity (i.e., no rank reduction). broyden_paramsc`a]tRtRtoRtR RltRtRtRRltRt RR lt R t R t R t VtR#)riYa Find a root of a function, using Broyden's first Jacobian approximation. This method is also known as "Broyden's good method". Parameters ---------- %(params_basic)s %(broyden_params)s %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='broyden1'`` in particular. Notes ----- This algorithm implements the inverse Jacobian Quasi-Newton update .. math:: H_+ = H + (dx - H df) dx^\dagger H / ( dx^\dagger H df) which corresponds to Broyden's first Jacobian update .. math:: J_+ = J + (df - J dx) dx^\dagger / dx^\dagger dx References ---------- .. [1] B.A. van der Rotten, PhD thesis, "A limited memory Broyden method to solve high-dimensional systems of nonlinear equations". Mathematisch Instituut, Universiteit Leiden, The Netherlands (2003). https://math.leidenuniv.nl/scripties/Rotten.pdf Examples -------- The following functions define a system of nonlinear equations >>> def fun(x): ... return [x[0] + 0.5 * (x[0] - x[1])**3 - 1.0, ... 0.5 * (x[1] - x[0])**3 + x[1]] A solution can be obtained as follows. >>> from scipy import optimize >>> sol = optimize.broyden1(fun, [0, 0]) >>> sol array([0.84116396, 0.15883641]) Ncaa\PS4VSnRSnVf\P pVSn\V\4'dR oMVR,oV^,pV^, 3S,oVR8XdVV3RlSn R#VR8XdVV3RlSn R#VR8XdVV3RlSn R#\RV R 24h) N:rNNr c8<SPP!S!#r+)rhr reduce_paramsrsr)r'BroydenFirst.__init__..s477#5#5}#Er(simplec8<SPP!S!#r+)rhrsrsr)rrs477#8#8-#Hr(restartc8<SPP!S!#r+)rhrprsr)rrs477#9#9=#Ir(zUnknown rank reduction method ''r!) r#rr%rhr,rEryrr_reducerk)rr%reduction_methodryrsf&&&@r)rBroydenFirst.__init__s%   vvH  & , ,M,R0M/2 !A-7 u $EDL  )HDL  *IDL>?O>PPQRS Sr(c\PWW#4\VP)VP^,VP 4VnR#)rN)r#rhr5r%r<r4rhrs&&&&r)rhBroydenFirst.setups4Ta. TZZ]DJJGr(c,\VP4#r+)rrhrs&r)rBroydenFirst.todenses477|r(c(VPPV4p\P!V4P 4'gMVP VP VPVP4VPPV4#V#r+) rhrr,rBrCrhr(r'rX)rrr[rs&&& r)rBroydenFirst.solves_ GGNN1 {{1~!!## JJt{{DKK ;77>>!$ $r(c8VPPV4#r+)rhrrrs&&r)rBroydenFirst.matvecsww}}Qr(c8VPPV4#r+)rhrrrr[s&&&r)rBroydenFirst.rsolveswwq!!r(c8VPPV4#r+)rhrrs&&r)rBroydenFirst.rmatvecsww~~a  r(cVP4VPPV4pW0PPV4, pV\ WG4, p VPP W4R#r+)rrhrrrra rr0rrr.rr/rFrArBs &&&&&&& r)r0BroydenFirst._updatesO  GGOOB  # # R O qr()rhrr%ry)NrNr)r"r#r$r%r&rrhrrrrrr0r'rrs@r)rrYs:2hT2H "!r(c*a]tRtRtoRtRtRtVtR#)ria Find a root of a function, using Broyden's second Jacobian approximation. This method is also known as "Broyden's bad method". Parameters ---------- %(params_basic)s %(broyden_params)s %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='broyden2'`` in particular. Notes ----- This algorithm implements the inverse Jacobian Quasi-Newton update .. math:: H_+ = H + (dx - H df) df^\dagger / ( df^\dagger df) corresponding to Broyden's second method. References ---------- .. [1] B.A. van der Rotten, PhD thesis, "A limited memory Broyden method to solve high-dimensional systems of nonlinear equations". Mathematisch Instituut, Universiteit Leiden, The Netherlands (2003). https://web.archive.org/web/20161022015821/http://www.math.leidenuniv.nl/scripties/Rotten.pdf Examples -------- The following functions define a system of nonlinear equations >>> def fun(x): ... return [x[0] + 0.5 * (x[0] - x[1])**3 - 1.0, ... 0.5 * (x[1] - x[0])**3 + x[1]] A solution can be obtained as follows. >>> from scipy import optimize >>> sol = optimize.broyden2(fun, [0, 0]) >>> sol array([0.84116365, 0.15883529]) cVP4TpW0PPV4, pWv^,, p VPPW4R#N)rrhrrars &&&&&&& r)r0BroydenSecond._updates@   # #  N qr(r!N)r"r#r$r%r&r0r'rrs@r)rrs0dr(rcDa]tRtRtoRtR RltR RltRtRtRt Vt R#) ri az Find a root of a function, using (extended) Anderson mixing. The Jacobian is formed by for a 'best' solution in the space spanned by last `M` vectors. As a result, only a MxM matrix inversions and MxN multiplications are required. [Ey]_ Parameters ---------- %(params_basic)s alpha : float, optional Initial guess for the Jacobian is (-1/alpha). M : float, optional Number of previous vectors to retain. Defaults to 5. w0 : float, optional Regularization parameter for numerical stability. Compared to unity, good values of the order of 0.01. %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='anderson'`` in particular. References ---------- .. [Ey] V. Eyert, J. Comp. Phys., 124, 271 (1996). Examples -------- The following functions define a system of nonlinear equations >>> def fun(x): ... return [x[0] + 0.5 * (x[0] - x[1])**3 - 1.0, ... 0.5 * (x[1] - x[0])**3 + x[1]] A solution can be obtained as follows. >>> from scipy import optimize >>> sol = optimize.anderson(fun, [0, 0]) >>> sol array([0.84116588, 0.15883789]) Nc~\PV4WnW0n.Vn.VnRVnW nR#r+)r#rr%Mrr.rw0)rr%rrs&&&&r)rAnderson.__init__Ps4%  r(cZVP)V,p\VP4pV^8XdV#\P!WAP R7p\ V4F"p\VPV,V4WV&K$ \VPV4p\ T4FSpY7T,TPT,TPTPT,,,,, pKU T# \d TPRTPRTu#i;i)rr3r_) r%rHrr,emptyr4rlrr.rrCr ) rrr[rrdf_frrrs &&& r)rAnderson.solveYsjj[] L 6Ixx)qA4771:q)DG $&&$'EqA (DGGAJDGGAJ)>>? ?B    I  sD'D*)D*c V)VP, p\VP4pV^8XdV#\P!W1P R7p\ V4F"p\VPV,V4WE&K$ \P!W33VP R7p\ V4Fp\ V4Fp\VPV,VPV,4WgV3&Wx8XgK=VP^8wgKPWgV3;;,\VPV,VPV,4VP^,,VP,,uu&K K \Wd4p \ V4FSp W)V ,VPV ,VPV ,VP, ,,, pKU V#)rr3) r%rHrr,rr4rlrr.rr) rrrrrrbrNrOrrs && r)rAnderson.matvecpsOR ] L 6Ixx)qA4771:q)DG HHaV177 +qA1Xdggaj$''!*5A#6dgglcFd4771:twwqz:477A:EdjjPPF aqA (DGGAJDJJ)>>? ?B r(c8VP^8XdR#VPPV4VPPV4\ VP4VP8d9VPP ^4VPP ^4K\\ VP4p\ P!Ww3VPR7p\V4Fqp \W4F_p W8XdVP^,p M^p ^V ,\VPV ,VPV ,4,WV 3&Ka Ks V\ P!V^4PP4, pWnR#)rNr3)rrrar.rHpopr,rKr4rlrrtriurrrC) rr0rrr.rr/rrCrNrOwds &&&&&&& r)r0Anderson._updates  66Q;  r r$''lTVV# GGKKN GGKKN L HHaV177 +qA1[6!BBB$TWWQZ <<A# ! RWWQ]__ ! ! ##r()rrCr%r.rrr)Nrr) r"r#r$r%r&rrrr0r'rrs@r)rr s$+L..r(rc`a]tRtRtoRtR RltRtRRltRtRRlt R t R t R t R t VtR#)ria Find a root of a function, using diagonal Broyden Jacobian approximation. The Jacobian approximation is derived from previous iterations, by retaining only the diagonal of Broyden matrices. .. warning:: This algorithm may be useful for specific problems, but whether it will work may depend strongly on the problem. Parameters ---------- %(params_basic)s alpha : float, optional Initial guess for the Jacobian is (-1/alpha). %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='diagbroyden'`` in particular. Examples -------- The following functions define a system of nonlinear equations >>> def fun(x): ... return [x[0] + 0.5 * (x[0] - x[1])**3 - 1.0, ... 0.5 * (x[1] - x[0])**3 + x[1]] A solution can be obtained as follows. >>> from scipy import optimize >>> sol = optimize.diagbroyden(fun, [0, 0]) >>> sol array([0.84116403, 0.15883384]) Nc<\PV4WnR#r+r#rr%rr%s&&r)rDiagBroyden.__init__% r(c\PWW#4\P!VP^,3^VP , VP R7VnR#rr3N)r#rhr,fullr<r%r4rBrs&&&&r)rhDiagBroyden.setups=Ta.$**Q-)1tzz>Lr(c*V)VP, #r+rBrs&&&r)rDiagBroyden.solverDFF{r(c*V)VP,#r+rrs&&r)rDiagBroyden.matvecrr(cFV)VPP4, #r+rBrrs&&&r)rDiagBroyden.rsolverDFFKKM!!r(cFV)VPP4,#r+rrs&&r)rDiagBroyden.rmatvecrr(cD\P!VP)4#r+)r,diagrBrs&r)rDiagBroyden.todenseswwwr(cV;PW@PV,,V,V^,, ,unR#rrr-s&&&&&&&r)r0DiagBroyden._updates( 2r >2%gqj00r()r%rBr+rr"r#r$r%r&rrhrrrrrr0r'rrs@r)rrs9&PM"" 11r(rcZa]tRtRtoRtR RltR RltRtR RltRt R t R t R t Vt R#)ria Find a root of a function, using a scalar Jacobian approximation. .. warning:: This algorithm may be useful for specific problems, but whether it will work may depend strongly on the problem. Parameters ---------- %(params_basic)s alpha : float, optional The Jacobian approximation is (-1/alpha). %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='linearmixing'`` in particular. Nc<\PV4WnR#r+rrs&&r)rLinearMixing.__init__rr(c*V)VP,#r+r%rs&&&r)rLinearMixing.solver$**}r(c*V)VP, #r+rrs&&r)rLinearMixing.matvecrr(cRV)\P!VP4,#r+r,rr%rs&&&r)rLinearMixing.rsolve r"''$**%%%r(cRV)\P!VP4, #r+rrs&&r)rLinearMixing.rmatvec rr(c\P!\P!VP^,RVP, 44#)r)r,rrr<r%rs&r)rLinearMixing.todenses,wwrwwtzz!}bm<==r(cR#r+r!r-s&&&&&&&r)r0LinearMixing._updaterr(rr+r)r"r#r$r%r&rrrrrrr0r'rrs@r)rrs2,&&>  r(rc`a]tRtRtoRtR RltRtRRltRtRRlt R t R t R t R t VtR#)r ia Find a root of a function, using a tuned diagonal Jacobian approximation. The Jacobian matrix is diagonal and is tuned on each iteration. .. warning:: This algorithm may be useful for specific problems, but whether it will work may depend strongly on the problem. See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='excitingmixing'`` in particular. Parameters ---------- %(params_basic)s alpha : float, optional Initial Jacobian approximation is (-1/alpha). alphamax : float, optional The entries of the diagonal Jacobian are kept in the range ``[alpha, alphamax]``. %(params_extra)s NcV\PV4WnW nRVnR#r+)r#rr%alphamaxbeta)rr%rs&&&r)rExcitingMixing.__init__2s!%   r(c\PWW#4\P!VP^,3VP VP R7VnR#r)r#rhr,rr<r%r4rrs&&&&r)rhExcitingMixing.setup8s9Ta.GGTZZ],djj K r(c*V)VP,#r+rrs&&&r)rExcitingMixing.solve<r$))|r(c*V)VP, #r+rrs&&r)rExcitingMixing.matvec?rr(cFV)VPP4,#r+rrrs&&&r)rExcitingMixing.rsolveBr$)).."""r(cFV)VPP4, #r+rrs&&r)rExcitingMixing.rmatvecErr(cP\P!RVP, 4#)rr)r,rrrs&r)rExcitingMixing.todenseHswwr$))|$$r(c&W P,^8pVPV;;,VP, uu&VPVPV(&\P!VP^VP VPR7R#)r)outN)r'rr%r,clipr)rr0rrr.rr/incrs&&&&&&& r)r0ExcitingMixing._updateKsZ}q  $4::%:: 4%  1dmm;r()r%rr)Nr\rrrs@r)r r s84 L##%<>> from scipy.optimize import BroydenFirst, KrylovJacobian >>> from scipy.optimize import InverseJacobian >>> jac = BroydenFirst() >>> kjac = KrylovJacobian(inner_M=InverseJacobian(jac)) If the preconditioner has a method named 'update', it will be called as ``update(x, f)`` after each nonlinear step, with ``x`` giving the current point, and ``f`` the current function value. outer_k : int, optional Size of the subspace kept across LGMRES nonlinear iterations. See `scipy.sparse.linalg.lgmres` for details. inner_kwargs : kwargs Keyword parameters for the "inner" Krylov solver (defined with `method`). Parameter names must start with the `inner_` prefix which will be stripped before passing on the inner method. See, e.g., `scipy.sparse.linalg.gmres` for details. %(params_extra)s See Also -------- root : Interface to root finding algorithms for multivariate functions. See ``method='krylov'`` in particular. scipy.sparse.linalg.gmres scipy.sparse.linalg.lgmres Notes ----- This function implements a Newton-Krylov solver. The basic idea is to compute the inverse of the Jacobian with an iterative Krylov method. These methods require only evaluating the Jacobian-vector products, which are conveniently approximated by a finite difference: .. math:: J v \approx (f(x + \omega*v/|v|) - f(x)) / \omega Due to the use of iterative matrix inverses, these methods can deal with large nonlinear problems. SciPy's `scipy.sparse.linalg` module offers a selection of Krylov solvers to choose from. The default here is `lgmres`, which is a variant of restarted GMRES iteration that reuses some of the information obtained in the previous Newton steps to invert Jacobians in subsequent steps. For a review on Newton-Krylov methods, see for example [1]_, and for the LGMRES sparse inverse method, see [2]_. References ---------- .. [1] C. T. Kelley, Solving Nonlinear Equations with Newton's Method, SIAM, pp.57-83, 2003. :doi:`10.1137/1.9780898718898.ch3` .. [2] D.A. Knoll and D.E. Keyes, J. Comp. Phys. 193, 357 (2004). :doi:`10.1016/j.jcp.2003.08.010` .. [3] A.H. Baker and E.R. Jessup and T. Manteuffel, SIAM J. Matrix Anal. Appl. 26, 962 (2005). :doi:`10.1137/S0895479803422014` Examples -------- The following functions define a system of nonlinear equations >>> def fun(x): ... return [x[0] + 0.5 * x[1] - 1.0, ... 0.5 * (x[1] - x[0]) ** 2] A solution can be obtained as follows. >>> from scipy import optimize >>> sol = optimize.newton_krylov(fun, [0, 0]) >>> sol array([0.66731771, 0.66536458]) Nc W@nWn\\PP P \PP P\PP P\PP P\PP P\PP PR7PW"4Vn \W0PR7VnVP\PP PJd<W0PR&^VPR&VPPR^4EMVVP\PP P \PP P \PP P39dVPPR^4MVP\PP PJdWPPR&^VPR&VPPR.4VPPRR4VPPR R 4VPPR^4\#VP4P$Uu.uFpVR9gK VNK ppVP'4FwrV P)R 4'g\+R V 24hV R ,V9d[\-V R ,V^R7p V 'dRV ^, R2p MRp \.P0!RV RV R2V ,^\2R7KWPV R ,&K R#uupi))bicgstabgmreslgmrescgsminrestfqmr)rxrrrxatolouter_kouter_vprepend_outer_vTstore_outer_AvFinner_zUnknown parameter :NN)rz Did you mean 'z'?zOption 'z#' is invalid for the inner method: zO. It will be ignored.Please check inner method documentation for valid options.)recategoryN)rargskwargs)preconditionerrrrrrr r r r r rgetmethod method_kw setdefaultgcrotmkr parametersr startswithrkrrfrg UserWarning) rrr inner_maxiterinner_Mrrrvalid_inner_paramskeyrinner_param_suggestionssuggestion_msgs &&&&&&, r)rKrylovJacobian.__init__s% \\((11,,%%++<<&&-- ##''<<&&--,,%%++ c&! m7J7JK ;;%,,--33 3(5NN9 %()DNN9 % NN % %fa 0 [[U\\0088"\\0099"\\004466 NN % %fa 0 [[ELL//66 6(/NN9 %()DNN9 % NN % %i 4 NN % %&7 > NN % %&6 > NN % %fa 0!-88 8!22 A8  ((*JC>>(++ #5cU!;<<2w00*;CG?+A'+(7)@)C(DB'HN&(N se#FvhOQQ%% !( &+NN3r7 #7%  s = O Oc\VP4P4p\VP4P4pVP\^V4,\^V4, VnR#)rN)rr>r.r)romega)rmxmfs& r)_update_diff_step KrylovJacobian._update_diff_step sO \    \   ZZ#a*,s1bz9 r(c\V4pV^8Xd ^V,#VPV, pVPVPW1,,4VP, V, p\ P !\ P!V44'g<\ P !\ P!V44'd \R4hV#)rz$Function returned non-finite results) rr+rXr>r)r,rCrBrk)rrFnvscrs&& r)rKrylovJacobian.matvecs !W 7Q3J ZZ"_ YYtww~ & 0B 6vvbkk!n%%"&&Q*@*@CD Dr(cRVP9d-VP!VPV3/VPBwr4V#VP!VPV3RV/VPBwr4V#)rtol)rrop)rrhsr[solrs&&& r)rKrylovJacobian.solves_ T^^ # DGGSCDNNCIC  DGGSMsMdnnMIC r(cWnW nVP4VPe<\ VPR4'dVPP W4R#R#R#)Nrp)r>r)r.rrrp)rr0rs&&&r)rpKrylovJacobian.updatesW      *t**H55##**106 +r(c\PWW#4WnW n\P P PV4VnVPf7\P!VP4PR,Vn VP4VPe=\!VPR4'dVPPWV4R#R#R#)Nrhr&)rrhr>r)rrraslinearoperatorr6rr,rr4rr.rr)rr0rrXs&&&&r)rhKrylovJacobian.setup)st(,,%%66t< :: !''*..48DJ      *t**G44##))!55 +r()r)rrr+r6rrr>)Nr N r) r"r#r$r%r&rr.rrrprhr'rrs@r)rrVs1cJK,Z: 166r(c \VP4pVwr4rVrxp \\V\ V4)RV44p RP V U U u.uF wrV RV : 2NK up p 4p V 'd RV ,p RP V U U u.uF wrV RV 2NK up p 4pV'd VR,pV'd\ RV 24hRpV\W VPVR7,p/pVP\44\VV4VV,pVPVn \V4V#uup p iuup p i)z Construct a solver wrapper with given name and Jacobian approx. It inspects the keyword arguments of ``jac.__init__``, and allows to use the same arguments in the wrapper function, in addition to the keyword arguments of `nonlin_solve` Nz, =zUnexpected signature a def %(name)s(F, xin, iter=None %(kw)s, verbose=False, maxiter=None, f_tol=None, f_rtol=None, x_tol=None, x_rtol=None, tol_norm=None, line_search='armijo', callback=None, **kw): jac = %(jac)s(%(kwkw)s **kw) return nonlin_solve(F, xin, jac, iter, verbose, maxiter, f_tol, f_rtol, x_tol, x_rtol, tol_norm, line_search, callback) )rrjackwkw)_getfullargspecrlistr?rHjoinrkrr"rpglobalsexecr&rM)rrCrrvarargsvarkwdefaults kwonlyargs kwdefaults_rrrFkw_strkwkw_strwrappernsrXs&& r)_nonlin_wrapperrT>s*  -I@I=D5JA #dCM>?+X6 7F YY81#Qqe 8 9F yy8QCq*89Hd?0 <==G$s||"*,,G BIIgi" d8D;;DL TN K;99s D; E ) rrrrrrrrrrr) rNFNNNNNNrZNFT)rZg:0yE>r)Brrqrfnumpyr,rrr scipy.linalgrrrr r r scipy.sparse.linalgr scipy.sparser scipy._lib._utilr rrrE _linesearchrrrdifflibrtypesr__all__ Exceptionrr1r8r@rGrstriprKrMrrorerrrgr#r5rrrrrr rrTrrrrrrrr!r(r)r`s $$??'>FC% J I   "$ "($( P a1 h/ O"d *Z9<9<@HHV(#(#VY?@X:LL^ 12 * + 0m>m`9L9@U~UxA1.A1H+ >+ \8<^8<~a6Xa6P)X :| 4 :} 5 :x 0~|< m[9  !1>B@ r(