max@0: // Copyright (C) 2009-2011 NICTA (www.nicta.com.au)
max@0: // Copyright (C) 2009-2011 Conrad Sanderson
max@0: // 
max@0: // This file is part of the Armadillo C++ library.
max@0: // It is provided without any warranty of fitness
max@0: // for any purpose. You can redistribute this file
max@0: // and/or modify it under the terms of the GNU
max@0: // Lesser General Public License (LGPL) as published
max@0: // by the Free Software Foundation, either version 3
max@0: // of the License or (at your option) any later version.
max@0: // (see http://www.opensource.org/licenses for more info)
max@0: 
max@0: 
max@0: //! \addtogroup fn_solve
max@0: //! @{
max@0: 
max@0: 
max@0: 
max@0: //! Solve a system of linear equations, i.e., A*X = B, where X is unknown.
max@0: //! For a square matrix A, this function is conceptually the same as X = inv(A)*B,
max@0: //! but is done more efficiently.
max@0: //! The number of rows in A and B must be the same.
max@0: //! B can be either a column vector or a matrix.
max@0: //! This function will also try to provide approximate solutions
max@0: //! to under-determined as well as over-determined systems (non-square A matrices).
max@0: 
max@0: template<typename T1, typename T2>
max@0: inline
max@0: const Glue<T1, T2, glue_solve>
max@0: solve
max@0:   (
max@0:   const Base<typename T1::elem_type,T1>& A,
max@0:   const Base<typename T1::elem_type,T2>& B,
max@0:   const bool slow = false,
max@0:   const typename arma_blas_type_only<typename T1::elem_type>::result* junk = 0
max@0:   )
max@0:   {
max@0:   arma_extra_debug_sigprint();
max@0:   arma_ignore(junk);
max@0:   
max@0:   return Glue<T1, T2, glue_solve>(A.get_ref(), B.get_ref(), ((slow == false) ? 0 : 1) );
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: template<typename T1, typename T2>
max@0: inline
max@0: const Glue<T1, T2, glue_solve_tr>
max@0: solve
max@0:   (
max@0:   const Op<T1, op_trimat>& A,
max@0:   const Base<typename T1::elem_type,T2>& B,
max@0:   const bool slow = false,
max@0:   const typename arma_blas_type_only<typename T1::elem_type>::result* junk = 0
max@0:   )
max@0:   {
max@0:   arma_extra_debug_sigprint();
max@0:   arma_ignore(slow);
max@0:   arma_ignore(junk);
max@0:   
max@0:   return Glue<T1, T2, glue_solve_tr>(A.m, B.get_ref(), A.aux_uword_a);
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: template<typename T1, typename T2>
max@0: inline
max@0: bool
max@0: solve
max@0:   (
max@0:          Mat<typename T1::elem_type>&    out,
max@0:   const Base<typename T1::elem_type,T1>& A,
max@0:   const Base<typename T1::elem_type,T2>& B,
max@0:   const bool slow = false,
max@0:   const typename arma_blas_type_only<typename T1::elem_type>::result* junk = 0
max@0:   )
max@0:   {
max@0:   arma_extra_debug_sigprint();
max@0:   arma_ignore(junk);
max@0:   
max@0:   try
max@0:     {
max@0:     out = solve( A.get_ref(), B.get_ref(), slow );
max@0:     }
max@0:   catch(std::runtime_error&)
max@0:     {
max@0:     return false;
max@0:     }
max@0:   
max@0:   return true;
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: //! @}