max@0: // Copyright (C) 2011-2012 NICTA (www.nicta.com.au)
max@0: // Copyright (C) 2011-2012 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_syl_lyap
max@0: //! @{
max@0: 
max@0: 
max@0: //! find the solution of the Sylvester equation AX + XB = C
max@0: template<typename T1, typename T2, typename T3>
max@0: inline
max@0: bool
max@0: syl
max@0:   (
max@0:         Mat <typename T1::elem_type>   & out,
max@0:   const Base<typename T1::elem_type,T1>& in_A,
max@0:   const Base<typename T1::elem_type,T2>& in_B,
max@0:   const Base<typename T1::elem_type,T3>& in_C,
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:   typedef typename T1::elem_type eT;
max@0:   
max@0:   const unwrap_check<T1> tmp_A(in_A.get_ref(), out);
max@0:   const unwrap_check<T2> tmp_B(in_B.get_ref(), out);
max@0:   const unwrap_check<T3> tmp_C(in_C.get_ref(), out);
max@0:   
max@0:   const Mat<eT>& A = tmp_A.M;
max@0:   const Mat<eT>& B = tmp_B.M;
max@0:   const Mat<eT>& C = tmp_C.M;
max@0:   
max@0:   const bool status = auxlib::syl(out, A, B, C);
max@0:   
max@0:   if(status == false)
max@0:     {
max@0:     out.reset();
max@0:     arma_bad("syl(): equation appears to be singular", false);
max@0:     }
max@0:   
max@0:   return status;
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: template<typename T1, typename T2, typename T3>
max@0: inline
max@0: Mat<typename T1::elem_type>
max@0: syl
max@0:   (
max@0:   const Base<typename T1::elem_type,T1>& in_A,
max@0:   const Base<typename T1::elem_type,T2>& in_B,
max@0:   const Base<typename T1::elem_type,T3>& in_C,
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:   typedef typename T1::elem_type eT;
max@0:   
max@0:   const unwrap<T1> tmp_A( in_A.get_ref() );
max@0:   const unwrap<T2> tmp_B( in_B.get_ref() );
max@0:   const unwrap<T3> tmp_C( in_C.get_ref() );
max@0:   
max@0:   const Mat<eT>& A = tmp_A.M;
max@0:   const Mat<eT>& B = tmp_B.M;
max@0:   const Mat<eT>& C = tmp_C.M;
max@0:   
max@0:   Mat<eT> out;
max@0:   
max@0:   const bool status = auxlib::syl(out, A, B, C);
max@0:   
max@0:   if(status == false)
max@0:     {
max@0:     out.reset();
max@0:     arma_bad("syl(): equation appears to be singular");
max@0:     }
max@0:   
max@0:   return out;
max@0:   }
max@0: 
max@0: 
max@0: 
max@0: //! @}