o iU>@spddlZddlZddlmZddlmZmZmZm Z m Z m Z ddl m Z dgZ  ddd Z  dddZdS)N) LinAlgError)get_blas_funcsqrsolvesvd qr_insertlstsq) make_systemgcrotmkFc " Cs|durdd}|durdd}tgd|f\} } } } |g} g}d}tj}|t|}tjt||f|jd}tjd|jd}tjd|jd}t|jj}d }t |D];}|rg|t|krg||\}}n.|rv|t|krv||}d}n|s||t|kr|||t|\}}n|| d }d}|dur|||}n| }| |}t |D]\}}| ||}||||f<| |||j d | }qtj|d |jd}t | D]\}}| ||}|||<| |||j d | }q| |||d <tj dddd |d }Wdn 1swYt|r| ||}|d ||ks*d}| |||tj|d |d f|jdd}||d|d d|d f<d ||d |d f<tj|d |f|jdd} || d|d ddf<t|| ||ddd d\}}t|d}||ks|rnqUt|||fstt|d|d d|d f|d d|d f\}}!}!}!|ddd|d f}|||| |||fS)a FGMRES Arnoldi process, with optional projection or augmentation Parameters ---------- matvec : callable Operation A*x v0 : ndarray Initial vector, normalized to nrm2(v0) == 1 m : int Number of GMRES rounds atol : float Absolute tolerance for early exit lpsolve : callable Left preconditioner L rpsolve : callable Right preconditioner R cs : list of (ndarray, ndarray) Columns of matrices C and U in GCROT outer_v : list of ndarrays Augmentation vectors in LGMRES prepend_outer_v : bool, optional Whether augmentation vectors come before or after Krylov iterates Raises ------ LinAlgError If nans encountered Returns ------- Q, R : ndarray QR decomposition of the upper Hessenberg H=QR B : ndarray Projections corresponding to matrix C vs : list of ndarray Columns of matrix V zs : list of ndarray Columns of matrix Z y : ndarray Solution to ||H y - e_1||_2 = min! res : float The final (preconditioned) residual norm NcS|SNr xr r _/var/www/edux/Edux_v2/venv/lib/python3.10/site-packages/scipy/sparse/linalg/_isolve/_gcrotmk.py@z_fgmres..cSr r r rr r rrBraxpydotscalnrm2)dtype)r)rrFrrignore)overdivideTFrordercol)which overwrite_qru check_finite)rr)rnpnanlenzerosronesfinfoepsrangecopy enumerateshapeerrstateisfiniteappendrabsrrconj)"matvecv0matollpsolverpsolvecsouter_vprepend_outer_vrrrrvszsyresBQRr, breakdownjzww_normicalphahcurvQ2R2_r r r_fgmress1           >rSh㈵>oldestc A Cs"t||||\}}} }}t|std| dvr"td| f| dur0tjdtdd|} |j}|j}| dur|=\}?}@||?||j d |>}||@||j d |>}q|;D] \}?}@||?|}5||?||j d |5 }||@||j d |5 }q'||}5|d|5|}|d|5|}|;||fq|;| dd<| |2|,fqe| d| f| rd d | D| dd<|| |#dfS)!a, Solve a matrix equation using flexible GCROT(m,k) algorithm. Parameters ---------- A : {sparse matrix, ndarray, LinearOperator} The real or complex N-by-N matrix of the linear system. Alternatively, ``A`` can be a linear operator which can produce ``Ax`` using, e.g., ``scipy.sparse.linalg.LinearOperator``. b : ndarray Right hand side of the linear system. Has shape (N,) or (N,1). x0 : ndarray Starting guess for the solution. tol, atol : float, optional Tolerances for convergence, ``norm(residual) <= max(tol*norm(b), atol)``. The default for ``atol`` is `tol`. .. warning:: The default value for `atol` will be changed in a future release. For future compatibility, specify `atol` explicitly. maxiter : int, optional Maximum number of iterations. Iteration will stop after maxiter steps even if the specified tolerance has not been achieved. M : {sparse matrix, ndarray, LinearOperator}, optional Preconditioner for A. The preconditioner should approximate the inverse of A. gcrotmk is a 'flexible' algorithm and the preconditioner can vary from iteration to iteration. Effective preconditioning dramatically improves the rate of convergence, which implies that fewer iterations are needed to reach a given error tolerance. callback : function, optional User-supplied function to call after each iteration. It is called as callback(xk), where xk is the current solution vector. m : int, optional Number of inner FGMRES iterations per each outer iteration. Default: 20 k : int, optional Number of vectors to carry between inner FGMRES iterations. According to [2]_, good values are around m. Default: m CU : list of tuples, optional List of tuples ``(c, u)`` which contain the columns of the matrices C and U in the GCROT(m,k) algorithm. For details, see [2]_. The list given and vectors contained in it are modified in-place. If not given, start from empty matrices. The ``c`` elements in the tuples can be ``None``, in which case the vectors are recomputed via ``c = A u`` on start and orthogonalized as described in [3]_. discard_C : bool, optional Discard the C-vectors at the end. Useful if recycling Krylov subspaces for different linear systems. truncate : {'oldest', 'smallest'}, optional Truncation scheme to use. Drop: oldest vectors, or vectors with smallest singular values using the scheme discussed in [1,2]. See [2]_ for detailed comparison. Default: 'oldest' Returns ------- x : ndarray The solution found. info : int Provides convergence information: * 0 : successful exit * >0 : convergence to tolerance not achieved, number of iterations Examples -------- >>> import numpy as np >>> from scipy.sparse import csc_matrix >>> from scipy.sparse.linalg import gcrotmk >>> R = np.random.randn(5, 5) >>> A = csc_matrix(R) >>> b = np.random.randn(5) >>> x, exit_code = gcrotmk(A, b) >>> print(exit_code) 0 >>> np.allclose(A.dot(x), b) True References ---------- .. [1] E. de Sturler, ''Truncation strategies for optimal Krylov subspace methods'', SIAM J. Numer. Anal. 36, 864 (1999). .. [2] J.E. Hicken and D.W. Zingg, ''A simplified and flexible variant of GCROT for solving nonsymmetric linear systems'', SIAM J. Sci. Comput. 32, 172 (2010). .. [3] M.L. Parks, E. de Sturler, G. Mackey, D.D. Johnson, S. Maiti, ''Recycling Krylov subspaces for sequences of linear systems'', SIAM J. Sci. Comput. 28, 1651 (2006). z$RHS must contain only finite numbers)rWsmallestz Invalid value for 'truncate': %rNzscipy.sparse.linalg.gcrotmk called without specifying `atol`. The default value will change in the future. To preserve current behavior, set ``atol=tol``.r)category stacklevel)NNNrrcSg|]\}}d|fqSr r .0rLur r r =zgcrotmk..cSs |dduS)Nrr )cur r rrBs zgcrotmk..)keyrr rTeconomic) overwrite_amodepivotingg-q=)rrg?rrrcSsg|]\}}|qSr r r\r r rr_s)r;r9r<rWrXcSr[r r )r]czuzr r rr_r`)!r r&r2all ValueErrorwarningswarnDeprecationWarningr6r.rsortemptyr0r(rpopr3rlistTr-r4zipmaxrSrrFloatingPointErrorZeroDivisionErrorrrr/)AAbx0tolmaxiterMcallbackr8kCU discard_Ctruncater9r postprocessr6psolverrrrrb_normCusrGrLr^rDrEPr<new_usrKycj_outerbetabeta_tolmlrCr?r@rApresuxrHbyrabychycxrOhycrMgammaDWsigmaVnew_CUrIcupwpcpupr r rr s`          ("       " "        &   "   )NNr r F) NrTrUNNrVNNFrWN)rknumpyr& numpy.linalgr scipy.linalgrrrrrr!scipy.sparse.linalg._isolve.utilsr __all__rSr r r r rs    )